Configuring Sign-In using Google

From WHMCS Documentation

This article is part of the Sign-In Integrations feature.

Purpose

Enabling the Google Sign In Integration enables visitors and customers to register, sign in and connect their Google accounts with your WHMCS installation for faster sign-up and automatic sign-in.

Signinintegrationslogin.png

Configuring Sign-In with Google

Watch Video Tutorial

There are 2 steps required to setup Sign-In with Google:

  1. Create a Google Developer Project and Retrieve API Credentials
  2. Activate Google Sign In within WHMCS

Create a Google Developer Project and Retrieve API Credentials

Google Sign In Integration requires a Google Developer Project and API Credential Set. You can create this using your existing Google account. Users will only see the App Name you define and not see anything relating to the account you use to create the project.

Be aware that the Google account under which you create the app can not be changed without requiring users to re-authenticate and re-link their accounts so it is important to set the app up under an account that you will always have access to.

1. Visit https://console.developers.google.com/
2. If not logged in, login to your Google account
3. Under the Project selector, choose Create project

Googlesignin1.png

4. Enter a Project Name and click Create (This name is private to you)

Googlesignin2.png

5. Next you will be taken to the project dashboard. From here, select Credentials in the left sidebar.

Googlesignin3.png

6. Before creating credentials, you must complete the OAuth consent screen configuration. Select this tab and enter a product name, homepage url and logo url (the name and logo you define here will be what users see when being asked to authorize access). Once complete, hit Save.

Googlesignin4.png

7. If not returned automatically, now return to the Credentials tab and select Create credentials > OAuth client ID.

Googlesignin5.png

8. On the following screen, choose Web application

Googlesignin6.png

9. Next you will be asked to provide a name for the credential set (this is not visible to the public) and the authorized JavaScript origins and redirect URIs. Enter your full root domain in both the authorized JavaScript origin and redirect URI boxes. In the example here we are using "https://demo.whmcs.com". Then hit Create.

Googlesignin7.png

10. Your Client ID and secret will then be displayed. These are the values you will need to activate Google Sign In within WHMCS so store these in a safe place.

Googlesignin8.png

You can now proceed to Activate Google Sign In within WHMCS.

Activate Google Sign In within WHMCS

  1. Login to the WHMCS Admin Area
  2. Navigate to Setup > Sign-In Integrations
  3. Select Activate under the Google heading
  4. Enter your Google Client ID and secret where requested
  5. Click Save & Activate

WHMCS will attempt to validate and test the details you have entered. If the Client ID and secret are valid and successfully authenticate with the Google API, the values will be saved and the modal will close.

Congratulations! Google Sign In is now enabled.

Troubleshooting

For troubleshooting help, please refer to Troubleshooting Sign-In using Google