Skip to content

Commit fe38fe1

Browse files
docs: instructions for entra sso (#801)
* docs: instructions for entra sso * fix stash conflict * fix auto-formatter madness * Apply suggestions from code review * copyedits --------- Co-authored-by: Ethan Palm <[email protected]>
1 parent 35c999e commit fe38fe1

File tree

1 file changed

+39
-2
lines changed

1 file changed

+39
-2
lines changed

advanced/dashboard/sso.mdx

Lines changed: 39 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,8 @@ description: "Customize how your team can login to your admin dashboard"
44
---
55

66
<Info>
7-
SSO functionality is available on our [Enterprise plan](https://mintlify.com/pricing?ref=sso). Please{" "}
7+
SSO functionality is available on our [Enterprise
8+
plan](https://mintlify.com/pricing?ref=sso). Please{" "}
89
<a href="mailto:[email protected]">contact sales</a> for more information.
910
</Info>
1011

@@ -90,5 +91,41 @@ Use single sign-on to your dashboard via SAML and OIDC. If you use Okta or Googl
9091
</Step>
9192
</Steps>
9293
</Tab>
94+
</Tabs>
95+
96+
## Microsoft Entra
9397

94-
</Tabs>
98+
<Tabs>
99+
<Tab title="SAML">
100+
<Steps>
101+
<Step title="Create an application">
102+
1. Under "Enterprise applications", select **New application**.
103+
2. Select **Create your own application** and choose "Integrate any other application you don't find in the gallery (Non-gallery)."
104+
</Step>
105+
<Step title="Configure SAML">
106+
Navigate to the Single Sign-On setup page and select **SAML**. Under "Basic SAML Configuration," enter the following:
107+
* Identifier (Entity ID): The Audience URI provided by Mintlify.
108+
* Reply URL (Assertion Consumer Service URL): The ACS URL provided by Mintlify.
109+
110+
Leave the other values blank and select **Save**.
111+
</Step>
112+
<Step title="Configure Attributes & Claims">
113+
Edit the Attributes & Claims section:
114+
1. Select **Unique User Identifier (Name ID)** under "Required Claim."
115+
2. Change the Source attribute to use `user.primaryauthoritativeemail`.
116+
3. Under Additional claims, create the following claims:
117+
| Name | Value |
118+
| ---- | ----- |
119+
| `firstName` | `user.givenname` |
120+
| `lastName` | `user.surname` |
121+
</Step>
122+
<Step title="Send Mintlify your IdP information">
123+
Once the application is set up, navigate to the "SAML Certificates" section and send us the App Federation Metadata URL.
124+
We'll enable the connection from our side using this information.
125+
</Step>
126+
<Step title="Assign Users">
127+
Navigate to "Users and groups" in your Entra application and add the users who should have access to your dashboard.
128+
</Step>
129+
</Steps>
130+
</Tab>
131+
</Tabs>

0 commit comments

Comments
 (0)