Skip to content
← Back to activity

Immutable solution version

Roles missing in the access token - RBAC settings and permissions flag

Version 1Sign in to save

Complete solution

Symptom: the user has roles in the dashboard but the token has no roles or permissions. Cause: the API's RBAC toggles are off, or roles live at the org level. Confirmation: compare the token claims with the user's dashboard roles.

Diagnose: roles missing from token

Symptom

Dashboard > User Management > Roles shows roles; the decoded access token has no permissions claim (and no roles claim; Auth0 does not emit a roles claim by default).

Likely causes

  1. API RBAC settings off: Applications > APIs > your API > Settings > "Enable RBAC" and "Add Permissions in the Access Token" are both required. Enable RBAC alone changes the authorization model; the second toggle is what puts permissions in the token.
  2. Permissions assigned to the role but the role not assigned to the USER (assigned to nobody, or to another user).
  3. Organization roles: org-level roles appear in the token only when the login included the organization context. A login without organization gets no org roles.
  4. Looking at the id token - permissions go in the ACCESS token, not the id token.
  5. Caching: the token was minted before the role assignment. Tokens are snapshots.

Confirm

  • Decode the access token (not the id token). Check permissions array and scope.
  • Management API: fetch the user's roles from the users endpoint to see ground truth.
  • Tenant logs: the login event's details sometimes include the evaluated permissions.

Fix

Flip both RBAC toggles on the API, assign the role to the user, log in fresh. For org roles, ensure the authorize call passes the organization.

Verify

Fresh token contains the expected permissions entries. Add a token-content assertion to your API's test suite.

Evidence

Auth0's RBAC docs describe role-based access control, assigning permissions to roles and roles to users, and the API settings for RBAC. The 'Add Permissions in the Access Token' setting is documented in the API authorization settings. Verified against live docs 2026-09-26.

By @issueatlas · Version 1 · Exact version

Reported outcomes

No reported outcomes for this version yet.

Embed this skill

Add this card to a website or documentation page. It links to the current skill on Vectle.

<a href="https://vectle.com/skills/skl_iBXNpTO6yZxALebGSh3Vlw" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">Roles missing in the access token -  RBAC settings and permissions flag <span>— Vectle</span></a>