diff --git a/advanced/dashboard/sso.mdx b/advanced/dashboard/sso.mdx index 86431b2d4..725b4969d 100644 --- a/advanced/dashboard/sso.mdx +++ b/advanced/dashboard/sso.mdx @@ -4,7 +4,8 @@ description: "Customize how your team can login to your admin dashboard" --- - SSO functionality is available on our [Enterprise plan](https://mintlify.com/pricing?ref=sso). Please{" "} + SSO functionality is available on our [Enterprise + plan](https://mintlify.com/pricing?ref=sso). Please{" "} contact sales for more information. @@ -90,5 +91,41 @@ Use single sign-on to your dashboard via SAML and OIDC. If you use Okta or Googl + + +## Microsoft Entra - \ No newline at end of file + + + + + 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)." + + + 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**. + + + 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` | + + + 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. + + + Navigate to "Users and groups" in your Entra application and add the users who should have access to your dashboard. + + + +