What You Will Need

Before you begin, verify that you have:
  • An Atatus account with the Owner or Admin role.
  • An Okta organization with administrative permissions (Super Admin or Application Administrator).

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 save the following values:
    • Atatus SAML ACS URL: https://app.atatus.com/login/saml/<ACCOUNT_ID>/acs
    • Atatus Account Id: Your unique 24-character alphanumeric identifier (for example, 5b271cc49b002019712c5100).
Atatus Single Sign-on Settings

Step 2: Add Atatus in Okta

  1. Sign in to your Okta Admin Console.
  2. In the navigation menu, select Applications » Applications.
  3. Click Browse App Catalog.
  4. In the search bar, type Atatus and select the Atatus application from the results.
  5. Click Add Integration.
  6. On the General Settings screen, review the application label and click Done.

Step 3: Configure SAML in Okta

  1. In the Atatus application settings in Okta, select the Sign On tab.
  2. Locate the Settings section and click Edit.
  3. Scroll down to the Advanced Sign-on Settings section:
    • In the Atatus Account Id field, paste the Atatus Account Id you copied in Step 1.
  4. Click Save.
  5. Under the SAML 2.0 section on the Sign On tab, locate Metadata details.
  6. Right-click the Identity Provider metadata link and click Copy link address.
Okta SAML Metadata URL

Step 4: Configure SAML Attribute Mapping

The pre-built Okta Atatus catalog integration automatically passes user attributes. If you create a custom SAML 2.0 app integration in Okta, configure the following attribute statements:
Atatus matches attributes by exact key name. Missing first names default to the user’s email address, and missing last names default to -.

Step 5: Assign Users and Groups in Okta

Users cannot sign in via SSO until you assign them to the application in Okta:
  1. In your Okta Atatus application view, select the Assignments tab.
  2. Click Assign, then select Assign to People or Assign to Groups.
  3. Locate the users or groups requiring access to Atatus and click Assign.
  4. Verify the user attributes and click Save and Go Back.
  5. Click Done.

Step 6: Add Okta 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 the SAML Metadata URL radio option.
  3. Paste the Okta Identity Provider metadata link copied in Step 3 into the text field.
  4. Click Save SSO.
  5. Confirm that the Enabled toggle switch at the top right of the card is turned ON.
Configure an Account Alias: Under SSO Account ID Alias, enter a custom slug (minimum 4 characters, for example: acme-corp) and click Save Alias. This enables a direct login URL for your team: https://app.atatus.com/login/saml/acme-corp.

Step 7: Test the SSO Configuration

Always test your SSO setup in an incognito or private browser window to avoid interrupting your active administrative session.