Configuring GCP Data Sources

image-20251112-142732.png


Google Cloud Project

Before linking the Google Cloud Project, the following steps must be completed:

  • Enable Billing export

  • Create a role for CerteroX for Cloud

  • Create a service account

  • Generate an API key

If this has not been completed, refer to Configure the Project before proceeding to Connect to CerteroX for Cloud.

Configure the Project

  1. Enable Billing export following the official Google Cloud documentation. This will result in a new dataset in BigQuery. Note the names of the dataset & table.

  2. Configure a role for CerteroX for Cloud:

  • Run the following command in GCP CLI:

gcloud iam roles create
certerox_connection_role \--project=<enter_your_project>
\--permissions=bigquery.jobs.create, bigquery.tables.getData, compute.addresses.list,
compute.addresses.setLabels, compute.disks.list, compute.disks.setLabels, compute.firewalls.list,
compute.globalAddresses.list, compute.instances.list, compute.instances.setLabels, compute.images.list,
compute.images.setLabels, compute.machineTypes.get, compute.machineTypes.list, compute.networks.list,
compute.regions.list, compute.snapshots.list, compute.snapshots.setLabels, compute.zones.list,
iam.serviceAccounts.list, monitoring.timeSeries.list, storage.buckets.get, storage.buckets.getIamPolicy,
storage.buckets.list, storage.buckets.update
  • Via Google Cloud console

Go to Roles page and click Create Role.

Give the role any name and description.

Add the following permissions:

bigquery.jobs.create

bigquery.tables.getData

compute.addresses.list

compute.addresses.setLabels

compute.disks.list

compute.disks.setLabels

compute.firewalls.list

compute.globalAddresses.list

compute.instances.list

compute.instances.setLabels

compute.images.list

compute.images.setLabels

compute.machineTypes.get

compute.machineTypes.list

compute.networks.list

compute.regions.list

compute.snapshots.list

compute.snapshots.setLabels

compute.zones.list

iam.serviceAccounts.list

monitoring.timeSeries.list

storage.buckets.get

storage.buckets.getIamPolicy

storage.buckets.list

storage.buckets.update

  1. Create a service account following the official Google Cloud documentation. Specify the role you have just created.

  2. Generate an API key for your service account following the official Google Cloud documentation. Download it as a .json file, which will be used in the next stage.

Connect to CerteroX for Cloud

  1. Go to CerteroX for Cloud → Settings → Data Sources.

  2. Click Actions → Add

  3. Select GCP as the Data Source and Project as Connection type.

image-20250718-131019.png
  1. Fill in the fields & upload the API key from earlier. Click the Connect button.


Google Cloud Tenant

Before linking the Google Cloud Project, the following steps must be completed:

  • Enable Billing export

  • Create a role for CerteroX for Cloud

  • Create a service account

  • Generate an API key

If this has not been completed, refer to Configure the Tenant before proceeding to Connect to CerteroX for Cloud.

Configure the Tenant

  1. Enable Billing export following the official Google Cloud documentation. This will result in a new dataset in BigQuery. Note the names of the dataset & table.

  2. Configure a role for CerteroX for Cloud:

  • Run the following command in GCP CLI:

gcloud iam roles create
certerox_connection_role \--project=<enter_your_project>
\--permissions=bigquery.jobs.create, bigquery.tables.getData, compute.addresses.list,
compute.addresses.setLabels, compute.disks.list, compute.disks.setLabels, compute.firewalls.list,
compute.globalAddresses.list, compute.instances.list, compute.instances.setLabels, compute.images.list,
compute.images.setLabels, compute.machineTypes.get, compute.machineTypes.list, compute.networks.list,
compute.regions.list, compute.snapshots.list, compute.snapshots.setLabels, compute.zones.list,
iam.serviceAccounts.list, monitoring.timeSeries.list, storage.buckets.get, storage.buckets.getIamPolicy,
storage.buckets.list, storage.buckets.update
  • Via Google Cloud console

Go to Roles page and click Create Role.

Give the role any name and description.

Add the following permissions:

bigquery.jobs.create

bigquery.tables.getData

compute.addresses.list

compute.addresses.setLabels

compute.disks.list

compute.disks.setLabels

compute.firewalls.list

compute.globalAddresses.list

compute.instances.list

compute.instances.setLabels

compute.images.list

compute.images.setLabels

compute.machineTypes.get

compute.machineTypes.list

compute.networks.list

compute.regions.list

compute.snapshots.list

compute.snapshots.setLabels

compute.zones.list

iam.serviceAccounts.list

monitoring.timeSeries.list

storage.buckets.get

storage.buckets.getIamPolicy

storage.buckets.list

storage.buckets.update

  1. Create a service account following the official Google Cloud documentation. Specify the role you have just created.

  2. Grant the service account access to each project that needs to be linked to CerteroX for Cloud. Select the Project, go to the IAM & Admin section in Google Cloud Console, select IAM, and click the Grant Access button. Add the your service account & assign the created role to it.

  3. Generate an API key for your service account following the official Google Cloud documentation. Download it as a .json file, which will be used in the next stage.

Connect to CerteroX for Cloud

  1. Go to CerteroX for Cloud → Settings → Data Sources.

  2. Click Actions → Add

  3. Select GCP as the Data Source and Tenant as Connection type.

image-20250718-131541.png
  1. Fill in the fields & upload the API key from earlier. Click the Connect button.