Start a conversation

Configuring OAuth 2 > G-Suite by Google

Overview

The article provides a step-by-step guide on setting up OAuth 2.0 integration in AdvocateHub, allowing users to sign in using their Google G-Suite accounts. It details the process of obtaining Client ID and Client Secret from the Google API Console, configuring the integration within AdvocateHub, and customizing the platform's appearance with logos and a custom display name for a seamless single sign-on experience.

 

Information

Gather data from your Google API Console

First thing we need to do is gather our Client ID and Client Secret which you can find in your Google API Console . Once you navigate to your console, choose Credentials from the menu on the left-hand side.

You will be greeted with an opportunity to Create Credentials , from this dropdown select OAuth client ID

Next, we create the Client ID . Here, under Application type you need to select 'Web application'. You can Name it whatever you like, I have used 'Influitive AdvocateHub in this example. And finally you need to set your Authorized redirect URI , this will be your hub URL followed by '/users/auth/custom_oauth2/callback'. Click Create to save.

Now you will be presented with your Client ID and Client Secret which you will need to copy into your hub in our next steps

 

Finalize configuration in AdvocateHub

At this point we need to go back to your AdvocateHub and essentially just plug in some information that I will outline below. Find our OAuth integration under Integrations > Custom OAuth Provider and open the Setup tab, you should see a list of empty fields like this:

Let's fill out this information:

Client ID Paste in the Client ID we retrieved from your Google API Console in the earlier steps
Client Secret Paste in the Client Secret we retrieved from your Google API Console in the earlier steps
Endpoint https://accounts.google.com
Token URL https://accounts.google.com/o/oauth2/token
Authorize URL https://accounts.google.com/o/oauth2/auth
Fetch User Path https://www.googleapis.com/oauth2/v1/userinfo?alt=json
Scope profile email
Ignore OAuth2 State Leave box unchecked
UID Lookup id
Name Lookup name
Email Lookup email
URL Lookup Leave blank
Image Lookup picture

 

Add final cosmetic touches

At this point everything should be functioning correctly but we can add a name and some logos which will make the experience look perfect. We need to be on the same page where we entered the information above. Scroll to the bottom of this page and under Misc. other stuff you will find a place to upload an image and a logo as well as a Display Name . There are many variations of the Google logo that you can use, you can either get these directly from Google or search for the images online.

If you have dual login enabled then the Advocate will see something like this when they navigate to the AdvocateHub.

If you have OAuth Single Sign On enabled you will skip the Influitive Sign In page altogether and be brought straight to a Google page where you can enter your Google credentials.

 

FAQ

How do I obtain the Client ID and Client Secret for setting up OAuth 2.0 with G-Suite?

You can obtain the Client ID and Client Secret by accessing your Google API Console, selecting 'Credentials' from the menu, creating credentials via the 'OAuth client ID' option, and completing the setup process.

Can I customize the appearance of the OAuth sign-in page on my AdvocateHub platform?

Yes, you can customize the appearance by uploading a custom image, logo, and setting a display name in the 'Misc. other stuff' section of the OAuth integration setup page in AdvocateHub.

What happens if dual login is enabled for AdvocateHub?

If dual login is enabled, advocates will see an option to sign in either through the Influitive Sign In page or directly via Google when accessing the AdvocateHub.

Is OAuth 2.0 integration available for all plans in AdvocateHub?

OAuth 2.0 integration may not be available in all plans. It is recommended to contact your Advocacy Coach to learn more about the availability and implementation in your specific plan.

Choose files or drag and drop files
Was this article helpful?
Yes
No
  1. Priyanka Bhotika

  2. Posted 2 months ago

Comments