Skip to Content

Google OAuth 2.0

Introduction

Harmony supports single sign-on (SSO) with Google using OAuth 2.0. This page shows how to set up and test Harmony SSO with Google by following these steps:

  1. Configure SSO in Google API Console
    Configure a Google project and obtain the Client IDs and Client Secrets that you will need to use as input for configuring SSO in Harmony.
  2. Configure SSO in Harmony
    Configure and test Google as the SSO provider in the Harmony Portal. You will need to use the Client IDs and Client Secrets obtained in the previous step.

After SSO is configured in both Google and Harmony, members of your Harmony organization will be able to use their Google credentials to log in to Harmony.

For additional information, see the Google API Console Help topic Manage APIs.

Demonstration

1. Configure SSO in the Google API Console

Follow these steps to create a Google project and obtain the Google client ID and client secret needed for configuring SSO in Harmony:

  1. Log in to the Google API Console.

    Caution

    In order to set up Harmony SSO, your Google email address must match your Harmony email address. This applies to the members of your Harmony organization as well, unless they are configured to bypass SSO and instead use their Harmony credentials (see Configure SSO in the Management Console).

  2. In the Google API Console, from the Dashboard, click Create Project.

  3. On the New Project screen, enter a Project name. You can create both Harmony clients within the same project, so you can — for example — name the project Jitterbit. If required, select an appropriate Organization and Location. Then click Create:

    attachment

  4. Go to the project's OAuth consent screen tab and select External. Then click Create:

    attachment

  5. Within the resulting OAuth consent screen configuration area, provide an App name (for example, Harmony) and complete the required contact information. Any further configuration beyond the defaults is optional. Click Save and Continue.

  6. Go to the project's Credentials tab to configure the credentials for these Harmony clients:

    • WMC: This Harmony client is for the Harmony Portal and its applications.

      Note

      Although the user interface refers to WMC (the former name for the Management Console), the WMC Harmony client configuration applies to all of the web-based products accessible via the Harmony Portal.

    • Studio: This Harmony client is for Design Studio. An app for this client must be created, even if you do not intend to use Design Studio.

    For each Harmony client:

    1. Click Create Credentials and use the dropdown to select OAuth client ID.

    2. Select an Application type of Web application.

    3. Provide a Name (for example, Harmony Portal or Design Studio).

    4. Under Authorized redirect URIs, click Add URI and enter the URIs appropriate for your Harmony region (see Finding My Region):

      • WMC:

        • NA: https://na-east.jitterbit.com/jitterbit-cloud-mgmt-console/oauth
        • EMEA: https://emea-west.jitterbit.com/jitterbit-cloud-mgmt-console/oauth
        • APAC: https://apac-southeast.jitterbit.com/jitterbit-cloud-mgmt-console/oauth
      • Studio:

        • NA: https://na-east.jitterbit.com/jitterbit-cloud-mgmt-console/login/studio/callback
        • EMEA: https://emea-west.jitterbit.com/jitterbit-cloud-mgmt-console/login/studio/callback
        • APAC: https://apac-southeast.jitterbit.com/jitterbit-cloud-mgmt-console/login/studio/callback
  7. On clicking Create, the OAuth client ID and client secret will be provided. Retain these for later use, as they will be required when configuring SSO in Harmony.

2. Configure SSO in Harmony

Follow the instructions for Configure SSO in the Management Console. When entering information into the Edit Organization SSO Provider Info screen, use the values obtained above for each Harmony client:

  • Client ID: Paste the Google OAuth Client ID.
  • Client Secret: Paste the Google Client Secret.

attachment

Click Test Configuration for each Harmony client and then click Save. Both clients need to be successfully tested before the Save button becomes enabled.