Skip to content

feat: adding token vault with xaa page - #1728

Open
d4nt wants to merge 7 commits into
auth0:mainfrom
d4nt:fgi-2436-token-vault-xaa-docs
Open

feat: adding token vault with xaa page#1728
d4nt wants to merge 7 commits into
auth0:mainfrom
d4nt:fgi-2436-token-vault-xaa-docs

Conversation

@d4nt

@d4nt d4nt commented Aug 14, 2026

Copy link
Copy Markdown
Contributor

Description

This PR adds a new guide to the Token Vault section "Configuring Token Vault with XAA". It walks the customer through setting up Token Vault to use the XAA Requesting App flow to request access tokens from Resource App APIs.

References

https://auth0team.atlassian.net/browse/FGI-2436

Testing

Checklist

  • I've read and followed CONTRIBUTING.md.
  • I've tested the site build for this change locally.
  • I've made appropriate docs updates for any code or config changes.
  • I've coordinated with the Product Docs and/or Docs Management team about non-trivial changes.

@d4nt
d4nt marked this pull request as ready for review August 19, 2026 07:40
@d4nt
d4nt requested a review from a team as a code owner August 19, 2026 07:40
@lrzhou25 lrzhou25 self-assigned this Aug 19, 2026
Comment on lines +83 to +101
{
"cross_app_access_requesting_app": { "active": true },
"options": {
"scope": "openid profile email offline_access"
},
"type": "back_channel",
"attribute_map": {
"attributes": {
"name": "${context.tokenset.name}",
"email": "${context.tokenset.email}",
"username": "${context.tokenset.preferred_username}",
"federated_groups": "${context.userinfo.groups}",
"federated_locale": "${context.userinfo.locale}",
"federated_zoneinfo": "${context.userinfo.zoneinfo}"
},
"mapping_mode": "use_map",
"userinfo_scope": "openid email profile groups offline_access"
}
}

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think this request is not totally correct, the body should be something like that:

{
    "cross_app_access_requesting_app": {
        "active": true
    },
    "options": {
        "scope": "openid profile email offline_access",
        "type": "back_channel",
        "client_secret": "...",
        "client_id": "...",
        "attribute_map": {
            "mapping_mode": "use_map",
            "userinfo_scope": "openid email profile groups offline_access",
            "attributes": {
                "name": "${context.tokenset.name}",
                "email": "${context.tokenset.email}",
                "username": "${context.tokenset.preferred_username}",
                "federated_groups": "${context.userinfo.groups}",
                "federated_locale": "${context.userinfo.locale}",
                "federated_zoneinfo": "${context.userinfo.zoneinfo}"
            }
        }
    }
}

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Addressed in bcc7941


Both Okta and OIDC connection types can be configured to act as XAA Requesting Applications. To
enable, open the Connection details in the management dashboard, scroll down to the Cross App
Access section and turn on the *Requesting Application* toggle.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think 1.c and 1.a should be switched between each other, because the "requesting application" toggle is disabled when communication channel is "front channel"

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Addressed in bcc7941

for details).
3. The third-party API being accessed must support XAA as a "Resource App", meaning it can exchange
an `ID-JAG` for access tokens. Third-party applications that are also using Auth0 can enable this
feature; read [Cross App Access (XAA)](/docs/secure/call-apis-on-users-behalf/xaa) for details.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
feature; read [Cross App Access (XAA)](/docs/secure/call-apis-on-users-behalf/xaa) for details.
feature; read [Cross App Access (XAA)](/docs/ai-agents-mcp/cross-app-access) for details.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Addressed in bcc7941

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants