Optionally provide private feedback to help us improve this article...

Thank you for your feedback!


Enabling Google Login within InstantForum

New

This article only applies to InstantForum 2017 and above. Earlier versions of InstantForum used an earlier version of OAuth provided by Google which did not require any configuration or set-up. This older version has since been deprecated by Google and it's advised you take advantage of the newer support provided within InstantForum 2017 and above. To help you get started we'll walk you through how to configure InstantForum to use the newer OAuth support provided by Google below.

Configuring Google Login within InstantForum 2017

You'll first need to navigate to the Google APIs console at https://console.developers.google.com/apis/

From here you'll need to create a new API project. Click the drop down list alongside the Google APIs logo as shown below...

Clicking the drop down will display a list of all your existing Google API projects and will more importantly for this example allow you to create new API projects. You will need to use the plus (+) button as shown below to create a new project...

You will be prompted to provide a name for your project. This name will not be displayed to regular end users and is only used by you to identify your Google API projects within the Google APIs dashboard. For this example we'll call our project InstantForum Demo Community as shown below...

Click Create to create your Google API project.

We now need to fill out some basic information about your new project. This information will be displayed to regular end users when they attempt to login via Google from your InstantForum installation. This is generally known as the consent screen where Google will ask the end user if they trust your application. To complete the consent screen information you'll need to ensure your project is selected, then click Credentials in the left hand navigation pane and then click the OAuth Consent Screen tab as shown below. You'll need to provide your product name and other basic information...

Once complete click Save to update your project. We can now create the OAuth client ID required by InstantForum to allow users to login via Google.

Next we'll need to generate a Google OAuth client ID. You'll need to ensure your project is selected and click Credentials on the left within the Google APIs console. Click Create Credentials and choose the OAuth client ID option as shown below...

You will now be prompted to select the application type and provide additional optional information. You should select the "Web application" option. You can leave the NAme as is (this is only shown to you) however you must ensure you enter your InstantForum installation URL for the "Authorized JavaScript origins" field. For example http://www.yourcompany.com/forums or http://forums.yourcompany.com

Once you click save you will be presented with your final OAuth client ID. This is the string you will need to copy and paste into the Instantforum Admin CP. Copy your OAuth client ID into your clip board as shown below...

You'll now need to visit your InstantForum Administrator Control Panel within your web browser. From within the InstantForum Admin CP expand Settings on the left and select "Login & Registration". Locate the Google Client ID field and paste your OAuth Client ID here as shown below...

Save your changes. You have now successfully configured Google Login within InstantForum.

Testing Google Login

With the Google OAuth Client ID now saved within your InstantForum setting you'll notice when you attempt to login again you'll see a new Google login button as shown below. Clicking this button will take you through the OAuth authentication flow with Google.

That's It!

We hope this article has helped you successfully configure Google Login within your InstantForum installation. If we can assist with any additional questions of course please don't hesitate to submit a new support request or use our contact form.