Skip to content

Commit d54d02b

Browse files
docs(admin): simplify Entra SAML attribute mapping guidance (#10872)
Recommend explicit email and name claims in Entra aligned with Cube defaults, move the step before Cube IdP configuration, and drop redundant Cube field and long-URI troubleshooting notes. Co-authored-by: Cursor <cursoragent@cursor.com>
1 parent 22031fb commit d54d02b

1 file changed

Lines changed: 17 additions & 15 deletions

File tree

  • docs-mintlify/admin/sso/microsoft-entra-id

docs-mintlify/admin/sso/microsoft-entra-id/saml.mdx

Lines changed: 17 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -54,7 +54,23 @@ First, enable SAML authentication in Cube:
5454
4. Go to **SAML Certificates → Edit** and select **Sign SAML
5555
response and assertion** for the **Signing Option**.
5656
5. Download the **Federation Metadata XML** file — you'll need it
57-
in the next step.
57+
when completing the Cube configuration.
58+
59+
## Configure attribute mappings
60+
61+
Before returning to Cube, configure the SAML claims Entra sends during
62+
login. Cube uses these claims to identify the user and map optional
63+
attributes such as display name.
64+
65+
Create explicit SAML claims in Entra with the names Cube uses by default.
66+
67+
1. In your Entra Enterprise Application, go to **Single sign-on →
68+
Attributes & Claims**.
69+
2. Add the following claims. Leave **Namespace** blank for each claim:
70+
- **Email** — Set **Name** to `email` and **Source attribute** to
71+
`user.userprincipalname` or `user.mail`.
72+
- **Display name** — Set **Name** to `name` and **Source attribute** to
73+
`user.displayname`.
5874

5975
## Complete configuration in Cube
6076

@@ -125,20 +141,6 @@ exists.
125141

126142
</Warning>
127143

128-
## Configure attribute mappings
129-
130-
To map user attributes from Entra to Cube, configure the claim URIs
131-
in the SAML settings:
132-
133-
- Enter the claim URI that corresponds to the user's email address in
134-
the **Email** attribute field. Common values:
135-
- `http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress`
136-
- `http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name`
137-
- To map a role attribute from Entra to an identically-named role
138-
defined in Cube, add the corresponding claim URI to the
139-
**Role** field.
140-
- You can also map the user's display name in the same manner.
141-
142144
<Info>
143145

144146
Admin status cannot be set via SSO. To grant admin permissions, update

0 commit comments

Comments
 (0)