Single sign-on (SSO)

Customize how your team can login to your admin dashboard

SSO functionality is available on Enterprise plan.

Use single sign-on to your dashboard via SAML and OIDC. If you use Okta, Google Workspace, or Microsoft Entra, we have provider-specific documentation for setting up SSO. If you use another provider, please contact us.

Okta

SAML

1. Create an application

   Under Applications, click to create a new app integration using SAML 2.0.

2. Configure integration

   Enter the following:

   • Single sign-on URL (provided by Mintlify)
   • Audience URI (provided by Mintlify)
   • Name ID Format: EmailAddress
   • Attribute Statements:

     Name	Name format	Value
     firstName	Basic	user.firstName
     lastName	Basic	user.lastName

3. Send us your IdP information

   Once the application is set up, navigate to the sign-on tab and send us the metadata URL. We’ll enable the connection from our side using this information.

Google Workspace

SAML

1. Create an application

   Under Web and mobile apps, select Add custom SAML app from the Add app dropdown.

   
2. Send us your IdP information

   Copy the provided SSO URL, Entity ID, and x509 certificate and send it to the Mintlify team.

   
3. Configure integration

   On the Service provider details page, enter the following:

   • ACS URL (provided by Mintlify)
   • Entity ID (provided by Mintlify)
   • Name ID format: EMAIL
   • Name ID: Basic Information > Primary email

   

   On the next page, enter the following attribute statements:

   Google Directory Attribute	App Attribute
   First name	firstName
   Last name	lastName

   Once this step is complete and users are assigned to the application, let our team know and we’ll enable SSO for your account!

Microsoft Entra

SAML

1. Create an application

   1. Under “Enterprise applications”, select New application.
   2. Select Create your own application and choose “Integrate any other application you don’t find in the gallery (Non-gallery).”
2. Configure SAML

   Navigate to the Single Sign-On setup page and select SAML. Under “Basic SAML Configuration,” enter the following:

   • Identifier (Entity ID): The Audience URI provided by Mintlify.
   • Reply URL (Assertion Consumer Service URL): The ACS URL provided by Mintlify.

   Leave the other values blank and select Save.

3. Configure Attributes & Claims

   Edit the Attributes & Claims section:

   1. Select Unique User Identifier (Name ID) under “Required Claim.”
   2. Change the Source attribute to use user.primaryauthoritativeemail.
   3. Under Additional claims, create the following claims:

      Name	Value
      firstName	user.givenname
      lastName	user.surname

4. Send Mintlify your IdP information

   Once the application is set up, navigate to the “SAML Certificates” section and send us the App Federation Metadata URL. We’ll enable the connection from our side using this information.

5. Assign Users

   Navigate to “Users and groups” in your Entra application and add the users who should have access to your dashboard.