Troubleshooting

Identity not recognized

Symptom: Mount fails with "identity not found" or "unauthorized"

Check that:

1. The TLS certificate CN exactly matches the Certificate CN shown in Access → Users (or Machines)
2. The identity status is ACTIVE — check the status badge on the identity detail page in the Dashboard
3. The certificate has not expired

AccessPolicy not taking effect

Symptom: User can authenticate but gets "access denied" on data operations

Check:

1. Navigate to Access → Policies and find the relevant policy
2. Verify the Scope, VolumeGroup, and Volume fields match the target resource exactly
3. Verify the required permissions (read, write) are listed
4. Check that the policy status shows SYNCED — if it shows SYNCING for more than a few minutes, contact MangoBoost support through Dashboard → System → Support

Identity stuck in PENDING_APPROVAL

An identity_manager or super_admin must approve the identity.

Navigate to Access → Users → (select user) → Approve.

The approval workflow depends on your organization's configured auth source.

Certificate expired

Navigate to Access → Users → (select user) → Renew Certificate, or contact your identity_manager. Alternatively, delete the old identity and create a new one with an updated Certificate CN.