Microsoft Entra ID SAML single sign-on
Set up SAML single sign-on with Microsoft Entra ID
Create an enterprise application in Microsoft Entra ID, configure SAML with the values from this setup, assign your users and share the app’s federation metadata with us.
The values in braces, such as {sp_entity_id}, are specific to your connection. The setup link from the application you are connecting shows them with a copy button. The same steps appear there.
-
Create an enterprise application
Section titled “Create an enterprise application”Sign in to the Microsoft Entra admin center as at least a Cloud Application Administrator. Browse to Entra ID > Enterprise apps, select New application > Create your own application, name it, choose “Integrate any other application you don’t find in the gallery” and select Add.
-
Open the SAML settings
Section titled “Open the SAML settings”In the app’s Manage section, select Single sign-on, then select SAML.
-
Enter the identifier
Section titled “Enter the identifier”In Basic SAML Configuration, select Edit. In Identifier (Entity ID), paste
{sp_entity_id}.Paste into Microsoft Entra ID:
- SP entity ID:
{sp_entity_id}
Fixes:
saml_audience_mismatch - SP entity ID:
-
Enter the reply URL
Section titled “Enter the reply URL”In Reply URL (Assertion Consumer Service URL), paste
{acs_url}, then select Save.Paste into Microsoft Entra ID:
- ACS URL:
{acs_url}
- ACS URL:
-
Check the claims
Section titled “Check the claims”In Attributes and Claims, make sure the email address, given name and surname claims are sent and the unique user identifier (name ID) is the user’s email address or another stable value.
-
Check the signing settings
Section titled “Check the signing settings”In SAML Certificates, make sure the assertion is signed with SHA-256.
Fixes:
saml_signature_missing,saml_signature_algorithm_weak -
Assign people to the app
Section titled “Assign people to the app”In the app’s Users and groups, assign the people or groups who should sign in with single sign-on.
Fixes:
saml_idp_status_error -
Share the federation metadata
Section titled “Share the federation metadata”In SAML Certificates, copy the app’s federation metadata URL (or download the federation metadata XML) and add it to this setup. Do this again whenever the signing certificate changes.
-
Test the connection
Section titled “Test the connection”Run a test sign-in in this setup, signing in as a user you assigned to the app.
Optional: add the standby reply URL
Section titled “Optional: add the standby reply URL”If our main network ever has an outage, sign-ins can continue through a standby address, but only if Entra ID accepts it. If you uploaded our metadata file, the standby URL is already a second reply URL; check that it is listed. Otherwise, in Basic SAML Configuration, add {standby_acs_url} as a second Reply URL, keep {acs_url} as the default and select Save. Then confirm in this setup that you added it.
Paste into Microsoft Entra ID:
- Standby ACS URL:
{standby_acs_url} - ACS URL:
{acs_url}
This step is optional. See standby route behavior for what the standby address does during an outage.