Skip to content

Commit b2b9c1a

Browse files
docs: Update microsoft-entra-id.mdx (#9103)
Clearer Entra ID role mapping instructions
1 parent a64272e commit b2b9c1a

File tree

1 file changed

+13
-4
lines changed

1 file changed

+13
-4
lines changed

docs/pages/product/workspace/sso/microsoft-entra-id.mdx

Lines changed: 13 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -79,7 +79,7 @@ Download <Btn>Federation Metadata XML</Btn>:
7979

8080
## Complete configuration in Cube Cloud
8181

82-
Upload it to Cube Cloud through <Btn>Advanced Settings</Btn> tab on the [SAML
82+
Upload the manifest file through the <Btn>Advanced Settings</Btn> tab on the [SAML
8383
configuration page](#enable-saml-in-cube-cloud) in Cube Cloud:
8484

8585
<Screenshot src="https://ucarecdn.com/3ae24797-bd0a-477c-9b9a-420602694616/"/>
@@ -88,11 +88,20 @@ Select <Btn>SHA-256</Btn> as <Btn>Signature Algorithm</Btn>:
8888

8989
<Screenshot src="https://ucarecdn.com/e0c8c608-9b1e-4b84-a51e-0613362c6aec/"/>
9090

91-
Enter “[http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name](http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name)
92-
or a preferred attribute to lookup email address in <Btn>Attributes → Email</Btn>:
91+
Enter the claim URI that corresponds to the user email address in <Btn>Attributes → Email</Btn>. This will vary based on your SAML configuration.
92+
93+
Examples:
94+
95+
`http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress`
96+
97+
`http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name`
9398

9499
<Screenshot src="https://ucarecdn.com/4fe50791-8203-49d4-9056-e5de6dc5643c/"/>
95100

101+
To map a role attribute from Entra ID to an identically-named role defined in Cube, add the claim URI corresponding to role to the Role field in Cube Cloud, similar to above. Note that Admin status cannot be set via SSO.
102+
103+
You can map the user's display name from Entra ID to Cube in the same manner.
104+
96105
Save settings on the Cube Cloud side.
97106

98107
## Final steps
@@ -108,4 +117,4 @@ and verify that the SAML integration now works for your Cube Cloud account:
108117

109118
Done! 🎉
110119

111-
[ext-ms-entra-id]: https://www.microsoft.com/en-us/security/business/identity-access/microsoft-entra-id
120+
[ext-ms-entra-id]: https://www.microsoft.com/en-us/security/business/identity-access/microsoft-entra-id

0 commit comments

Comments
 (0)