Skip to content

Comments

docs: update Native to Web SSO documentation#660

Merged
BcnCarlos merged 2 commits intoauth0:mainfrom
nelsonmaia:fix/native-to-web-sso-android-sdk-docs
Feb 23, 2026
Merged

docs: update Native to Web SSO documentation#660
BcnCarlos merged 2 commits intoauth0:mainfrom
nelsonmaia:fix/native-to-web-sso-android-sdk-docs

Conversation

@nelsonmaia
Copy link
Contributor

@nelsonmaia nelsonmaia commented Feb 22, 2026

Description

This PR updates the Native to Web SSO documentation with several fixes and enhancements:

Android SDK Code Samples Fix

The Android SDK code samples were using an incorrect API (AuthenticationAPIClient.ssoExchange()). Updated to use the correct
SecureCredentialsManager.getSsoCredentials() method that matches the actual SDK implementation.

React Native SDK Support

  • Added React Native SDK to the list of supported SDKs for Native to Web SSO
  • Added new code examples showing both the Hooks approach (useAuth0) and the class-based approach (Auth0 class)

Organizations Support

Added new section documenting how to use Organizations with Native to Web SSO, including:

  • Organization context in session transfer tokens
  • Requirement that the organization parameter in /authorize must match the token's organization
  • Code examples for native login and web redirect with organizations

Parent Refresh Token Metadata Access

Added documentation for the new feature that allows Actions to access metadata from the parent refresh token during Native to Web
SSO flows. This enables passing contextual information (device integrity, risk signals, custom context) from the native app to the
web session.

Monitoring Section Improvements

Expanded the monitoring section with a comprehensive table of warning log events (w) that are emitted when session transfer token
validation fails, helping developers troubleshoot Native to Web SSO issues.

Web SDK Examples

Added examples for web applications receiving the session transfer token:

  • Auth0 SPA SDK (@auth0/auth0-spa-js): Example using loginWithRedirect() with authorizationParams
  • Auth0 React SDK (@auth0/auth0-react): Example using the useAuth0 hook with proper loading/authentication guards
  • Node (Express.js) fix: Fixed config state leakage bug where session_transfer_token from one request could leak to
    subsequent requests

Typo Fix

Fixed typo "SSSO" → "SSO" in native-to-web-sso-and-sessions.mdx

References

  • Related to Native to Web SSO Early Access feature documentation

Testing

  • Preview locally using mintlify dev in the main directory
  • Verify the following pages render correctly:
    • /docs/authenticate/single-sign-on/native-to-web/configure-implement-native-to-web
    • /docs/authenticate/single-sign-on/native-to-web/configure-mobile-to-web-payment-flows
    • /docs/authenticate/single-sign-on/native-to-web/native-to-web-sso-and-sessions

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.

- Fix Android SDK code samples to use correct SecureCredentialsManager API
- Add React Native SDK examples and support
- Add Organizations support section
- Add parent refresh token metadata access documentation for Actions
- Expand monitoring section with warning log events
- Fix typo in native-to-web-sso-and-sessions.mdx

Co-Authored-By: Claude <noreply@anthropic.com>
@nelsonmaia nelsonmaia requested a review from a team as a code owner February 22, 2026 21:41
- Add @auth0/auth0-spa-js example using loginWithRedirect with authorizationParams
- Add @auth0/auth0-react example using useAuth0 hook
- Fix Node (Express.js) example to avoid config state leakage between requests

Co-Authored-By: Claude <noreply@anthropic.com>
@BcnCarlos BcnCarlos added the documentation Improvements or additions to documentation label Feb 23, 2026
@BcnCarlos BcnCarlos merged commit 3b7f2ee into auth0:main Feb 23, 2026
1 of 2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants