Skip to main content

Setup user authentication with Google

This article provides a quick start guide for adding Google Login to Authress, so that your users can use Google Login to authenticate into your software.


If you are looking to enable admin login access into the Authress Management Portal using your corporate IdP see the Authress Management Portal SSO Configuration.

In this guide we’ll use Google login as an example of how to connect. Setting up authentication requires the following parts:

  1. Authress-Google OAuth configuration
  2. New application setup
  3. Testing the configuration

Google OAuth configuration

Select the first login provider you wish to integrate. For this example we’ll pick Google.

Google login buttons

  1. Enable the Google preconfigured connection.
  2. Navigate to the Google Cloud Platform and create a new OAuth client ID. (Note: you will already need an existing GCP project for this to work. If you don't have one, you can create one now. They are free.)

Google OAuth Client creation

  1. Specify the Application type to be Web Application, and specify the Name to be Authress.

  2. Then add the following based on your Authress Custom Domain, replacing the below with your custom domain:


    If you aren't sure what your Authress Custom Domain is, checkout your Custom Domain configuration in the Authress Management Portal.

Google Admin create connection

  1. Obtain the OAuth Client ID and Client Secret from your Google Developer dashboard.
  2. Paste the Client ID and Client Secret from Google to your Authress Connection

Google Admin oauth connection credentials

  1. [Optional] Update the OAuth consent screen with your application’s information.

Google Admin oauth consent screen

Validate the configuration

Now the setup is complete and you are ready to test connection. You can test the connection in the Authress Connection configuration by clicking Test Connection:

Test Connection in Authress

When everything is configured correctly you'll see the test login success screen:

Correct Google login configuration in Authress