Skip to content
Dashboard
Theme
Theme

Microsoft Entra ID SAML single sign-on

Set up SAML single sign-on with Microsoft Entra ID

View Markdown

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.

  1. 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.

  2. In the app’s Manage section, select Single sign-on, then select SAML.

  3. 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

  4. In Reply URL (Assertion Consumer Service URL), paste {acs_url}, then select Save.

    Paste into Microsoft Entra ID:

    • ACS URL: {acs_url}

    Fixes: saml_destination_mismatch, saml_response_malformed

  5. 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.

    Fixes: saml_email_missing, saml_nameid_missing

  6. In SAML Certificates, make sure the assertion is signed with SHA-256.

    Fixes: saml_signature_missing, saml_signature_algorithm_weak

  7. 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

  8. 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.

    Fixes: saml_signature_invalid, saml_issuer_mismatch

  9. Run a test sign-in in this setup, signing in as a user you assigned to the app.

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.