Skip to content

docs: document SSO enforcement and allowed auth methods#6219

Open
mintlify[bot] wants to merge 2 commits into
mainfrom
mintlify/1e2bd4e3
Open

docs: document SSO enforcement and allowed auth methods#6219
mintlify[bot] wants to merge 2 commits into
mainfrom
mintlify/1e2bd4e3

Conversation

@mintlify

@mintlify mintlify Bot commented Jun 18, 2026

Copy link
Copy Markdown
Contributor

Summary

Add a new "Require SSO" section to the dashboard SSO docs explaining how Enterprise admins can enforce SSO-only sign-in and restrict allowed authentication methods.

Changes

  • Add a "Require SSO" section after JIT provisioning to dashboard/sso.mdx covering: toggling Require SSO from the SSO settings page, choosing allowed auth methods (SSO, password, magic link, Google OAuth), the default-connection requirement, and the SSO step-up behavior when non-SSO users switch into an enforced org.
  • Mirror the new section in zh/dashboard/sso.mdx and fr/dashboard/sso.mdx.

Context

Source PRs:

  • mintlify/mint#8459 — adds the Require SSO toggle and allowed-auth-methods UI to the SSO settings modal.
  • mintlify/server#5983 — enforces SSO across magic-link, password, password-reset, callback, and active-session exchange paths, surfaces an SSO step-up on org switch, and rejects enforcement attempts when no default SSO connection is configured.

Note

Low Risk
Documentation-only changes with no application or auth logic modified.

Overview
Adds a Require SSO section to the dashboard SSO docs (English plus es, fr, and zh locales), placed after JIT provisioning and before SAML group RBAC mapping.

The new content explains how Enterprise admins can turn on Require SSO from the SSO settings page (with an active default SSO connection required to avoid lockout), optionally pick allowed sign-in methods (SSO, password, magic link, Google OAuth) including empty-list and SSO-only save rules, and what happens when a multi-org member on a non-SSO session switches into an SSO-enforced organization (SSO step-up via the IdP).

Reviewed by Cursor Bugbot for commit 316ee9c. Bugbot is set up for automated code reviews on this repo. Configure here.

@mintlify-development

mintlify-development Bot commented Jun 18, 2026

Copy link
Copy Markdown
Contributor

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

Project Status Preview Updated (UTC)
userauth 🟢 Ready View Preview Jun 18, 2026, 3:15 PM

@mintlify-development

mintlify-development Bot commented Jun 18, 2026

Copy link
Copy Markdown
Contributor

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

Project Status Preview Updated (UTC)
prosignuptest 🟢 Ready View Preview Jun 18, 2026, 4:39 PM

@mintlify-development

mintlify-development Bot commented Jun 18, 2026

Copy link
Copy Markdown
Contributor

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

Project Status Preview Updated (UTC)
mintlify 🟢 Ready View Preview Jun 18, 2026, 4:26 PM

@mintlify mintlify Bot requested a review from ehcaw June 18, 2026 15:12
@mintlify

mintlify Bot commented Jun 18, 2026

Copy link
Copy Markdown
Contributor Author

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

Project Status Preview Updated (UTC)
mintlify 🟡 Building Jun 18, 2026, 3:11 PM

@mintlify

mintlify Bot commented Jun 18, 2026

Copy link
Copy Markdown
Contributor Author

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

Project Status Preview Updated (UTC)
smartac 🟢 Ready View Preview Jun 18, 2026, 3:18 PM

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

@mintlify

mintlify Bot commented Jun 18, 2026

Copy link
Copy Markdown
Contributor Author

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

Project Status Preview Updated (UTC)
adminroletesting 🟢 Ready View Preview Jun 18, 2026, 3:20 PM

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

@mintlify

mintlify Bot commented Jun 18, 2026

Copy link
Copy Markdown
Contributor Author

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

Project Status Preview Updated (UTC)
hfh-d7a4d643 🟢 Ready View Preview Jun 18, 2026, 3:22 PM

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

@mintlify

mintlify Bot commented Jun 18, 2026

Copy link
Copy Markdown
Contributor Author

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

Project Status Preview Updated (UTC)
gwgwgw 🟢 Ready View Preview Jun 18, 2026, 3:25 PM

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

@mintlify

mintlify Bot commented Jun 18, 2026

Copy link
Copy Markdown
Contributor Author

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

Project Status Preview Updated (UTC)
tomee 🟢 Ready View Preview Jun 18, 2026, 3:26 PM

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

@mintlify

mintlify Bot commented Jun 18, 2026

Copy link
Copy Markdown
Contributor Author

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

Project Status Preview Updated (UTC)
testsignup415 🟢 Ready View Preview Jun 18, 2026, 3:32 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