This guide walks you through configuring SAML 2.0 Single Sign-On (SSO) between Auth0 and Atatus.

What You Will Need

Before you begin, verify that you have:
  • An Atatus account with the Owner or Admin role.
  • An Auth0 dashboard account with administrator permissions to manage applications and actions.

Step 1: Get Service Provider Values from Atatus

  1. Log in to your Atatus dashboard.
  2. Navigate to Settings » Account Settings » Single Sign-on.
  3. Keep this tab open. Copy and record the following parameters:
    • Atatus SAML ACS URL: https://app.atatus.com/login/saml/<ACCOUNT_ID>/acs
    • Atatus Account Id: Your unique 24-character alphanumeric identifier.

Step 2: Create an Application in Auth0

  1. Sign in to your Auth0 Dashboard.
  2. In the sidebar, select Applications » Applications.
  3. Click Create Application.
  4. Enter an application name (for example, Atatus).
  5. Choose Regular Web Applications as the application type.
  6. Click Create.

Step 3: Enable and Configure the SAML2 Web App Addon

  1. Within your Atatus application in Auth0, select the Addons tab.
  2. Click the toggle to enable the SAML2 Web App addon. A configuration dialog opens.
  3. Under the Settings tab:
    • In the Application Callback URL field, paste your Atatus SAML ACS URL.
    • In the Settings JSON payload, set the audience to your Atatus Account ID:
  4. Scroll to the bottom and click Enable (or Save).
Auth0 SAML Configuration

Step 4: Configure SAML Attribute Mapping

Auth0 uses Actions (or legacy Rules) to map user claims into the SAML assertion.

Step 5: Copy Auth0 Metadata URL

  1. In your Atatus application in Auth0, return to the Addons » SAML2 Web App dialog.
  2. Select the Usage tab.
  3. Locate Identity Provider Metadata.
  4. Right-click the Download link next to Identity Provider Metadata and select Copy Link Address (or copy the Identity Provider Login URL).
Auth0 Usage Metadata Alternatively, go to application Settings » Advanced Settings » Endpoints and copy the SAML Metadata URL.

Step 6: Configure Metadata in Atatus

  1. Return to the Atatus dashboard under Settings » Account Settings » Single Sign-on.
  2. Under SAML Metadata from your SSO provider, select SAML Metadata URL.
  3. Paste the Auth0 SAML Metadata URL copied in Step 5 into the text field.
  4. Click Save SSO.
  5. Confirm that the Enabled toggle switch displays active.