Troubleshoot Policy

Choose a safe recovery path using symptoms, available evidence, and your authority.

Start with the failed task, not a service restart. Policy tracks draft work, governed revisions, and protection progress separately. A healthy service does not prove that a policy protects its targets.

Choose Your Next Task

Use this table to choose the troubleshooting guide that matches the symptom:

SymptomNext Task
Cannot save, submit, request changes, or approveFollow authoring and review troubleshooting.
Approval succeeded, but publication or withdrawal stoppedFollow publication and withdrawal recovery.
Publication reports a missing or conflicting native identityFollow policy ownership reconciliation.
Need to remove saved ownership mappings across policiesFollow verified-stale binding cleanup.
Approved output does not reflect changed source informationFollow automatic recompilation troubleshooting.
Cannot reach Policy, authenticate, or start workloadsFollow installation, identity, and routing troubleshooting.
Identity provider (IdP) connection data remains empty after installing Policy later than TraverseCheck known issues and workarounds.
Need to identify an error or prepare a support handoffUse common errors and diagnostics.

Before Changing Anything

Complete the following steps:

  1. Retain the policy identifier, failed action, timestamp, and returned message. Include the time zone and any support reference.
  2. Read the policy’s current state through your permitted interface. Record draft status separately from governance and protection states.
  3. Confirm who can perform the next task. Authors, reviewers, approvers, auditors, and system operators have different authority.
  4. Open the matching playbook above. Each playbook defines its evidence, stop conditions, and success checks.

Do not share credentials or invent another user’s audit identity. Owner or editor access does not grant every command capability. Refer to roles and permissions.

When You Cannot Inspect the Evidence

An ordinary author might lack access to restricted diagnostics or operations. Retain the visible error and ask an authorized operator to investigate. A support reference does not grant diagnostic access. Policy does not provide universal self-service recovery for audit-only evidence. Use the glossary to distinguish authentication tokens, version validators, and delivery evidence.

Use the diagnostic handoff when the next action requires authority you do not have. Keep the recovery directory for links to earlier recovery topics.


Troubleshoot Authoring and Review

Recover draft and review work using current content, correct permissions, and resource-specific validators.

Known Issues and Workarounds

Identify reported Policy installation limitations, their workarounds, and the evidence required before declaring recovery.

Recover Publication and Withdrawal

Find a failed publication or removal request, identify who can resolve its error, and retry only after checking the cause.

Reconcile a Policy's Native Ownership

Resolve a missing or conflicting PIM object mapping using the identifiers and actions returned by the reconciliation API.

Remove Verified-Stale Ownership Mappings

Enumerate saved bindings and forget only mappings that complete live inventory and current Policy evidence prove safe to remove.

Troubleshoot Automatic Recompilation

Distinguish unchanged output, failed refreshes, blocked cycles, and deferred publication without inventing a manual recompilation trigger.

Common Policy Errors

Identify the right evidence and recovery task for common Policy failures.

Collect Policy Diagnostics

Collect accessible evidence and prepare a safe handoff without assuming cluster or administrator access.

Recover Policy Safely

Find the canonical recovery task without confusing deployment retry, ownership repair, and platform recovery.

Troubleshoot Installation, Identity, and Routing

Isolate platform startup, access, and route failures without weakening authentication or assuming a safe database rollback.

Last modified : November 03, 2026