Custom Authentication - Auth0 | Admin Guide - Zoho Directory

Custom authentication with Auth0

Prerequisites

Roles required to perform this action :

  • Organization Owner

  • Organization Admin

Custom authentication with Auth0:


Custom authentication with Auth0 enables SAML-based single sign-on (SSO) from Auth0 to Zoho. With SSO, you and your employees can sign in to Auth0 and access Zoho directly, without having to sign in to Zoho.

To set up custom authentication with Auth0:
  1. Sign in to Auth0.
  2. Go to Applications, then click CREATE APPLICATION.
  3. Enter "Zoho Directory" in the Name field, choose Regular Web Applications, then click CREATE.
  4. Go to the app's Addons tab, then click SAML2 WEB APP.
  5. In the Settings tab, enter your ACS URL in the Application Callback URL field.
    6. Note: You can find the ACS URL in Zoho Directory's Custom Authentication page.
    ACS URL.
  6. Go to the Usage tab, download the Identity Provider Certificate, and copy the Identity Provider Login URL. Submit this data to Zoho to set up SAML in Zoho Directory.
    1. Enter Identity Provider Login URL under Sign-in URL.
    2. Upload Identity Provider Certificate under Verification Certificate.
  7. Go back to the Settings tab, then replace the code under Settings with the following:
    8. {
          "nameIdentifierFormat": "urn:oasis:names:tc:SAML:1.1:nameid-format:emailaddress",
          "nameIdentifierProbes": [
                "http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress",
                "http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name"
          ]
    }
  8. Click ENABLE.