Skip to content

feat: add Requesting App to XAA docs#1465

Open
lrzhou25 wants to merge 18 commits into
mainfrom
feat/xaa_requesting_app
Open

feat: add Requesting App to XAA docs#1465
lrzhou25 wants to merge 18 commits into
mainfrom
feat/xaa_requesting_app

Conversation

@lrzhou25

Copy link
Copy Markdown
Contributor

Description

References

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.

@lrzhou25
lrzhou25 requested a review from a team as a code owner June 26, 2026 20:01
@lrzhou25 lrzhou25 added main-docs Changes related to auth0's main docs (https://auth0.com/docs) DO NOT MERGE Only the PR author should merge, even if approved. labels Jun 26, 2026
@github-actions

github-actions Bot commented Jun 26, 2026

Copy link
Copy Markdown
Contributor

Summary

Status Count
🔍 Total 29
✅ Successful 10
⏳ Timeouts 0
🔀 Redirected 0
👻 Excluded 18
❓ Unknown 0
🚫 Errors 1
⛔ Unsupported 0

Errors per input

Errors in main/docs/secure/call-apis-on-users-behalf/xaa/idp/okta-as-oidc-idp.mdx

@lrzhou25
lrzhou25 force-pushed the feat/xaa_requesting_app branch from f9bc906 to af0477b Compare July 8, 2026 19:10
Comment thread main/docs/secure/call-apis-on-users-behalf/xaa/end-to-end-testing.mdx Outdated
&connection=<YOUR_OKTA_WORKFORCE_CONNECTION_NAME>
```

When the login completes, Auth0 returns an authorization code to your callback URL. Exchange it for tokens at the Auth0 `/token` endpoint. Auth0 returns an access token, ID token, and refresh token issued by your Auth0 tenant. The Okta tokens are stored internally in Token Vault.

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.

Is it worth adding an example of the request to get the refresh token here?

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.

would you happen to have one?

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've updated this in afbfb07

Comment thread main/docs/secure/call-apis-on-users-behalf/xaa/end-to-end-testing.mdx Outdated
Comment thread main/docs/secure/call-apis-on-users-behalf/xaa/end-to-end-testing.mdx Outdated

Use this approach to test the raw XAA protocol steps, or if you have not configured Token Vault.

### Log in to the Requesting App

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.

This section reads as though we should be requesting an id token from auth0, but actually we need to complete the login flow for the okta tenant. Could that be more clear? Maybe that's not the case, it's just the impression I get when reading it

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.

Comment thread main/docs/secure/call-apis-on-users-behalf/xaa/idp/okta-as-oidc-idp.mdx Outdated
You also need access to a Resource App Auth0 tenant. To set one up, read [Set Up Resource App](/docs/secure/call-apis-on-users-behalf/xaa/idp/okta-as-oidc-idp). From the Resource App tenant, you need:

- The Resource App tenant's issuer URL. For example, `https://<RESOURCE_APP_TENANT>.auth0.com/`
- A Client ID and Client Secret for the Requesting App registered in the Resource App tenant

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.

The wording here is a bit confusing, is it correct where we say "Requesting App registered in the Resource App tenant"?

@@ -0,0 +1,168 @@
---

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 find it a bit odd that we have a section for idp integration, and this document is placed in a "idp agnostic" place but it's very Okta specific. Is it worth moving it somewhere else?

2. Under Sign On, select Edit and add your **Auth0 Tenant’s callback URL** in the **Redirect URI** field.
3. Select Save.

<Frame>![](/docs/images/xaa/xaa_okta_resource_app_details.png)</Frame>

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.

Are these docs using a single tenant in auth0 for the requesting and resource apps? I'm asking because the new page set-up-requesting-app.mdx seems to reference 2 tenants, in this page I can see the same tenant being used for both in the pictures

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.

Comment thread main/docs/secure/call-apis-on-users-behalf/xaa/set-up-requesting-app.mdx Outdated
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

DO NOT MERGE Only the PR author should merge, even if approved. main-docs Changes related to auth0's main docs (https://auth0.com/docs)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants