Google OAuth 2.0 Integration Guide

This guide walks you through the process of integrating Google OAuth 2.0 authentication into your JFW brand. By following these steps, you can allow your users to sign in securely using their Google accounts.

Prerequisites

• A valid Google Cloud Console account with access to create OAuth credentials.

• An active Admin account with permission to manage App Integrations.

---

Step 1: Configure Google OAuth in Google Cloud Console

1. Go to Google Cloud Console.

2. Navigate to APIs & Services > Credentials.

3. Click Create Credentials > OAuth client ID.

4. Select Web application as the application type.

5. Provide a name (e.g., BoostPTE).

6. Under Authorized redirect URIs, add the following URI:

   https://protocol.jframework.io/api/v1/users/auth/app-integration/authenticate-urls

   ⚠️ This must match exactly, otherwise the authentication will fail.

7. Save and copy the following information:

   • Client ID

   • Client Secret

   • Project ID

Step 2: Configure Google Integration in Admin

1. Log in to your Admin.

2. Navigate to App Integration > Authentication.

3. Click Create (top-right corner).

4. Select Google as the provider.

5. Fill in the required fields:

   • Code – A unique code identifier for this integration.

   • Name – A display name for the integration.

   • Client ID – From Google Cloud Console.

   • Client Secret – From Google Cloud Console.

   • Project ID – From Google Cloud Console.

   • Scope – Define the Google OAuth scopes (e.g., openid profile email).

   • Redirect URI – Must be:

     https://protocol.jframework.io/api/v1/users/auth/app-integration/authenticate-urls

   • Description – Optional description for internal reference.

6. Set Status to Active if you want to use your custom configuration immediately.

   • If not active, JFW will automatically fallback to the system’s default configuration.

Step 3: Authentication Flow

1. When a user initiates login via Google, they will be redirected to Google’s OAuth 2.0 consent screen.

2. Upon successful authentication, Google redirects back to:

   https://protocol.jframework.io/api/v1/users/auth/app-integration/authenticate-urls

3. JFW processes the callback, establishes authentication, and then redirects the user to the callbackURL provided in your application via the API: Get App Integration Authenticate URLs