Create an OpenID Connect app in Google, add the redirect URI from this setup, assign your users and enter the app’s issuer and credentials here.
The values in braces, such as {redirect_uri}, 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.
-
Create an OIDC app
Section titled “Create an OIDC app”In the admin console of Google, create a new OpenID Connect web application for this app: a confidential client that signs users in with the authorization code flow. Give it a name your users will recognize.
-
Add the redirect URI
Section titled “Add the redirect URI”Add
{redirect_uri}to the app’s sign-in redirect URIs, exactly as shown. A redirect URI that differs by one character is refused.Paste into Google:
- Redirect URI:
{redirect_uri}
Fixes:
oidc_token_exchange_failed - Redirect URI:
-
Allow the sign-in scopes
Section titled “Allow the sign-in scopes”Allow the openid, email and profile scopes, so the ID token carries the email, email_verified, given_name and family_name claims.
-
Send groups (optional)
Section titled “Send groups (optional)”To send groups, add a groups claim with the user’s group names to the ID token. Google does not send groups unless you add this claim.
-
Assign people to the app
Section titled “Assign people to the app”Assign the people or groups who should sign in to this app with single sign-on.
-
Copy the client ID and secret
Section titled “Copy the client ID and secret”Copy the app’s client ID and client secret into this setup. Keep the secret only here, and enter a new one in this setup whenever you rotate it.
Fixes:
oidc_token_exchange_failed -
Enter the issuer URL
Section titled “Enter the issuer URL”Enter the issuer URL in this setup. For Google it has the form “https://accounts.google.com”. We read the provider’s endpoints and keys from the issuer’s /.well-known/openid-configuration document.
-
Test the connection
Section titled “Test the connection”Run a test sign-in in this setup, signing in as a user you assigned to the app.
Sources
Section titled “Sources”- OpenID Connect Core 1.0, read on 2026-10-29
- OpenID Connect Discovery 1.0, read on 2026-10-29