Skip to content

feat: add Enterprise Connect support - #1227

Draft
gyaneshgouraw-okta wants to merge 3 commits into
mainfrom
enterprise-connect
Draft

feat: add Enterprise Connect support#1227
gyaneshgouraw-okta wants to merge 3 commits into
mainfrom
enterprise-connect

Conversation

@gyaneshgouraw-okta

Copy link
Copy Markdown
Contributor

Summary

Adds Enterprise Connect support to auth0-react through a new useEnterpriseConnect hook for enterprise domain discovery and SSO login.

B2B SaaS applications can use it to detect whether a user’s email domain is configured for enterprise SSO, then initiate login with the email as login_hint. Auth0’s Home Realm Discovery uses it to resolve the appropriate enterprise connection and organization.

Changes

  • Add useEnterpriseConnect with isFederatedDomain for domain discovery and loginWithSSO for SSO login with login_hint.
  • Use the Auth0 domain configured in Auth0Provider for discovery.
  • Add unit tests for domain discovery and SSO login behavior.
  • Document the Enterprise Connect login, callback, and federated logout flow in EXAMPLES.md.

Example

import { useEnterpriseConnect } from '@auth0/auth0-react';
const { isFederatedDomain, loginWithSSO } = useEnterpriseConnect();

const emailDomain = email.split('@')[1];
if (await isFederatedDomain(emailDomain)) {
  await loginWithSSO(email, { appState: { returnTo: '/dashboard' } });
}

Federated logout (required to end the enterprise IdP session):

await logout({ logoutParams: { federated: true, returnTo: window.location.origin } });

Testing

  • npm test: 171 tests pass, 100% coverage including use-enterprise-connect.tsx.
  • npm run build: hook bundles cleanly; no augment or internal types leak into dist/.
  • Manually tested the flow using an example app with e2e setup

gyaneshgouraw-okta and others added 3 commits September 3, 2026 01:04
Adds useEnterpriseConnect hook wrapping isFederatedDomain (WebFinger
domain discovery) and loginWithRedirect (with login_hint set). Exports
UseEnterpriseConnect type from the package root. Adds module augmentation
for the unreleased isFederatedDomain export in @auth0/auth0-spa-js.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Move auth0-spa-js-augment.d.ts from src/ to type-augments/ so it is
never swept into dist/ declaration emit. Wire it via tsconfig "files"
so tsc picks it up for type-checking without emitting it. Fix telemetry
type to match the real TelemetryConfig discriminated union (remove env
field, use enabled/name/version union). Add removal-trigger reference.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@coderabbitai

coderabbitai Bot commented Sep 2, 2026

Copy link
Copy Markdown
Contributor

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

  • Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
  auto_review:
    drafts: true

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

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.

1 participant