Set up social login with Google

The Google connector provides a succinct way for your application to use Google’s OAuth 2.0 authentication system.

tip:

In this guide, we assume you have basic knowledge of Logto Connectors. If you don't, check out the Configure connectors guide to get started.

Set up a project in the Google API Console

• Visit the Google API Console and sign in with your Google account.
• Click the Select a project button on the top menu bar, and click the New Project button to create a project.
• In your newly created project, click the APIs & Services to enter the APIs & Services menu.

Configure your consent screen

Configure and register your application

• On the left APIs & Services menu, click the OAuth consent screen button.
• Choose the User Type you want, and click the Create button. (Note: If you select External as your User Type, you will need to add test users later.)

Now you will be on the Edit app registration page.

Edit app registration

Config OAuth consent screen

• Follow the instructions to fill out the OAuth consent screen form.
• Click SAVE AND CONTINUE to continue.

Config scopes

• Click ADD OR REMOVE SCOPES and select ../auth/userinfo.email, ../auth/userinfo.profile and openid in the popup drawer, and click UPDATE to finish. It is recommended that you consider adding all the scopes you may use, otherwise some scopes you added in the configuration may not work.
• Fill out the form as you need.
• Click SAVE AND CONTINUE to continue.

Add test users (External user type only)

• Click ADD USERS and add test users to allow these users to access your application while testing.
• Click SAVE AND CONTINUE to continue.

Now you should have the Google OAuth 2.0 consent screen configured.

Obtain OAuth 2.0 credentials

• On the left APIs & Services menu, click the Credentials button.
• On the Credentials page, click the + CREATE CREDENTIALS button on the top menu bar, and select OAuth client ID.
• On the Create OAuth client ID page, select Web application as the application type.
• Fill out the basic information for your application.
• Click + Add URI to add an authorized domain to the Authorized JavaScript origins section. This is the domain that your logto authorization page will be served from. In our case, this will be ${your_logto_origin}. e.g.https://logto.dev.
• Click + Add URI in the **Authorized redirect URIs** section to set up the **Authorized redirect URIs**, which redirect the user to the application after logging in. In our case, this will be ${your_logto_endpoint}/callback/${connector_id}. e.g. https://logto.dev/callback/${connector_id}. The connector_id can be found on the top bar of the Logto Admin Console connector details page.
• Click Create to finish and then you will get the Client ID and Client Secret.

Configure your connector

Fill out the clientId and clientSecret field with Client ID and Client Secret you've got from OAuth app detail pages mentioned in the previous section.

scope is a space-delimited list of scopes. If not provided, scope defaults to be openid profile email.

prompts is an array of strings that specifies the type of user interaction that is required. The string can be one of the following values:

• none: The authorization server does not display any authentication or user consent screens; it will return an error if the user is not already authenticated and has not pre-configured consent for the requested scopes. You can use none to check for existing authentication and/or consent.
• consent: The authorization server prompts the user for consent before returning information to the client.
• select_account: The authorization server prompts the user to select a user account. This allows a user who has multiple accounts at the authorization server to select amongst the multiple accounts that they may have current sessions for.

Config types

Name	Type
clientId	string
clientSecret	string
scope	string
prompts	string[]

Enable Google One Tap

Google One Tap is a secure and easy way to let users sign in to your website or app with their Google account.

Once you have the Google connector set up, you'll see a card for Google One Tap in the connector details page. You can enable Google One Tap in your sign-up and sign-in pages by toggling the switch.

When you enable Google One Tap, you can configure the following options:

• Auto-select credential if possible: Automatically sign in the user with the Google account if certain conditions are met.
• Cancel the prompt if user click/tap outside: Close the Google One Tap prompt if the user clicks or taps outside the prompt. If disabled, the user must click the close button to dismiss the prompt.
• Enable Upgraded One Tap UX on ITP browsers: Enable the upgraded Google One Tap user experience on Intelligent Tracking Prevention (ITP) browsers. Please refer to this page for more information.

note:

To enable Google One Tap in your website (beyond the Logto sign-in experience), this feature is under development. Please stay tuned for updates.

References

Google Identity: Setting up OAuth 2.0