Nailing the Security Audit with RRCU

ConductorOne docs

Set up a Google Workspace v2 connector

ConductorOne provides identity governance and just-in-time provisioning for Google Workspace. Integrate your Google Workspace instance with ConductorOne to run user access reviews (UARs) and enable just-in-time access requests.

This is an updated and improved version of the Google Workspace integration! If you’re setting up a Google Workspace integration with ConductorOne for the first time, you’re in the right place.

Capabilities

  • Sync user identities from Google Workspace to ConductorOne

  • Resources supported:

    • Groups
    • Roles

  • Provisioning supported:

    • Group membership
    • Role assignment

Add a new Google Workspace connector

This task requires either the Connector Administrator or Super Administrator role in ConductorOne.

  1. In ConductorOne, click Connectors > Add connector.

  2. Search for Google Workspace v2 and click Add.

  3. Choose how to set up the new Google Workspace connector:

    • Add the connector to a currently unmanaged app (select from the list of apps that were discovered in your identity, SSO, or federation provider that aren’t yet managed with ConductorOne)

    • Add the connector to a managed app (select from the list of existing managed apps)

    • Create a new managed app

  4. Set the owner for this connector. You can manage the connector yourself, or choose someone else from the list of ConductorOne users. Setting multiple owners is allowed.

    A Google Workspace connector owner must have the following permissions:

    • Connector Administrator or Super Administrator role in ConductorOne
    • Super Admin role in Google Workspace
  1. Click Next.

Next steps

  • If you are the connector owner, proceed to Configure your Google Workspace connector for instructions on integrating Google Workspace with ConductorOne.

  • If someone else is the connector owner, ConductorOne will notify them by email that their help is needed to complete the setup process.

Configure your Google Workspace connector

A user with the Connector Administrator or Super Administrator role in ConductorOne and Super Admin role in Google Workspace must perform this task.

Step 1: Sign in to the Google Cloud Console and Create a New Project

  1. As a Google Workspace Super Admin, sign in to https://console.cloud.google.com.

  2. In the toolbar, click the project select dropdown, and click NEW PROJECT.

  3. Create a new project for your organization:

    • Project Name: Choose a names, such as “ConductorOne Integration”
    • Organization/Location: Choose the appropriate Organization/Location

  4. After the project is created, make sure the correct project is selected in the dropdown at the top.

Step 2: Enable the API

  1. In the navigation menu, navigate to > APIs & Services > Library.

  2. Search for and select the Admin SDK API.

  3. Click Enable.

Step 3: Create a service account

  1. In the navigation menu, navigate to > APIs & Services > Credentials.

  2. Select CREATE CREDENTIALS > Service Account.

  3. Under Service account details, fill in the following:

    • Service account name: ConductorOne Integration
    • Service account description: for example, “Service account for ConductorOne Google Workspace Integration”
    • Click CREATE AND CONTINUE

  4. Under Grant this service account access to a project, grant the Editor role.

  5. Leave Grant users access to this service account blank.

  6. Click DONE.

Step 4: Get credentials

  1. Navigate back to APIs & Services > Credentials and select the service account you just created.
  1. Click the service account’s email address. Locate and save the Unique ID. We’ll use this in Step 5.
  1. On the Service Account Details Page, click KEYS.
  1. Click ADD KEY > Create new key.
  1. Choose JSON and click CREATE.
  1. Keep the downloaded file safe. We’ll use it in Step 7.

Step 5: Add Service Account to Google Workspace

  1. Go to https://admin.google.com as a SUPER ADMIN.

  2. In the navigation menu, select Security > Access and data control > API Controls.

  3. Click MANAGE DOMAIN WIDE DELEGATION.

  1. Click Add new and fill out the form:

    • Client ID: The saved ID from Step 4

    • OAuth Scopes: Copy and paste in the relevant scopes

      • Use the following scopes if you are NOT using the Google Workspace integration for provisioning:

        https://www.googleapis.com/auth/admin.directory.user.alias.readonly,https://www.googleapis.com/auth/admin.directory.rolemanagement.readonly,https://www.googleapis.com/auth/admin.directory.group.member.readonly,https://www.googleapis.com/auth/admin.directory.group.readonly,https://www.googleapis.com/auth/admin.directory.user.readonly,https://www.googleapis.com/auth/admin.directory.domain.readonly,https://www.googleapis.com/auth/admin.reports.audit.readonly

      • Use the following scopes if you are using the Google Workspace integration for provisioning Groups and Roles:

        https://www.googleapis.com/auth/admin.directory.user.alias.readonly,https://www.googleapis.com/auth/admin.directory.rolemanagement,https://www.googleapis.com/auth/admin.directory.group.member,https://www.googleapis.com/auth/admin.directory.group,https://www.googleapis.com/auth/admin.directory.user.readonly,https://www.googleapis.com/auth/admin.directory.domain.readonly,https://www.googleapis.com/auth/admin.reports.audit.readonly

  2. Click AUTHORIZE.

  3. In the navigation menu, select Account > Account Settings.

  4. Copy the Customer ID from this page. We’ll use it in Step 7.

Step 6: Locate your Primary Domain

  1. In the navigation panel on the left, click Account > Domains.

  2. Click Manage Domains. Locate and copy the domain labeled as the Primary Domain in the Type column. We’ll use this in Step 7.

Step 7: Add your Google Workspace credentials to ConductorOne

  1. In ConductorOne, navigate to the Google Workspace connector by either:

    • Clicking the Set up connector link in the email you received about configuring the connector.

    • Navigate to Connectors > Google Workspace v2 (if there is more than one Google Workspace v2 listed, click the one with your name listed as owner and the status Not connected).

  2. Find the Settings area of the page and click Edit.

  3. In the Customer ID field, enter the customer ID from Step 5.

  4. In the Domain field, enter the primary domain from Step 6.

  5. In the Administrator email field, enter the email address associated with your domain or a super admin.

  6. In the Credentials (JSON) area, click Choose file and upload the file from Step 4.

  7. Click Save.

  8. The connector’s label changes to Syncing, followed by Connected. You can view the logs to ensure that information is syncing.

That’s it! Your Google Workspace connector is now pulling access data into ConductorOne.

What’s next?

If Google Workspace is your company’s identity provider (meaning that it is used to SSO into other software), the integration sync will automatically create applications in ConductorOne for all of your SCIMed software. Before you move on, review the Create applications page for important information about how to set up integrations with the SCIMed apps.

Configure the Google Workspace integration using Terraform

As an alternative to the integration process described above, you can use Terraform to configure the integration between Google Workspace and ConductorOne.

See the ConductorOne Google Workspace v2 integration resource page in the ConductorOne Terraform registry for example usage and the full list of required and optional parameters.