Setup Azure SSO

Overview

You can set up Microsoft Azure Single Sign-On to use with your Mixpanel account. Before using this document, read the general Mixpanel SSO set-up instructions (opens in a new tab) as well as Azure's documentation on setting up a new application (opens in a new tab).

Add Mixpanel as a New Application

For more information, read this Microsoft Azure article (opens in a new tab) about configuring Mixpanel for automatic user provisioning.

  1. Navigate to Enterprise Applications on the Microsoft Azure home page under Default Directory.
  2. Click New Application.
  3. Search and select Mixpanel to add as an application.

Edit SAML Config in Microsoft Azure

  1. Click Single sign-on under Manage.
  2. Enter the following information in the SAML Configuration:

Azure Config 1 Image

  1. Click Edit under User Attributes & Claims to add the required email claim (firstName and lastName are used for provisioning and optional).
Claim nameValue
emailuser.mail
firstNameuser.givenname
lastNameuser.surname

Azure Config 2 Image

  1. Make sure to clear out the Namespace field as well, or else it won't work!

Azure Config 3 Image

  1. Download the SAML certificate under SAML Signing Certificate by clicking Download next to the Certificate (Base64) field. If you downloaded an .xml file, then you have clicked the wrong button. Make sure it is a .cer or .pem file. This will be uploaded to Mixpanel in the next step.

Copy Certificate into Mixpanel

  1. Navigate to the Access Security section in your Mixpanel Organization Settings.
  2. Upload the certificate in the SAML Certificate field.
  3. Input the Azure AD Identifier into the Issuer URL field.
  4. Input the Azure Login URL in the Identity Provider Sign-in URL field.
  5. Assign your team members this new application.

SCIM Provisioning

Azure has an auto-provisioning integration with Mixpanel that allows you automatically add users to Mixpanel upon giving them access in Azure. The integration also allows you to remove access within Mixpanel when you remove access in Azure. You can find more information here (opens in a new tab).

  • New users provisioned from Azure will be automatically added as an Organization Member.
  • You will need to provision other Organization Roles (opens in a new tab) to users within the Mixpanel product.
  • You will not be able to set the user's Organization Role and Project access within Azure.

You can also provision Groups of users in Azure to Mixpanel Teams with SCIM.

  • Use the same name for the Group in Azure as the Team in Mixpanel.
  • In the Mixpanel Team, set the Organization Role and access to projects for the group of users.
  • You will not be able to provision Organization Role and Project access for the Group within Azure.

Note that it is advised you turn on IDP Managed Access if you are using SCIM Provisioning. Otherwise, Okta and Mixpanel might fall out of sync.

Tenant URL: https://mixpanel.com/api/app/scim/v2 (opens in a new tab)

Was this page useful?