SurePassID Identity Provider
SAML ACR / AMR Configuration Guide
Applies to: SurePassID Identity Provider 2026.4 Audience: Tenant administrators configuring SAML 2.0 service provider apps Protocol scope: SAML 2.0 only (see Notes for OIDC and EAM)
What ACR and AMR Provide
When a SAML app is configured for these signals, the IdP tells the service provider how the user authenticated, so the SP can apply its own risk or step-up policy.
| Signal | Meaning | How it is delivered |
|---|---|---|
| ACR | Authentication Context Class Reference - single-factor vs multi-factor | Native <saml:AuthnContextClassRef> element |
| AMR | Authentication Methods Reference (RFC 8176 tokens such as
pwd, otp, sms) |
Custom multi-valued SAML attribute |
SAML 2.0 has a native element for ACR but none for AMR, so AMR is emitted as an attribute using the widely supported ADFS claim URI.
How to Enable It
Configuration is performed in the Admin Portal, on the SSO app's attribute list. There are no global switches and no new configuration files.
- Open the Admin Portal and edit the SAML SSO app.
- Go to the app's Attributes (name/value pair) list.
- Add one row whose Value is the
literal text
amroracr.- The Name column is not used for detection; you may
use
amrfor clarity. - Matching is case-insensitive and surrounding whitespace is ignored.
- The Name column is not used for detection; you may
use
- Save the app.
That single row is the opt-in switch. Both amr and
acr behave identically - adding either one turns on
both the ACR element and the AMR attribute.
Important: The placeholder row is never sent as-is. The IdP removes the literal
amr/acrvalue and replaces it with the computed values at response time.
Turning it off
Delete the placeholder row. Apps without the row are completely unaffected, so existing integrations keep their current behavior.
What the Service Provider Receives
ACR
Emitted inside the <AuthnStatement>:
| Authentication | <AuthnContextClassRef> value |
|---|---|
| Single factor | urn:oasis:names:tc:SAML:2.0:ac:classes:Password |
| Two or more factors | urn:oasis:names:tc:SAML:2.0:ac:classes:MobileTwoFactorContract |
AMR
Emitted as a multi-valued attribute, one
<AttributeValue> per factor:
- Name:
http://schemas.microsoft.com/claims/authnmethodsreferences - FriendlyName:
amr
Example for a password plus push approval login:
<saml:Attribute Name="http://schemas.microsoft.com/claims/authnmethodsreferences"
FriendlyName="amr">
<saml:AttributeValue>pwd</saml:AttributeValue>
<saml:AttributeValue>mfa</saml:AttributeValue>
</saml:Attribute>Factor token reference (RFC 8176)
| Factor the user completed | Token emitted |
|---|---|
| Password / directory login | pwd |
| FIDO2 / WebAuthn roaming security key | hwk |
| FIDO2 / WebAuthn platform authenticator | swk |
| TOTP / OTP hardware or soft token | otp |
| SMS one-time passcode | sms |
| Push app approval | mfa |
| Fingerprint / face biometric | fpt / face |
Rules applied automatically:
- Tokens are de-duplicated and kept in a stable order.
- If two or more distinct factors were used,
mfais appended to the list. - If no factors were recorded for the session, the IdP emits
pwdso behavior matches earlier releases.
Service Provider Setup
The SP must be told to read the signals. Configuration is SP-specific, but generally:
- ACR - map or accept the two URIs listed above. Many SPs allow a required ACR value so that single-factor logins are rejected.
- AMR - map the claim named
http://schemas.microsoft.com/claims/authnmethodsreferences. Salesforce and other ADFS-compatible consumers recognize this URI directly.
If your SP expects a single space-delimited AMR string rather than multiple values, contact SurePassID Support - the formatting is centralized and can be adjusted.
Verifying the Configuration
- Sign in to the app using a single factor and capture the SAML response (browser SAML tracer or the IdP audit log).
- Confirm
<AuthnContextClassRef>is the...ac:classes:PasswordURI and the AMR attribute containspwd. - Sign in again completing MFA.
- Confirm the ACR URI changes to
...MobileTwoFactorContractand the AMR attribute lists each factor plusmfa. - Confirm no attribute contains the literal value
amroracr.
Troubleshooting
| Symptom | Likely cause |
|---|---|
| No ACR or AMR in the response | Placeholder row missing, or its Value is not
exactly amr/acr |
Literal amr shows up as an attribute value |
The value has extra characters; re-enter it as plain
amr |
AMR always shows only pwd |
The login completed with one factor, or no MFA policy applied to that app |
| ACR never reports multi-factor | MFA was not actually performed; check the app's MFA policy |
| SP ignores the values | SP-side claim mapping not configured for the AMR claim URI |
Notes for OIDC and EAM
- EAM reuses the same captured authentication methods
and emits
acrandamrclaims in the id_token. - OIDC app configuration for these signals is not driven by the SAML attribute placeholder described here.
- Federation policy evaluation is enforced for SAML 2.0 only in this release.
Related Documents
- SurePassID Identity Provider User Guide
- SurePassID Identity Provider Capabilities
- Document History
| Version | Date | Change |
|---|---|---|
| 2026.4 | September 15, 2026 | Initial administrator configuration guide |
© 2013–2026 SurePassID. All rights reserved. Protected by patents pending. SurePassID, the SurePassID logo and design, and Secure SSO are registered trademarks or trademarks of SurePassID, Corp. in the United States and/or other jurisdictions. All other marks and names mentioned herein may be trademarks of their respective companies.
SurePassID 360 Central Avenue #800 St. Petersburg, FL 33701 USA +1 (888) 200-8144 surepassid.com