This guide walks you through configuring SAML 2.0 Single Sign-On (SSO) between AWS IAM Identity Center 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 the AWS Management Console with IAM Identity Center enabled.

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: Add a Custom Application in AWS IAM Identity Center

  1. Sign in to the AWS Management Console and open IAM Identity Center.
  2. In the left navigation pane, select Applications.
  3. Select the Customer managed tab, then click Add application.
  4. Choose I have an application I want to set up.
  5. Under Application type, select SAML 2.0.
  6. Click Next.

Step 3: Configure Application Properties in AWS

  1. Under Configure application, enter a Display name (for example, Atatus).
  2. In the Application metadata section, select Manually type your metadata values:
    • Application ACS URL: Paste your Atatus SAML ACS URL.
    • Application SAML audience: Paste your Atatus Account Id.
  3. Click Submit.
AWS Identity Center Configurations

Step 4: Configure SAML Attribute Mapping

  1. On the application details page, select Actions » Edit attribute mappings.
  2. Configure the following user attributes and string mappings:
AWS Identity Center Attributes
  1. Click Save changes.

Step 5: Assign Users and Groups in AWS

  1. On the Atatus application page in IAM Identity Center, select the Assigned users tab.
  2. Click Assign users.
  3. Select the individual users or groups who need access to Atatus.
  4. Click Next, review the assignments, and click Assign users.

Step 6: Download Metadata and Configure Atatus

  1. In IAM Identity Center, go to Actions » Edit configuration.
  2. In the IAM Identity Center metadata section, locate the IAM Identity Center SAML metadata file and click Download.
  3. Return to the Atatus dashboard under Settings » Account Settings » Single Sign-on.
  4. Under SAML Metadata from your SSO provider, select SAML Metadata XML.
  5. Click Choose File (or Browse) and upload the downloaded AWS IAM Identity Center metadata file.
  6. Click Save SSO.
  7. Confirm that the Enabled toggle switch displays active.

Step 7: Test the SSO Configuration

Always test your SSO integration using an incognito or private browsing window.

Test SP-Initiated Login

  1. Open an incognito browser window.
  2. Navigate to your Atatus custom login URL: https://app.atatus.com/login/saml/<ACCOUNT_ID_OR_ALIAS>.
  3. Verify redirection to your AWS access portal login page.
  4. Sign in with an assigned AWS Identity Center user.
  5. Confirm successful authentication and entry into the Atatus dashboard.

Test IdP-Initiated Login

  1. Sign in to your AWS access portal (https://<your-subdomain>.awsapps.com/start).
  2. Click the Atatus application icon.
  3. Confirm that you are logged in to Atatus in a new tab.

Troubleshooting AWS Identity Center SSO

Error: “User Not Assigned” in AWS Portal

  • Cause: The user has not been granted an assignment in IAM Identity Center.
  • Solution: Open the Atatus application in IAM Identity Center, navigate to Assigned users, and assign the user or their group.

Error: “Invalid Audience” / SAML Validation Error

  • Cause: The Application SAML audience in AWS does not match the 24-character Atatus Account ID.
  • Solution: In AWS Identity Center, select Actions » Edit configuration and ensure the Application SAML audience exactly matches your Atatus Account Id.

Error: Syntax Error in Attribute Mappings

  • Cause: Typo in the attribute mapping variable syntax (such as ${user.email} instead of ${user:email}).
  • Solution: Verify that all user attribute mappings use colons (${user:email}, ${user:givenName}, ${user:familyName}).