Setting up single sign-on using Auth0 and SAML

Workpath supports single sign-on (SSO) logins through SAML 2.0. A SAML 2.0 identity provider (IDP) can take many forms, one of which is an Auth0 Application with the SAML add-on. This configuration allows your users to authenticate using any backend authentication connection, such as an LDAP directory, a database, or even other SAML IDPs or Social Providers supported by Auth0.

Create the application in Auth0

1. Go to Dashboard > Applications.
2. Click the + CREATE APPLICATION button on the right.
   
3. In the Name field, enter "Workpath", and select "Regular Web Application" as application type.
   
4. Click SAVE.
5. Click on the Settings tab.
6. Scroll down and click on the Advanced Settings link.
   
7. Click on the Endpoints tab.
8. Write down the SAML Metadata URL.
   

Configuration of Workpath

1. Please provide your Workpath Account Manager with the SAML Metadata URL you obtained when creating the application.
2. Your Workpath Account Manager will then configure the account on Workpath's side accordingly and provide you with an Application Callback URL and addon settings. Proceed to configure the SAML add-on in Auth0.

Configure the SAML add-on in Auth0

1. Open the application settings from Dashboard > Applications.
2. Click on the Addons tab and select SAML2 Web App.
   
3. Enter the Application Callback URL and the addon settings you have received from your Workpath account manager and the settings in the modal.
   
   
4. Click on Save.  

Testing Single Sign-On

Once the configuration is completed in Auth0 and Workpath, it is time to test the single sign-on.

1. Open the login page of your Workpath account (https://{account-subdomain}.workpath.com) and click on the Login Button.
   
   
   
   
2. Enter your Auth0 credentials.
   
   
   
   
3. Hurray! You are now logged in to Workpath with your Auth0 account.