The documentation on how to integrate auth0 with freshdesk is sparse and the ones I did find were outdated
The following is broken down by service into steps
Auth0:
Applications
/ Create Application
.Single Page Web App
or Regular Web App
.Settings
tab.Allowed Callback URLs
insert https://[YOURDOMAIN].freshdesk.com/login/saml.Allowed Web Origins
be sure to put your domain.Allowed Origins (CORS)
be sure to put your domain.Addons
tab.SAML 2
Application Callback URL
be sure the url is https://[YOURDOMAIN].freshdesk.com/login/saml.{
"audience": "https://[YOURDOMAIN].freshdesk.com",
"mappings": {
"email": "Email",
"name": "username",
"given_name": "FirstName",
"family_name": "LastName"
},
"nameIdentifierFormat": "urn:oasis:names:tc:SAML:2.0:nameid-format:email",
"nameIdentifierProbes": [
"http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress"
],
"signatureAlgorithm": "rsa-sha256",
"digestAlgorithm": "sha256",
"lifetimeInSeconds": 3600,
"signResponse": false
}
Usage
tab download the Auth0 certificate
Identity Provider Login URL
as we will be using this on freshdesk.Freshdesk:
Settings
/ General Settings
/ Security
Single Sign On (SSO)
SAML Login URL
paste in the Identity Provider Login URL
from auth0.Auth0 certificate
and find the sha256 fingerprint and place into the Security Certificate Fingerprint
field. Note: you may need to format your fingerprint to include :
between each value.Special Note: I did notice that agents will now have to go through auth0 in order to get to the admin dashboard. To circumvent that try logging in through this portal: https://[YOURDOMAIN].freshdesk.com/login/normal.
I hope that these instructions help you out in your freshdesk auth0 integrations. good luck!