Breadcrumbs

Organization mapping for GCP

Connector Applicability

Applies to Source Connectors

GCP

Applies to Destination Connectors

All

Assumptions

These instructions assume you have already setup a source connection in CI Sync for GCP using the CI Sync instructions here: Add GCP to SaaS Agent.

And you have granted additional permissions to add Organization mapping as per Task 5b in the above document.

Add GCP to SaaS Agent | Task 5b: Additional permissions required to add Organization mapping for GCP

CI Sync Configuration

The Organization synchronization must be enabled via the GCP connection for the Organizations selection to be visible on the Job Run UI.

Pre-Read

Syncfish recommend customers read the following documentation before changing the Connection Setting/s described below.

  1. Understanding the use of CI Sync Connection Settings

  2. Rule 13 - GCP Organization mapping

Locating and Amending the Connection Setting in the CI Sync UI

  1. Navigate to the Settings page

  2. Under the Source Connections heading (list), locate your GCP connection.

  3. Click the Update link on the right-hand side of the GCP connection.

  4. Scroll down and locate the Section Heading and view the Individual Settings.

GCP Organizations 2.jpg

The screen shot is provided only as sample to assist when reading this page. The state of your own CI Sync UI will depend on whether you are starting from the CI Sync default position or if you have already amended one/more of the settings.

  1. Tick the Override default box/boxes and then use the sliders related to the individual settings. The following table elaborates any further information about these particular settings.

Setting

Type

Additional Notes

Enable Organization Synchronization

Slider

When enabled, this setting causes the following:

CI Sync shows Organizations in Step 2 (Selections) when creating a synchronization job (see the screen shot below for the UI behavior).

CI Sync maps Organizations to the cmdb_ci_cmp_resource table in ServiceNow.

GCP Organizations 3.jpg

n.b. the appropriate permissions must be granted first as per the above section GCP Configuration to allow Organization mapping for GCP.

  1. After modifying the settings, scroll to the bottom of the page, tick the “I consent…” checkbox and finally click the Save connection button.

  2. You can now run a sync job and the amended settings will be applied causing the CI Sync Data Sync rules to be modified accordingly.

Importantly

Make sure you consciously override the setting against either your TEST or PROD environment (i.e. your TEST vs PROD sync jobs).

For more information on how to use TEST vs PROD Connection Settings please read Understanding the use of CI Sync Connection Settings.

Syncfish strongly recommend making changes for TEST environment/sync jobs first. Only modify PROD related settings after thoroughly validating the intended results in TEST.