This guide walks you through configuring SAML 2.0 Single Sign-On (SSO) between Google Workspace 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 Google Admin console (Super Admin or administrator privileges to manage SAML apps).

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 SAML App in Google Workspace

  1. Sign in to the Google Admin console.
  2. From the Home page, navigate to Apps » Web and mobile apps.
  3. Click Add app, then select Add custom SAML app.
  4. In the App name field, enter Atatus.
  5. Click Continue.
Google Workspace Basic Info

Step 3: Download Google IdP Metadata

  1. In the Google Identity Provider details step, locate Option 1: Download IdP metadata.
  2. Click Download Metadata to save the Google IdP XML file to your computer.
Google Workspace Download Metadata
  1. Click Continue.

Step 4: Configure Service Provider Details in Google

  1. Enter the Atatus Service Provider details:
    • ACS URL: Paste your Atatus SAML ACS URL.
    • Entity ID: Paste your Atatus Account Id.
    • Start URL: Leave blank or enter https://app.atatus.com.
    • Signed response: Ensure this checkbox is checked.
  2. In the Name ID section:
    • Name ID format: Select EMAIL.
    • Name ID: Select Basic Information > Primary email.
Google Workspace Provider Details
  1. Click Continue.

Step 5: Configure SAML Attribute Mapping

Map the Google directory fields to the exact SAML attributes expected by Atatus:
  1. Click Add mapping.
  2. Configure the following attribute mappings:
Google Workspace Attribute Mapping
  1. Click Finish.

Step 6: Enable User Access in Google Workspace

By default, newly created SAML applications in Google Workspace are set to OFF for everyone. You must explicitly enable access:
  1. In the Google Admin console, open the newly created Atatus app details page.
  2. Click the User access card.
  3. Select ON for everyone (or turn it ON for specific Organizational Units / Groups).
  4. Click Save.
Changes to Google Workspace app access settings typically take effect within a few minutes, but can take up to 24 hours to propagate across all users.

Step 7: Upload Metadata and Configure 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 Google IdP metadata XML file downloaded in Step 3.
  4. Click Save SSO.
  5. Confirm that the Enabled toggle switch displays active.