Skip to content

Clarify how SSO, IdP Managed Access, and SCIM fit together - #421

Open
claude[bot] wants to merge 9 commits into
mainfrom
claude/sso-setup-overview
Open

claude[bot] wants to merge 9 commits into
mainfrom
claude/sso-setup-overview

Conversation

@claude

@claude claude Bot commented Nov 13, 2026

Copy link
Copy Markdown
Contributor

Requested by Kurby Chua · Slack thread

Before: The SSO page described SSO, IdP Managed Access, just-in-time provisioning, and SCIM as separate settings without explaining how they relate, and its sections didn't follow the order you set things up in. It didn't say that subdomains need to be claimed separately. The Okta and Azure pages said to give an IdP group the same name as a Mixpanel Team and to set the Organization Role on the Team, which doesn't match how group push works. A few provider notes were out of date (G-Suite naming, OneLogin, JumpCloud links).

After: The SSO page opens with what each piece does and a table comparing SSO only, SSO + IdP Managed Access, and SSO + IdP Managed Access + SCIM, followed by a numbered setup checklist that the rest of the page now follows. It explains that subdomains are matched exactly and must be claimed on their own, adds a step for entering the IdP's certificate and URLs in Mixpanel, explains how SCIM links or creates Teams from IdP groups (and that deleting a group deletes the Team), and adds a short Troubleshooting section. The Okta and Azure pages describe the same group-to-Team behavior. All existing anchors that other pages link to still work.

How: Edited docs/access-security/single-sign-on.mdx (restructure and new sections), single-sign-on/okta.mdx and single-sign-on/azure.mdx (Teams behavior, Push Groups, delete warning, typo and copy-paste fixes), single-sign-on/jumpcloud.mdx (link the general setup page), single-sign-on/google.mdx (current tab name), and login-methods.mdx (SSO summary). Frontmatter and link checks in scripts/ pass.


Generated by Claude Code

- Add an overview and comparison table of SSO, IdP Managed Access, SCIM,
  and Teams, plus a numbered setup checklist, and reorder the SSO page to
  follow it
- Document that subdomains must be claimed separately
- Explain how SCIM maps IdP groups to Teams (create-or-link, and that
  deleting a group deletes the Team) on the SSO, Okta, and Azure pages
- Add an "Enter Your IdP Details in Mixpanel" step and a Troubleshooting
  section
- Fix OneLogin, Google Workspace, and JumpCloud guidance, and small typos

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@mintlify

mintlify Bot commented Nov 13, 2026 •

Copy link
Copy Markdown
Contributor

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

Project Status Preview Updated
mixpanel-docs 🟢 Ready View Preview Nov 13, 2026, 5:49 AM

@greptile-apps

greptile-apps Bot commented Nov 13, 2026 •

Copy link
Copy Markdown
Contributor

RetriggerView in GreptileConfidence Score: 5/5

[Low impact] This documentation update appears safe to merge.

Reviews (7) · Last reviewed commit: "Merge branch 'main' into claude/sso-setu..." · Reviewed by Greptile

Comment thread docs/access-security/single-sign-on.mdx Resolved
Comment thread docs/access-security/single-sign-on.mdx Resolved
…ds on IdP settings

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
… in SSO doc

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- Single Sign-On: update the SSO/IdP Managed Access/SCIM comparison table,
  note that Shared SSO manages these settings in the Admin Organization,
  drop "beta" from the Shared SSO reference, and convert setup steps,
  IdP provider list, and troubleshooting to Steps, CardGroup, and
  AccordionGroup.
- Shared SSO: align SCIM-to-Teams wording with the main SSO page, merge
  the two Azure warnings, remove a duplicate Team membership paragraph,
  use "IdP" consistently, link to the SSO setup steps, and convert the
  migration list to Steps.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Document that just-in-time provisioning can't be turned on in an Admin
Organization or its linked organizations, so users must be provisioned
with SCIM or invited from Mixpanel.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Use a numbered list for Setup Steps and the Shared SSO migration steps,
replace the IdP CardGroup with a comparison table, add a OneLogin
subsection, and restore the Microsoft provisioning tutorial link.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@kurbycchua
kurbycchua marked this pull request as ready for review November 13, 2026 05:53
@kurbycchua
kurbycchua requested a review from a team as a code owner November 13, 2026 05:53
@kurbycchua
kurbycchua enabled auto-merge (squash) November 13, 2026 05:53

This branch was successfully deployed

1 active deployment
staging — c24bc300 Deployed Nov 13, 2026 by mintlify[bot]
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.

2 participants