Skip to content
Dashboard
Theme
Theme

Google Workspace SAML single sign-on

Set up SAML single sign-on with Google Workspace

View Markdown

Add a custom SAML app in the Google Admin console, paste the values from this setup, turn the app on for your users and share Google’s metadata with us.

The values in braces, such as {acs_url}, are specific to your connection. The setup link from the application you are connecting shows them with a copy button. The same steps appear there.

  1. Sign in to the Google Admin console as a super administrator. Go to Menu > Apps > Web and mobile apps, select Add App > Add custom SAML app, enter an app name and select Continue.

  2. On the Google Identity Provider details page, download the IdP metadata and add it to this setup, then select Continue. Do this again whenever the certificate changes.

    Fixes: saml_signature_invalid, saml_issuer_mismatch

  3. On the Service provider details page, paste {acs_url} into ACS URL.

    Paste into Google Workspace:

    • ACS URL: {acs_url}

    Fixes: saml_destination_mismatch, saml_response_malformed

  4. Paste {sp_entity_id} into Entity ID.

    Paste into Google Workspace:

    • SP entity ID: {sp_entity_id}

    Fixes: saml_audience_mismatch

  5. Set Name ID format to EMAIL and Name ID to Basic Information > Primary email, then select Continue. Leave Signed response as it is unless your app’s support asks you to change it.

    Fixes: saml_nameid_missing

  6. On the Attribute mapping page, select Add mapping and map Primary email to email, First name to firstName and Last name to lastName. To send groups, add them under Group membership with the app attribute groups. Select Finish.

    Fixes: saml_email_missing

  7. Open the app, select User access, choose On for everyone (or turn it on for the right organizational units) and select Save.

    Fixes: saml_idp_status_error

  8. Run a test sign-in in this setup, signing in as a user the app is turned on for. Changes in Google can take a little while to apply.

Google Workspace accepts a single ACS URL per custom SAML app, so this connection cannot use the standby address. In the rare case of an outage of our main network, sign-ins pause until it ends. There is nothing to set up.

This step is optional. See standby route behavior for what the standby address does during an outage.