Skip to content

Add SAML SSO docs for enterprise teamspaces - #2969

Open
fahreddinozcan wants to merge 1 commit into
masterfrom
docs-enterprise-saml-sso
Open

Add SAML SSO docs for enterprise teamspaces#2969
fahreddinozcan wants to merge 1 commit into
masterfrom
docs-enterprise-saml-sso

Conversation

@fahreddinozcan

Copy link
Copy Markdown
Collaborator

Documents the self-serve SAML SSO flow for cloud enterprise teamspaces. Pairs with upstash/context7app#831.

  • New page at enterprise/sso, added to the Enterprise nav group above Enterprise-Managed Auth.
  • Walks the full setup: verify domain by DNS TXT, create the SAML app in the customer's IdP, supply IdP details by metadata URL or manually, test, activate.
  • Five screenshots captured from the dashboard at 1920x1200, light mode to match existing enterprise docs.
  • Troubleshooting covers the two failures that actually occur in practice: domain mismatch on the assertion, and a metadata fetch that was pointed at the sign-on endpoint instead of the descriptor.

Scope note: this is Cloud only. On-premise SSO stays in enterprise/security/entra-sso and oidc-sso.

One thing to confirm before merge: the page tells customers to contact support if the Security tab is missing, because self-serve SSO is enabled per organization from the Clerk dashboard and is not exposed on the Backend API. If that changes, this section should be reworded.

Covers the self-serve flow in the cloud dashboard: verifying a domain by
DNS, creating the SAML app in the customer's IdP, supplying IdP details by
metadata or manually, testing, and activating.

Screenshots captured from the dashboard at 1920x1200.
@mintlify

mintlify Bot commented Jul 31, 2026

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
context7 🟢 Ready View Preview Jul 31, 2026, 1:41 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

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