Skip to main content

Google

Set up Google as a social login provider in SecureAuth Connect so users can sign in with their Google account.

Register Google as a provider

  1. In your workspace, go to Authentication > Providers.

  2. Click Create Connection.

  3. Filter by Social Providers and select Google. Create Connection page showing available social providers

  4. Choose a registration mode:

    ModeDescription
    EmbeddedUses a client application registered by SecureAuth. No developer portal registration required.
    Bring your OwnUses a client application registered by your organization. Requires registering an application in the Google Cloud Console to obtain a Client ID and Client Secret.

    Google Configuration tab showing Embedded mode and Display order

Configuration

SettingDescription
NameDisplay name for this provider. Default: Google.
Display orderControls the position of this provider on the sign-in page. Default: 0.

Use Try Sign-in to test the Google sign-in flow. Use Delete Identity to remove this provider.

Google sign-in page shown when testing with Try Sign-in

Attributes

Google returns the following attributes after authentication:

Connector nameFriendly nameData typeScope
subSubjectStringID token
audApp's Application IDStringID token
issIssuerStringID token
iatIssue timeNumberID token
expExpiration timeNumberID token
emailEmailStringID token
email_verifiedEmail verifiedBooleanID token
nameNameStringID token
given_nameGiven nameStringID token
family_nameFamily nameStringID token

Google returns the most attributes of any social provider, including token metadata (sub, aud, iss, iat, exp) and email_verified to confirm whether the user's email address has been verified by Google.

To add custom attributes, click + Add attribute.

Mappings

Default attribute mappings from Google to the SecureAuth authentication context:

SourceGoogle source nameSecureAuth target name
ID tokenSubjectSubject
ID tokenNameName
ID tokenEmailEmail
ID tokenFamily nameFamily name
ID tokenGiven nameGiven name

To customize, click + Add mapping or + Add static mapping.

Provisioning

Provisioning controls what happens when a user authenticates through Google.

Disabled

Users are not persisted in the user store. Authentication succeeds but no user record is created.

Just-in-Time Provisioning

Users are persisted in the user store on first login.

Identifier Correlation
Maps the incoming Google identity to an existing user. Default: Google Email ↔ Users Email.

Attribute Provisioning
Maps Google attributes to user profile fields. Defaults:

  • EmailEmail
  • Given nameFirst name
  • Family nameLast name

Provisioning tab with Just-in-Time Provisioning selected, showing Identifier Correlation and Attribute Provisioning

Pre provisioning mode

Users must already exist in the user store before they can authenticate. New users are not auto-created at login; they must be added via an offline process.

Authentication flow control
Select what happens when no matching user is found:

  • Deny – Terminate the authentication flow.
  • Allow – Proceed with the authentication flow.

Identifier Correlation
Maps the incoming Google identity to an existing user. Default: Google Email ↔ Users Email.

Attribute Provisioning
Maps Google attributes to user profile fields. Defaults:

  • EmailEmail
  • Given nameFirst name
  • Family nameLast name

Provisioning tab with Pre provisioning mode selected, showing Authentication flow control and Attribute Provisioning

Extensions

ExtensionDescription
Post Authentication scriptA server-side script that runs after Google authentication completes. Click Manage Script to configure.
Post Authentication applicationA custom application that receives a callback after Google authentication completes. Click Manage Custom App to configure.

See also