Configure Google Cloud Platform (GCP)

Required User Role: Administrator

Before you can use GCP connectors, you must configure GCP to support your connectors.

To configure GCP to support connectors:

  1. Log into Google Cloud Platform.
  2. In the left navigation bar, select IAM & admin.
  3. The IAM & admin page appears.

  4. In the Select a project drop-down box in the upper-left, select the applicable GCP project.
  5. In the left navigation bar, select Service accounts.
  6. The Service accounts page for your GCP project appears.

  8. The Create service account page appears.

  9. In the Service account name box, type a display name for your service account.
  10. In the Service account ID box, type a unique service account ID.
  11. In the Service account description box, describe what the service account will do.
  12. Click the CREATE button.
  13. The Grant this service account access to project page appears.

  14. In the drop-down box on the Service account permissions (optional) page, add the Logging -> Logs Viewer role.
  15. Note: The service accounts must have the Logging -> Log Viewer role for discovery sync (incremental syncs after initial full sync).

  16. Click + ADD ANOTHER ROLE on the Service account permissions (optional) page.
  17. Add the Compute Engine -> Compute Viewer role.
  18. Click the Continue button.
  19. The Grant users access to this service account page appears.

  20. In the Create key (optional) section, click +CREATE KEY.
  21. The create key (optional) pane appears.

  22. Under Key type, select JSON to create a key in JSON format.
  23. Click the CREATE button.
  24. Your browser downloads the key in JSON format.

(Optional) To configure a GCP service account that can access multiple projects:

You may have dozens of GCP accounts that are added and removed regularly. Instead of adding each GCP account as a different connector, you can configure the top-level service account to access multiple projects. The GCP connector automatically discovers all linked projects and pulls assets from those projects.

Note: The top-level service account must have the Cloud Resource Manager API enabled in order to access multiple projects.

Caution: The GCP connector pulls assets from any project that is configured with access to the top-level service account. Only add projects that you want the GCP connector to pull data from.
  1. Log into Google Cloud Platform.
  2. In the left navigation bar, select IAM & admin.
  3. The IAM & admin page appears.

  4. In the drop-down menu in the top-left corner, select the second GCP project.
  5. In the IAM menu bar, click + ADD.

    The Add members to project pane appears.

  6. In the New Members box, type the name of the top-level service account that you created in step 6 of the first section.
  7. In the Select a role drop-down box, select the appropriate role.
  8. (Optional) Click the + ADD ANOTHER ROLE button to add additional roles.
  9. To add additional projects, repeat steps 3 through 7.

What to do next: