Overview

Google OAuth 2.0 is a robust and widely-adopted authentication and authorization framework that enables users to securely access a variety of applications and services using their Google credentials. This system simplifies user authentication by delegating the authentication process to Google, which is a trusted and familiar identity provider. When a user logs into an application using Google OAuth 2, they don't need to create a new account or remember additional login credentials, enhancing the user experience.

The process involves the user granting permission to the application to access their Google data, specifying the level of access or permissions (known as scopes). Google OAuth 2 ensures security through the use of access tokens, which are short-lived and can be refreshed, enhancing both data security and user privacy. Additionally, it supports single sign-on (SSO), allowing users to use their Google account for multiple applications, reducing password fatigue and simplifying access management.

 

Integration

Integrating Google OAuth 2.0 with Acadio is a streamlined process that can be completed in approximately 15 minutes.

  1. Log into your Google account and navigate to the Google Cloud Platform Console.
  2. From the Google Cloud Platform Console, select "APIs & Services" from the left-hand menu.
  3. From the "APIs & Services" page, select "Credentials" from the left-hand menu.
  4. From the "Credentials" page, select "Create Credentials" and then select "OAuth client ID" from the drop-down menu.
  5. From the "Create OAuth client ID" page, select "Web application" as the application type.
  6. Enter a name for your application.
  7. * Enter the following URL as the "Authorized Javascript Origins":
    • https://{your domain}.acadio.com
    • https://admin.acadio.com
    • (Optionally) Custom hosted domain
  8. * Enter the following URL as the "Authorized redirect URI":
    • https://{your domain}.acadio.com/auth/callback/google-oauth
    • https://admin.acadio.com/auth/callback/google-oauth
    • (Optionally) Custom hosted domain
  9. Click "Create" to proceed.
  10. From the "Credentials" page, locate the OAuth 2.0 Client IDs section and click on the download icon to download the client secret JSON file.
  11. Log into your Acadio Admin portal and navigate to the Settings section. From there, select "Apps" to proceed.
  12. Locate the Google OAuth 2.0 app within the Apps section and initiate the installation process by clicking on the "Install App" button.
  13. Enter in the Client ID and Client Secret from the JSON file you downloaded from the Google Cloud Platform Console and save.

Once saved, the Google OAuth 2.0 app will be installed and available for use. Please note that the Google OAuth 2.0 app is only available to authenticated registered users.

* Important the Authorized Javascript origins and redirect URIs are required for the integration to work, please enter these values exactly as they appear above.

If you need assistance setting up your Google OAuth 2.0 integration please contact us.

 

Disconnect

To disconnect Google OAuth from Acadio simply navigate to the Settings section and deactivate the installed Google OAuth app.