Skip to content

docs: document SSO enforcement and allowed auth methods#6219

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

docs: document SSO enforcement and allowed auth methods#6219
mintlify[bot] wants to merge 3 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 runtime or auth logic modified in this repo.

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 turn on Require SSO, the requirement for an active default SSO connection before enforcement, and how to configure allowed authentication methods (SSO, password, magic link, Google OAuth), including empty-list and SSO-only list behavior.

It also documents SSO step-up when a member on a non-SSO session switches into an SSO-enforced org, and break-glass access for emergency password/magic-link sign-in, with setup steps and a security warning.

Reviewed by Cursor Bugbot for commit 1858233. 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