Identity and people
Auth0
Use Auth0 as your SAML identity provider with the SAML2 Web App add-on.
Configure Auth0 as the identity provider for Diakrin. Use a dedicated application with the SAML2 Web App add-on, rather than an inbound SAML connection that signs users into Auth0.
Create the application
- In Auth0 Dashboard, open Applications → Applications and create a dedicated application named Diakrin.
- Open Addons → SAML2 Web App and enable the add-on.
- Set Application Callback URL to the ACS URL in your setup packet.
- In the add-on settings, map
emailto the user’s work email and set the audience to Diakrin’s SP Entity ID. Use EmailAddress NameID with the mapped work email, or an agreed stable Persistent identifier. - Apply your organization’s connection and access policies so only pilot users can sign in.
Review the settings
| Auth0 setting | Value |
|---|---|
| Application Callback URL / recipient | Diakrin ACS URL |
audience | Diakrin SP Entity ID |
mappings | Work email mapped to email |
nameIdentifierFormat | EmailAddress or Persistent |
| Signature / digest | RSA-SHA256 / SHA256 |
Ensure NameID selects the intended mapped identifier. Auth0’s defaults can use a different NameID format or older signing algorithms; review the add-on’s settings explicitly.
Copy the email-based settings
In the add-on’s Settings tab, use this starting configuration. Replace both placeholder URLs with the exact setup-packet values, and set Application Callback URL to the same ACS URL.
{
"audience": "REPLACE_WITH_DIAKRIN_SP_ENTITY_ID",
"recipient": "REPLACE_WITH_DIAKRIN_ACS_URL",
"mappings": { "email": "email" },
"passthroughClaimsWithNoMapping": false,
"mapIdentities": false,
"nameIdentifierFormat": "urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress",
"nameIdentifierProbes": ["email"],
"signatureAlgorithm": "rsa-sha256",
"digestAlgorithm": "sha256"
}The profile’s email must contain the employee’s work email. The mapping sends an attribute named email; the probe uses that value for NameID. If you use Persistent NameID, agree its stable identifier with Diakrin before changing this example. Review any existing Auth0 Actions that override SAML settings.
Activate and test
Open the add-on’s Usage tab and obtain Identity Provider Metadata. Return the metadata URL or XML, approved domains and certificate expiry to your Diakrin onboarding contact. Keep custom-domain metadata and login endpoints consistent. After activation, follow Test and roll out SSO.
Official references: Configure Auth0 as a SAML identity provider ↗, Customize SAML assertions ↗ and Attribute mapping examples ↗.