Docs

Add Google as an EASIE connection

Enabling EASIE SSO with Google allows your users to sign up and sign in to your Clerk application with their Google account.

Configure for your development instance

For development instances, Clerk uses preconfigured shared credentials and redirect URIs—no other configuration is needed.

  1. In the Clerk Dashboard, navigate to the SSO connections page.
  2. Select Add connection and select For specific domains.
  3. Under EASIE, select Google as the identity provider.
  4. Add the Specific Domain that you want to allow this connection for. This is the domain of the users you want to allow to sign in to your app.
  5. Select Add connection.

Configure for your production instance

Warning

If you already configured Google as a social provider, you can skip this step. EASIE SSO will automatically use the credentials you configured for your social connection.

For production instances, you must provide custom credentials, which involves generating your own Client ID and Client Secret using your Google Developer account.

To make the setup process easier, it's recommended to keep two browser tabs open: one for your Clerk Dashboard and one for your Google Cloud Console.

Enable Google as an EASIE connection

  1. In the Clerk Dashboard, navigate to the SSO connections page.
  2. Select Add connection and select For specific domains.
  3. Below EASIE, select Google as the identity provider.
  4. Add the Specific Domain that you want to allow this connection for. This is the domain of the users you want to allow to sign in to your application.
  5. Ensure that Use custom credentials is toggled on.
  6. Save the Redirect URI somewhere secure. Keep this page open.

Create a Google Developer project

  1. Navigate to the Google Cloud Console.
  2. Select a project or create a new one.
  3. If the APIs & Services page isn't already open, open the menu on the left and select APIs & Services.
  4. In the menu on the left, select Credentials.
  5. Select Create Credentials. Then, select OAuth client ID. You may need to configure your OAuth consent screen.
  6. Select the appropriate application type for your project. Most likely, you will choose Web application.
  7. In the Authorized redirect URIs setting, paste the Redirect URI value you saved from the Clerk Dashboard.
  8. Select Create.

Set the Client ID and Client Secret in your Clerk Dashboard

Once the OAuth client is created in the Google Cloud Console, a modal will open with your Client ID and Client Secret. Save these values somewhere secure.

Go back to the Clerk Dashboard, where the modal should still be open, and paste these values into the respective fields. Note that if you have any other Google EASIE connections or a Google social connection, this will update the credentials for all of them. Select Add connection.

Feedback

What did you think of this content?

Last updated on