Google

Setting Up a Google Integration

Learn how to seamlessly configure Google social login integration within your Wristband dashboard using this step-by-step guide.

Step 1: Locate Your External IdP Redirect URL

• In the Wristband dashboard, enter Application View for the application you want to integrate with Google.
• Navigate to the Identity Providers > Social menu in the side navigation.
• After landing on the Social Identity Providers page, select the Google provider icon at the top.
• Copy the "Redirect URL" from the form - you'll need this value to configure the OAuth client in Google Cloud.

Step 2: Sign Up/Login to Your Google Account

1. Log into your Google account at the Google Cloud Developer Console.
2. Create an OAuth client to finish configuring the Google Social Login Identity Provider in your Wristband dashboard.

Step 3: Create a New Project

1. In the console, click the Create Project button.

2. This will establish the project where your OAuth client lives.

1. Enter a project name and select your organization (this defaults to No organization if none is selected). Then, click Create to proceed.

Step 4: Configure the OAuth Consent Screen

1. On the "APIs & Services" page, select OAuth consent screen from the left side menu.

2.Then click the Get Started button.

3. Fill out the following mandatory fields:

• App name: Any appropriate value.
• User support email: Any appropriate value.

4. For the audience, select the External option.

5. Provide contact information.

6. Agree to "Google API Services: User Data Policy".

7. Click the Create button.

Step 5: Configure Branding

1. Select Branding from the left navigation menu.
2. Add your logo and input the links for your website, privacy policy, and terms of service.
3. Add the domains of any links you configure to the Authorized domains list.

Step 6: Create OAuth Client

1. Complete the consent screen configuration to return to the OAuth Overview page.
2. Click the Create OAuth client button to generate the credentials needed for Wristband.

You will now be in the Clients section. Here, you will need to select the application type for your client.

1. In the Clients section, select the appropriate Application type for your OAuth client.

2. Fill out the following mandatory fields:

• Application type: Web application
• Name: Any appropriate value.
• Authorized redirect URIs: Use the External IdP Redirect URL copied from step 1.
• Click the Create button.

A modal will open displaying your Client ID and Client secret. Make sure to copy both values immediately, as you will need them for the next step.

You have now configured everything necessary on Google's side for social login integration.

Step 7: Configure the Google IdP in Wristband

1. Return to the Wristband dashboard to the Social Identity Provider Page from step 1. Fill out the form with the following values:
   • Client ID: The Client ID from step 6.
   • Client Secret: The Client secret from step 6.
2. Adding extra scopes is optional and usually unnecessary. By default, the authorization request to Google always includes the following scopes:
   • email
   • openid
   • profile

3. Click Save to finish.

You have successfully enabled Google social login for your application. When users reach your tenant-level Login Page, they will now see a Sign in with Google button, as illustrated below.