Skip to main content

Setting Up SSO with Auth0

This guide walks through configuring Auth0 as your SAML SSO provider for Auxia.

Prerequisites​

Before you begin, confirm you have the following:

  • Admin access to your Auth0 tenant
  • ACS URL from your Auxia representative
  • SP Entity ID from your Auxia representative

If you don't have the ACS URL and SP Entity ID yet, contact your Auxia representative before proceeding.

Step 1: Open Your Application in Auth0​

  1. Log in to your Auth0 dashboard.
  2. Navigate to Applications → Applications.
  3. Select the application your users log in through.

Step 2: Enable the SAML2 Web App Addon​

  1. In your application, click the Addons tab.
  2. Toggle on SAML2 Web App. A settings modal will appear.

Step 3: Configure SAML Settings​

In the SAML2 Web App settings modal:

  1. Set the Application Callback URL to the ACS URL provided by Auxia.

  2. In the Settings JSON object, add your SP Entity ID as the audience value:

    {
      "audience": "<SP Entity ID provided by Auxia>"
    }

  3. Click Enable.

Step 4: Copy the SAML Metadata URL​

  1. In your application, click the Settings tab.
  2. Scroll down to Advanced Settings.
  3. Click the Endpoints tab.
  4. Copy the SAML Metadata URL.

Step 5: Share the Metadata URL with Auxia​

Send the SAML Metadata URL to your Auxia representative. They will use it to complete the SSO connection on the Auxia side.

Once your Auxia representative confirms the connection is active, your users will be able to log in to Auxia Console using their Auth0 credentials.

Troubleshooting​

Users can't log in after setup​

  • Verify the ACS URL and SP Entity ID were entered correctly (Step 3).
  • Confirm the SAML2 Web App addon is enabled for the correct application.
  • Check that the user's email domain is associated with your Auth0 tenant.

The metadata URL isn't working​

  • Make sure you copied the SAML Metadata URL from the Endpoints tab, not the SAML protocol URL.
  • Confirm the SAML2 addon is still enabled — if it was toggled off and back on, share the metadata URL with your Auxia representative again.

Need help?​

Contact your Auxia representative or reach out to support@auxia.io.