Shared SSO: Use the same SSO setting for multiple Mixpanel organizations

Overview

If you have multiple Mixpanel Organizations with separate billing accounts, but need to share SSO settings and email domains for login, you can share those settings with an "Admin" Organization.

With a shared SSO setup, Single Sign-On settings and Claimed Domains are administered via this "Admin" Organization, and Organizations can be linked to the "Admin" Organization in order to utilize those settings. Administrators need administrative privileges in the Admin Organization to make changes to the shared SSO and Domain settings.

This feature is available to customers on an Enterprise Plan.

Admin Organizations

An Admin Organization is a special type of Organization that contains Single Sign-On settings and Claimed Domains. It can have Organization Members, but you should only add administrative users to the Admin Organization to manage security. The SCIM process will add Users as Organization Members.

An "Admin" Organization is different from a regular Organization in that it will not have Projects, Teams, a Plan or Billing, or Service Accounts. Other than administrators (those with Admin or Owner roles), any Organization Members will not see the Admin Organization or interact with it directly.

An Admin Organization can have multiple Linked Organizations which will share SSO settings. A regular Organization can only be linked to one Admin Organization.

How It Works

Any Organization linked to an Admin Organization will use the Single Sign-On settings from that Admin Organization - any Single Sign-On settings or Claimed Domains the Linked Organization may have had are now ignored.

SSO settings and Claimed Domains are managed in the Admin Organization. Administrative users who manage SSO settings in the Admin Organization do not need to be members of the Linked Organization(s), and vice-versa.

This configuration supports SCIM.

Differences From Single-Organization SSO

• In single-Organization SSO, SSO is configured in each Organization. In Shared SSO, SSO is configured in the "Admin" Organization, and shared by any Linked Organizations.

• In single-Organization SSO, claimed domains belong to each Organization. In Shared SSO, claimed domains belong to the Admin Organization and are shared by any Linked Organizations.

• In single-Organization SSO, SCIM groups in the IDP map to Teams in Mixpanel, with the IDP group name matching the Mixpanel Team name. In Shared SSO, SCIM groups in the IDP map to Linked Organizations, with the IDP group name matching the Linked Organization's SCIM Name.

* With Shared SSO, SCIM cannot manage Mixpanel Team membership. Team membership will need to be managed manually.

Setting Up Shared SSO

1. Create an Admin Organization in Mixpanel

For an existing Organization in Mixpanel, go to Organization Settings > Access Security > Shared SSO.

The new Admin Organization will be listed in the left nav in Organization Settings.

2. Set up SSO for the Admin Organization

Follow the steps to set up SSO in the Admin Organization as you would for a regular Organization. SSO documentation.

3. Link any Organizations to the Admin Organization in Mixpanel

Start by generating a linking code in the new Admin Organization. In the "Linked Organizations" section, click "Link Organization", then copy the generated linking code.

Then complete the linking by entering the linking code in the Organization to be linked.

The Organizations are now linked. The Linked Organization will now follow the SSO settings and claimed domains from the Admin Org.

4. (Optional) Transfer Existing Domains

Once your organizations are linked, you can then transfer any domains you might have claimed from the Linked Organization to the Admin Organization. Go to domain claiming on the Linked Organization and click the “Transfer domain” button for all the domains you want to transfer.

5. (Optional) Set up SCIM

The configurable "SCIM Name" for the Linked Organization must match a group in your IDP. Members of the matching group will be added to the Linked Organization.

SCIM With Shared SSO

Mixpanel supports using SCIM to administer users while using Shared SSO. With single-Organization SSO, the SCIM process would push users into the Mixpanel Organization, it would create Mixpanel Teams with the names of Groups in the IDP, and it would assign Mixpanel Users to those Teams.

With Shared SSO, the SCIM process works a little differently. Users are pushed to the Admin Organization. Groups in the IDP are pushed to Organizations Linked to the Admin Organization. Groups are mapped by matching an editable “SCIM Name” field in an Organization to the name of the Group in the IDP. Users that are members of the IDP Group are assigned to the linked Organization whos SCIM Name matches the name of the Group.

With Shared SSO, SCIM cannot manage Mixpanel Team membership. Team membership will need to be managed manually.

Migrating To Shared SSO

If you have Single Sign-On configured for an Organization, and want to use the same email domains with a Shared SSO; you will need to follow these steps to migrate and minimize the time Single Sign-On is unavailable for your users.

Be sure to follow these steps in this order, or there will be more downtime for Single Sign-On.

1. In Mixpanel, Create an Admin Organization
2. In Mixpanel, Set up SSO for the Admin Organization and configure an application in your IDP with the corresponding settings. You can refer to the Single Sign-on Overview section in our docs or to the respective IDP docs for Azure or Okta
3. In your IDP, assign all users (who will be using Mixpanel in any Linked Organization) into the newly configured app
4. (Optional) In your IDP, set up SCIM for the newly configured app, but do not start pushing groups
5. In Mixpanel, transfer claimed Domains from the original Organization to the Admin Organization. Any claimed Domains in a Linked Organization will be hidden when the Organizations are linked (step 6).

To transfer a domain, first withdraw the claim from the original Organization, then add the domain to the Admin Organization.

6. In Mixpanel, link the original Organization to the Admin Organization. Users should be able to log in via SSO again.

7. Deactivate the original SSO application in your IDP

8. (Optional) Finish setting up SCIM

   1. In your IDP, establish a Group for the users who have access to the original Organization
   2. In Mixpanel, edit the SCIM name of the original Organization to match the name of this group
   3. Configure your IDP to push this group to Mixpanel