Set up a Google Cloud Platform connector

Which Google connector should I use? Each of the Google connectors offered by ConductorOne varies in what it can sync and what it can provision. Selecting the right connector for you will depend on which Google services your organization uses, and how you want to manage Google resources within ConductorOne.

• Google Cloud Platform can sync accounts, projects, roles, and orgs. It can provision projects.

• Google Workspace can sync accounts, groups, and roles. It can provision groups and roles.

• Google Cloud Platform with Google Workspace can do all of the above, and it combines all of the resources and entitlements of the two connectors into a single app within ConductorOne.

Running separate connectors can simplify management and make the apps easier to understand and work with, while the combined app unifies resource management and allows Google Cloud to leverage existing Google Workspace groups for authorization.

Capabilities

The GCP connector does not sync roles that do not have any grants. As each GCP project contains roughly 1,000 roles by default, removing empty roles from the sync significantly improves the performance of the connector and the usability of the entitlement data it pulls into ConductorOne. If you want to include an empty GCP role in your access review, assign a service account to the role before creating the campaign.

Gather Google Cloud Platform credentials

Configuring the connector requires you to pass in credentials generated in Google Cloud Platform. Gather these credentials before you move on.

A user with the permission to make a service account in Google Cloud Platform must perform this task.

Create a new project

1. In the Google Cloud console, click the project select dropdown, then click NEW PROJECT.

   

   

2. Create a new project for your organization:

   • Project Name: Choose a name such as “ConductorOne Integration”
   • Organization/Location: Choose any organization and location

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

Enable APIs

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

2. Search for and select the following APIs:

   • Identity and Access Management (IAM) API
   • Cloud Resource Manager API
   • Cloud Asset API
   • Admin SDK API

   

3. Click Enable.

   

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 Cloud Platform Integration”

4. Click CREATE AND CONTINUE.

5. Under Grant this service account access to a project, grant the appropriate permission level:

   • Viewer to run access reviews on your Google Cloud Platform users
   • Editor to provision access via ConductorOne and run access reviews

   Alternatively, you can create and assign a custom role on the org level:

   You’ll need these permissions to give ConductorOne READ access (for syncing access data):

   cloudasset.assets.analyzeIamPolicy
   cloudasset.assets.searchAllIamPolicies
   cloudasset.assets.searchAllResources
   iam.roles.get
   resourcemanager.folders.getIamPolicy
   resourcemanager.folders.list
   resourcemanager.organizations.get
   resourcemanager.organizations.getIamPolicy
   resourcemanager.projects.get
   resourcemanager.projects.getIamPolicy
   resourcemanager.projects.list
   

   You’ll need these permissions to give ConductorOne READ/WRITE access (for syncing access data and provisioning access):

   cloudasset.assets.analyzeIamPolicy
   cloudasset.assets.searchAllIamPolicies
   cloudasset.assets.searchAllResources
   iam.roles.get
   resourcemanager.folders.getIamPolicy
   resourcemanager.folders.list
   resourcemanager.folders.setIamPolicy
   resourcemanager.organizations.get
   resourcemanager.organizations.getIamPolicy
   resourcemanager.projects.get
   resourcemanager.projects.getIamPolicy
   resourcemanager.projects.list
   resourcemanager.projects.setIamPolicy
   

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

7. Click DONE.

Before moving on, carefully copy and save the service account ID that Google generated for the service account.

Grant your service account access to your organization

1. Navigate to your organization by selecting your organization from the dropdown.

   

2. Navigate to the IAM tab from the left nav and click ADD button located at the top of the page.

   

3. For the principal, use the service account ID for the service account you created earlier.

4. Select the appropriate roles:

   • Organization Viewer and Viewer to give ConductorOne READ access

   • Organization Administrator and Editor to give ConductorOne READ/WRITE access

5. Click Save.

Optional: Enable API token information syncing

If you want to sync information about the API tokens and service account keys created in your Google Cloud Platform instance, follow the instructions below. Otherwise, skip ahead to the Get credentials section.

1. In the ConductorOne project, search for “API keys” and enable it.

2. Next, grant the API Keys Viewer Role to the service account you created for ConductorOne. Navigate to IAM & Admin > IAM.

3. On the IAM page, find your Service Account in the list on the Principals tab.

4. Click the icon to edit the Service Account, then click Add another role.

5. Search for and select API Keys Viewer.

6. Click Save.

Next, we’ll return to the ConductorOne integration project you created earlier to generate the necessary credentials.

Get credentials

1. Navigate back to APIs & Services > Credentials and select the service account you just created.

2. Click the service account’s email address.

3. On the Service Account Details Page, click KEYS.

   

4. Click ADD KEY > Create new key.

5. Choose JSON and click CREATE. The new key is created and downloaded to your computer.

6. Keep the downloaded file safe, you’ll use it to set up the connector.

That’s it! Next, move on to the instructions for your chosen setup method.

Configure the Google Cloud Platform connector

To complete this task, you’ll need:

• The Connector Administrator or Super Administrator role in ConductorOne
• Access to the set of Google Cloud Platform credentials generated by following the instructions above