Safeguard Documentation Center
SSO AuthenticationSAML 2.0

Microsoft Entra ID

Configure Microsoft Entra ID (formerly Azure AD) as a SAML 2.0 identity provider for Safeguard.

Microsoft Entra ID

Example values

The tenant-specific values (the sg_ab12cde parts) show the shape only — Safeguard displays your real ACS URL and SP Entity ID in the Add Provider dialog after you click Save. This table makes it unambiguous which value goes on which side.

In Microsoft Entra ID — the SAML app / SP details (you enter these at the IdP):

FieldExample value
ACS URL (Reply URL / Assertion Consumer Service URL)https://api.safeguard.sh/auth/idp/realms/sg_ab12cde/broker/entra/endpoint
SP Entity ID / Audiencehttps://api.safeguard.sh/auth/idp/realms/sg_ab12cde
Name ID formatEmailAddress
email attributethe signed-in user's email (user.mail, not the default user.userprincipalname)

In Safeguard — Add Provider → SAML 2.0 (you copy these from the IdP):

FieldExample value
Aliasentra
Display NameSign in with Microsoft Entra ID
SSO Service URLhttps://login.microsoftonline.com/<tenant-guid>/saml2
Entity IDhttps://sts.windows.net/<tenant-guid>/
X.509 Certificatethe PEM block below
-----BEGIN CERTIFICATE-----
MIIDdDCCAlygAwIBAgIGAX...(full cert from your IdP)...P3B/k0SolrFYPo
-----END CERTIFICATE-----
  1. In the Microsoft Entra admin center, go to Enterprise applications → New application → Create your own application, choose "Integrate any other application you don't find in the gallery," and create it.
  2. Open the app, go to Single sign-on → SAML.
  3. Edit Basic SAML Configuration:
    • Identifier (Entity ID): the SP Entity ID Safeguard shows after Save
    • Reply URL (ACS URL): the ACS URL Safeguard shows after Save
  4. Set the Unique User Identifier (Name ID) to user.mail — Entra's out-of-box default is user.userprincipalname, which isn't always the same as the user's email address.
  5. Under Attributes & Claims, also add or rename a claim so its Name is exactly email, mapped to user.mail (required) — Entra's default claim set uses full claim-type URIs, not this short name, and Safeguard needs the literal email attribute separate from the Name ID above.
  6. Under SAML Certificates, copy the Login URL, Microsoft Entra Identifier (Entity ID), and download the Certificate (Base64), or copy the App Federation Metadata URL if you'd rather import metadata directly.
  7. In Safeguard, click Add Provider → SAML 2.0 → Microsoft Entra ID, and enter the Login URL, Entra Identifier, and certificate contents from step 6.
  8. Back in Entra, go to Users and groups and assign the users/groups who should have access.
  9. Click Test in Safeguard to confirm.

Common errors: an AADSTS50105 "user not assigned to a role" error means you skipped assigning users/groups in step 8. An AADSTS75011 reply URL mismatch means the Reply URL doesn't exactly match the Callback URL (check for a trailing slash). If you pasted individual values instead of importing the metadata URL, Entra's signing certificate rotates periodically — re-sync it in Safeguard when Entra warns about upcoming rotation.

On this page