Set up SSO
The values to exchange with the Integration Mapper team, and the steps on your identity provider.
SSO is set up per environment, together with the Integration Mapper team.
- We send you the values for your environment: the Entity ID, the reply URL (ACS), the logout URL and the metadata URL.
- You create an enterprise application in your identity provider with those values, and assign the users or groups who should have access.
- You send us your identity provider’s federation metadata URL or XML.
- We enable SSO for your corporate email domains.
The values
Section titled “The values”The values follow this pattern, where {host} is your environment’s address and {tenant} its identifier:
| Value | Pattern |
|---|---|
| Entity ID | https://{host}/saml/{tenant} |
| Reply URL (ACS) | https://{host}/api/auth/saml/{tenant}/callback |
| Logout URL | https://{host}/api/auth/saml/{tenant}/logout |
| Metadata | https://{host}/api/auth/saml/{tenant}/metadata |
Use the exact values we send. Do not build them by hand.
Claims
Section titled “Claims”The email claim must be present in the SAML response. In Microsoft Entra ID, check Attributes & Claims for emailaddress. The response must have a signed assertion; this is the default in Microsoft Entra ID.
Checking that it works
Section titled “Checking that it works”On the sign-in page, type a work email from an enabled domain. The password field is replaced by Sign in with SSO, which takes you to your identity provider and back.
Provisioning with SCIM (optional)
Section titled “Provisioning with SCIM (optional)”- We send you the SCIM endpoint,
https://{host}/scim/v2/{tenant}, and a token. The token is shown only once; keep it in your identity provider. - You turn on automatic provisioning in the same enterprise application. In Microsoft Entra ID: Provisioning, mode Automatic, with the endpoint as Tenant URL and the token as Secret Token.
- You test the connection, and start provisioning for the users and groups assigned to the application.
What each attribute becomes, and what disabling a user does, is in the SCIM reference.