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

What You Will Need

Before you begin, verify that you have:
  • An Atatus account with the Owner or Admin role.
  • Administrative access to your OneLogin portal.

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.
Atatus Single Sign-on Settings

Step 2: Add the Atatus App in OneLogin

  1. Sign in to your OneLogin Admin portal.
  2. In the top navigation bar, select Applications » Applications.
  3. Click Add App.
  4. In the search box, type Atatus and select the Atatus SAML 2.0 connector from the search results.
  5. (Optional) Customize the display name or icons, then click Save.

Step 3: Configure SAML in OneLogin

  1. In your newly created application, select the Configuration tab.
  2. In the Atatus Account ID field, paste the Atatus Account Id copied from Atatus in Step 1.
OneLogin Configuration
  1. Click Save.

Step 4: Verify Attribute Parameters

  1. Select the Parameters tab in the OneLogin application view.
  2. Verify that user attributes are mapped to the standard Atatus parameters:
  1. Click Save if you made any modifications.

Step 5: Assign Users and Roles in OneLogin

Users cannot access Atatus until assigned in OneLogin:
  1. Select the Access tab in your application view.
  2. Select the Roles that should have access to Atatus.
  3. Alternatively, navigate to Users » Users, open an individual user profile, select Applications, and add the Atatus application directly.
  4. Click Save.

Step 6: Copy Metadata and Configure Atatus

  1. In your OneLogin Atatus application, select the SSO tab.
  2. Locate the Issuer URL field. This URL points directly to your OneLogin SAML metadata descriptor endpoint (https://app.onelogin.com/saml/metadata/...).
  3. Click the copy icon next to the Issuer URL.
OneLogin Issuer URL
Atatus parses your SAML sign-in endpoints and certificates directly from the Issuer URL. Do not paste the SAML 2.0 Endpoint (HTTP); Atatus derives that endpoint automatically from the metadata descriptor.
  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 OneLogin Issuer URL into the text field.
  4. Click Save SSO.
  5. Confirm that the Enabled toggle switch displays active.