Google Workspace SSO

Sign in to ComplianceScout with Google Workspace.

OpenID Connect (OIDC)

Google's OIDC tokens cannot carry group membership. If you need to map Google groups to ComplianceScout roles, use the custom SAML app procedure at the bottom of this page instead.

Values to give Google Workspace

Copy these from ComplianceScout → Settings → SSO when you create the connection. The exact, per-connection values are shown there.

Redirect URI (Sign-in redirect URI / Allowed Callback URL)https://<your-app-host>/sso/oidc/callback/<connectionId>

Copy the exact value shown in ComplianceScout → Settings → SSO when you create the connection. Do not hand-type it — most IdPs require an exact match (case and trailing slash included).

Configure Google Workspace

Steps verified against the vendor documentation linked at the bottom of this page. Labels can change — that link is the source of truth.

  1. Sign in to the Google Cloud Console (console.cloud.google.com) with a project-admin account, and select or create the Google Cloud project that will own the credential.

  2. Configure the consent screen first: APIs & Services → OAuth consent screen (now branded Google Auth Platform → Branding). Set User type = Internal to restrict sign-in to your Workspace org, fill in the app name and support email, and save. You cannot create a client until this is done.

  3. Go to Google Auth Platform → Clients (equivalently APIs & Services → Credentials) and click Create client (older UI: Create credentials → OAuth client ID).

  4. Set Application type = Web application and give it a name.

  5. Under Authorized redirect URIs, click + Add URI and paste the Redirect URI exactly as shown in ComplianceScout → Settings → SSO. It must be https and match exactly. Click Create.

  6. Copy the Client ID and Client secret from the dialog.

Values to enter in ComplianceScout

Back in Settings → SSO, paste these into the connection and save.

Issuer URLhttps://accounts.google.com

Google's fixed OIDC issuer.

Client ID<client-id>
Client Secret<client-secret>

MFA pass-through (optional)

Enforce 2-Step Verification in the Google Admin console. Google does not emit a standard amr=mfa claim for all flows, so verify MFA pass-through against a real sign-in before relying on "Trust IdP for MFA".

Things to watch for

  • Google's OIDC ID token does NOT include a groups claim — group-based role mapping is not possible over OIDC. Use the SAML path below if you need it.
  • redirect_uri_mismatch is the most common error — copy/paste the redirect URI from ComplianceScout; case and trailing slash must match exactly.
  • Workspace accounts also receive an hd (hosted domain) claim; consumer @gmail.com accounts do not.

Alternative: custom SAML app (needed for group-based roles)

Because Google's OIDC tokens cannot carry group membership, the common enterprise pattern when you want Google groups → ComplianceScout roles is a custom SAML app in the Google Admin console. Configure ComplianceScout's connection as SAML for this path.

  1. Sign in to the Google Admin console (admin.google.com) as a super admin.

  2. Go to Menu → Apps → Web and mobile apps, and click Add app → Add custom SAML app.

  3. Enter an App name (for example, ComplianceScout) and click Continue.

  4. On the Google Identity Provider details page, click Download metadata (or copy the SSO URL and Entity ID and download the Certificate). Provide these to ComplianceScout's SAML connection. Click Continue.

  5. On Service provider details, enter the ACS URL and Entity ID that ComplianceScout shows for its SAML connection, and leave Name ID = Basic Information > Primary email (Name ID format = EMAIL). Click Continue.

  6. On Attribute mapping, use Group membership to send the user's groups as the attribute name ComplianceScout reads, then click Finish.

  7. Select the app → User access → On for everyone (or scope to an OU/group) → Save. Changes can take up to ~24 hours to propagate.

Ready to turn on Google Workspace SSO?

Configure the connection in Settings → SSO, then test sign-in before rolling it out to your team.