SSO AuthenticationSAML 2.0
AD FS
Configure Active Directory Federation Services (AD FS) as a SAML 2.0 identity provider for Safeguard.
AD FS
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 AD FS — the Relying Party Trust (you enter these at the IdP):
| Field | Example value |
|---|---|
| SAML 2.0 WebSSO URL (ACS URL) | https://api.safeguard.sh/auth/idp/realms/sg_ab12cde/broker/adfs/endpoint |
| Relying party trust identifier (SP Entity ID) | https://api.safeguard.sh/auth/idp/realms/sg_ab12cde |
| Name ID format | EmailAddress |
email attribute | LDAP E-Mail-Addresses, sent via a second outgoing claim rule named email |
In Safeguard — Add Provider → SAML 2.0 (you copy these from the IdP):
| Field | Example value |
|---|---|
| Alias | adfs |
| Display Name | Sign in with AD FS |
| SSO Service URL | https://<adfs-host>/adfs/ls/ |
| Entity ID | http://<adfs-host>/adfs/services/trust |
| X.509 Certificate | the PEM block below |
-----BEGIN CERTIFICATE-----
MIIDdDCCAlygAwIBAgIGAX...(full cert from your IdP)...P3B/k0SolrFYPo
-----END CERTIFICATE------ On the AD FS server, open AD FS Management → Relying Party Trusts → Add Relying Party Trust → Claims aware, and enter data manually.
- Set the Relying party trust identifier to the SP Entity ID Safeguard shows after Save (this is the Entity ID).
- Enable SAML 2.0 WebSSO and set its URL to the ACS URL Safeguard shows after Save.
- Add an Issuance Transform Rule mapping
E-Mail-Addressesto the Name ID outgoing claim, format Email. - Add a second Issuance Transform Rule mapping
E-Mail-Addressesto an outgoing claim type named exactlyemail— AD FS's default claim types are full URIs, not this short name, and Safeguard needs the literalemailattribute separate from the Name ID rule. - Export the token-signing certificate under Service → Certificates, and note the SAML 2.0/WS-Federation endpoint under Endpoints (or the federation metadata URL).
- In Safeguard, click Add Provider → SAML 2.0 → AD FS, and enter the endpoint, Entity ID, and certificate.
- Grant access under the relying party trust's Access Control Policy.
- Click Test in Safeguard to confirm.
Common errors: an "MSIS7042: claims required by relying party trust were not present" error means the Issuance Transform Rule mapping E-Mail-Addresses → Name ID is missing, or the signed-in AD account has no email attribute set.