This guide walks you through configuring SAML 2.0 Single Sign-On (SSO) between Microsoft Entra ID (formerly Azure Active Directory) and Atatus.

What You Will Need

Before you begin, verify that you have:
  • An Atatus account with the Owner or Admin role.
  • A Microsoft Entra ID tenant with permissions to manage Enterprise Applications (Cloud Application Administrator 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 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 Enterprise Application in Microsoft Entra ID

  1. Sign in to the Microsoft Entra admin center.
  2. In the left navigation, select Identity » Applications » Enterprise applications.
  3. Click New application.
Microsoft Entra New Application
  1. Click Create your own application.
  2. Enter a name for your application (for example, Atatus).
  3. Under What are you looking to do with your application?, select Integrate any other application you don’t find in the gallery (Non-gallery).
  4. Click Create.

Step 3: Configure SAML in Microsoft Entra ID

  1. In your newly created application, select Single sign-on from the left navigation.
  2. Select SAML as the single sign-on method.
  3. In the Basic SAML Configuration box, click the Edit icon (pencil).
Basic SAML Configuration
  1. Enter the Atatus Service Provider values:
    • Identifier (Entity ID): Paste your Atatus Account Id.
    • Reply URL (Assertion Consumer Service URL): Paste your Atatus SAML ACS URL.
  2. Click Save and close the panel.

Step 4: Configure SAML Attribute Mapping

  1. In the Attributes & Claims box, click the Edit icon.
  2. Verify that Unique User Identifier (Name ID) is configured with:
    • Name identifier format: Email address
    • Source attribute: user.userprincipalname (or user.mail)
  3. Add or edit user claims to supply the user’s name:
Configure claim names as plain names (email, firstName, lastName). Do not wrap them with namespace URLs, as Atatus resolves attributes strictly by their exact name.
  1. Click Save and close the panel.

Step 5: Assign Users and Groups in Microsoft Entra ID

Users cannot authenticate until they are assigned access in Microsoft Entra ID:
  1. In the application sidebar, select Manage » Users and groups.
  2. Click Add user/group.
  3. Under Users, click None Selected and select the users or security groups requiring Atatus access.
  4. Click Select, then click Assign.

Step 6: Download Metadata and Configure Atatus

  1. In Microsoft Entra ID, scroll down to section 3: SAML Certificates.
  2. Locate Federation Metadata XML and click Download to save the XML file to your computer.
Download Federation Metadata XML
Important Note on Certificate Rollover: Atatus requires that your Entra ID SAML configuration contains exactly one active signing certificate. If Microsoft Entra ID has two active signing certificates in its descriptor (such as during an uncommitted rollover), Atatus certificate validation will fail. When rotating certificates, generate the new certificate and remove or uncheck the secondary certificate before uploading your metadata file to 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 XML.
  3. Click Choose File (or Browse) and select the downloaded Federation Metadata XML file.
Upload Metadata XML in Atatus
  1. Click Save SSO.
  2. Ensure the Enabled toggle switch displays active.