Skip to main content

Configure Google OAuth

This guide walks CreditChek administrators through configuring Google OAuth (Google Workspace / G Suite) as an authentication provider, allowing users to sign in with their organizational Google credentials.

Prerequisites​

Before you begin, ensure you have:

  • A Google Workspace (G Suite) admin account
  • A fully qualified domain name (FQDN) for your application (e.g. yourcompany.com)
  • Admin SDK API enabled for your Google Workspace domain
  • Admin access to your CreditChek dashboard

Setup in Google Cloud Console​

Step 1: Authorize Your Domain​

  1. Go to the Google Cloud Console and open your project.
  2. Navigate to APIs & Services > OAuth consent screen.
  3. Add your application's top-level domain to the Authorized domains list.
  4. Confirm the following scopes are enabled:
    • email
    • profile
    • openid
  5. Click Save and Continue.

Step 2: Generate OAuth2 Credentials​

  1. Go to APIs & Services > Credentials.
  2. Click Create Credentials > OAuth client ID.
  3. Select Web application as the application type.
  4. Under Authorized JavaScript origins, add Creditchek application URL (e.g. https://app.creditchek.africa).
  5. Under Authorized redirect URIs, add callback URL: 
    https://app.creditchek.africa/auth/google/callback
  6. Click Create and download the credentials as a JSON file — you will need this later.

Configure CreditChek with Google OAuth​

In your CreditChek dashboard, navigate to Settings > ExternalIDP > Google OAuth and provide the following:

FieldDescription
Admin EmailYour Google Workspace administrator email address
DomainYour exact Google Workspace domain (not aliases, e.g. yourcompany.com)
OAuth CredentialsUpload or paste the details required from the JSON file downloaded in Step 2

Once all fields are filled in, click on Configure to activate Google OAuth for your CreditChek integration.

Verification​

After enabling, test the flow by signing in with a Google Workspace account. Confirm:

  • Invite a user that is within your google domain / workspace
  • They can access the dashboard through Google's login page by clicking on Continue with Google
  • After authentication, the user is redirected to your business' CreditChek dashboard

For support, contact us at [email protected].

Last updated on