Add Google as a social login provider

Prerequisites

A Google Cloud project with OAuth consent screen configured.
An Ionize deployment.

Step 1: Create the Google OAuth2 client

Go to Google Cloud Console → APIs & Services → Credentials.
Click Create Credentials → OAuth client ID → Web application.
Authorized redirect URIs: https://ciam.<your-domain>/self-service/methods/oidc/callback/google.
Save. Note the Client ID and Client Secret.

Step 2: Configure Kratos

Edit platform/prod/ciam-kratos/kratos.yml:

selfservice:
  methods:
    oidc:
      enabled: true
      config:
        providers:
          - id: google
            provider: google
            client_id: <google-client-id>
            client_secret: <google-client-secret>
            mapper_url: file:///etc/config/kratos/oidc.google.jsonnet
            scope:
              - openid
              - email
              - profile
            requested_claims:
              id_token:
                email:
                  essential: true
                email_verified:
                  essential: true

Create platform/prod/ciam-kratos/oidc.google.jsonnet:

local claims = std.extVar('claims');
{
  identity: {
    traits: {
      email: claims.email,
      [if 'given_name' in claims then 'name' else null]: {
        first: claims.given_name,
        last: claims.family_name,
      },
    },
  },
}

Step 3: Surface in Dashboard

Ionize's Dashboard → Social Connections lets operators enable/disable providers without redeploying:

Open Dashboard IAM.
Navigate to Social Connections.
Click + Add Provider → Google.
Paste Client ID and Client Secret.
Check Enabled.
Save.

Dashboard writes the settings to the ionize settings vault (encrypted via SDK). The Auth login page reads from the vault and renders the Google button.

See Identity, Social connections (admin) for the admin flow detail.

Step 4: Test

Open https://ciam.<your-domain>/login.
Click Continue with Google.
Google's consent page appears.
Approve.
Land back at the configured return_to (defaults to /).

A new Kratos identity is created with the OIDC credential linked.

Things to verify

Kratos's email_verified claim from Google is not trusted, Kratos runs its own verification flow on first link. See Security, OIDC email_verified trust.
If a user with the Google email already has a password identity in Ionize, they'll see an account-linking confirmation screen (see Identity, Account linking).