Learn how to configure a connection to Auth0 via SAML
Each SSO Identity Provider requires specific information to create and configure a new Connection. Often, the information required to create a Connection will differ by Identity Provider.
To create a Auth0 SAML Connection, you'll need four pieces of information: an ACS URL, an Identity Provider Issuer (also known as an Entity ID), an Identity Provider SSO URL, and an X.509 Certificate.
WorkOS provides the ACS URL, which is readily available in your Connection's Settings in the Developer Dashboard.
The ACS URL is the location an Identity Provider redirects its authentication response to. In Auth0's case, the ACS URL needs to be set by the Enterprise when configuring your application in their Auth0 instance.
Specifically, the ACS URL will need to be set as the "Application Callback URL" on the SAML2 Web App Settings page found under the "Addons" tab in an Auth0 application.
And then you provide the Auth0 Issuer (Entity ID), SSO URL and X.509 certificate.
Normally, this information will come from your Enterprise customer's IT Management team when they set up your application's SAML 2.0 configuration in their Auth0 admin dashboard. However, should that not be the case during your setup. Here's how to obtain them:
1Log In and Select Your Application
Log in to the Auth0 admin dashboard, select "Applications" in the sidebar, and then select the "Applications" menu option. Next, select your application from the list of applications.
2Obtain Identity Provider Details
Open the "Addons" tab and select the SAML2 Web App to open the SAML configuration. Copy and paste the "Issuer" into the IdP URI (Entity ID) field in your WorkOS Developer Dashboard. Next, copy and paste the "Identity Provider Login URL" into the IdP SSO URL field in your WorkOS Developer Dashboard. Then select "Download Auth0 certificate" next to "Identity Provider Certificate" to obtain the X.509 Certificate, and save it to your preferred directory.
Finally, upload the X.509 Certificate in your WorkOS Connection Settings. Your Connection will then be linked and good to go!