These steps configure Active Directory Federation Services (ADFS) to pass user attributes and a valid NameID to 15Five over SAML 2.0. Complete these steps on the ADFS side after you have configured the 15Five SAML settings.
Before You Begin
- SAML SSO must already be enabled in 15Five with your subdomain and metadata saved.
- You need admin access to your ADFS server to create and edit Relying Party Trust claim rules.
Steps
Configure claim rules to pass user attributes
- Open ADFS Management and navigate to Relying Party Trusts.
- Select your 15Five Relying Party Trust entry.
- Click Edit Claim Issuance Policy.
- Click Add Rule.
- Select Send LDAP Attributes as Claims as the rule template.
- Click Next.
- Name the rule and select Active Directory as the attribute store.
- Map the LDAP attribute E-Mail-Addresses to the outgoing claim type E-Mail Address.
- Map any additional required attributes (first name, last name, employee ID) to their corresponding outgoing claim types.
- Click Finish.
Configure the Transform rule for NameID
- Click Add Rule again in the same Edit Claim Issuance Policy dialog.
- Select Transform an Incoming Claim as the rule template.
- Click Next.
- Set Incoming claim type to E-Mail Address.
- Set Outgoing claim type to Name ID.
- Set Outgoing name ID format to
urn:oasis:names:tc:SAML:2.0:nameid-format:transient. - Click Finish, then click OK to save all claim rules.
If Something Goes Wrong
| Issue | Check | Fix |
|---|---|---|
| No user attributes arrive in 15Five | Claim rules exist on the Relying Party Trust | Add the LDAP attribute mapping rule as described above; confirm Active Directory is the attribute store |
| Attribute mismatch error on login | Transform rule for NameID is missing or uses the wrong format | Add the Transform rule and set outgoing name ID format to urn:oasis:names:tc:SAML:2.0:nameid-format:transient
|
| Email claim not passing | Outgoing claim type is not set to E-Mail Address | Edit the LDAP rule and confirm the mapping from E-Mail-Addresses to E-Mail Address |
| NameID not recognized by 15Five | Email rule and Transform rule are both sending NameID | Remove NameID from the LDAP attribute rule; NameID must come only from the Transform rule |
Not Covered Here
This article covers ADFS claim rule configuration only — for 15Five-side SAML attribute mapping and SSO settings, see the primary SSO setup article.