Skip to main content

​
Connect GCP Project

Follow these simple steps to complete the setup modal and securely input your GCP project details and JSON key.

​
1. Basic Configuration Follow below steps

  1. Once you logged in you will navigate to Dashboard.
  2. Go to the integration and click on Connect button to add GCP Datasource.
  3. Enter Data Source Name (e.g., Production-AWS, Staging-Environment).
  4. Select Environment: Click the dropdown menu and select the environment type (e.g., Production, Staging, Development).
  5. Enter GCP Project ID (For details click on view guide).
  6. Select Regions from dropdown.
  7. Enter Service Account JSON.(For details click on view guide ).
  8. Click on Verify Integration.

​
How to generate GCP Project ID

​
Step 1 : Find the Project ID

  1. Sign in to the Google Cloud Console.
  2. Select your project from the Project Selector.
  3. On the Dashboard or Project Info page, copy the Project ID.
ExampleEnter the Project ID in the integration form.

​
Step 2: Select Regions

Choose the regions where your GCP resources are deployed.Common regions include:
  • us-central1
  • us-east1
  • us-west1
  • europe-west1
  • asia-south1 (Mumbai)
  • asia-east1
  • asia-southeast1
Note: If you’re unsure which regions your resources use, select All Regions (if supported by your application).

​
Step 3: Create a Service Account

  1. Open Google Cloud Console.
  2. Navigate to IAM & Admin → Service Accounts.
  3. Click Create Service Account.
  4. Enter a service account name (for example, security-audit-sa).
  5. Click Create and Continue.

​
Step 4: Assign Read-Only Roles

Grant only the minimum permissions required for security scanning.Assign the following roles:
Note: If your security platform requires additional permissions, assign only the roles documented by the platform.

​
Step 5: Create the JSON Key

  1. Open the newly created Service Account.
  2. Go to the Keys tab.
  3. Click Add Key → Create New Key.
  4. Select JSON.
  5. Click Create.
  6. A JSON key file will be downloaded automatically.
Important: Store the JSON key securely. It provides access to your GCP project and should never be shared publicly.

​
Final Step

Return to your application and provide:
  • Project ID
  • Selected Region(s)
  • Upload the downloaded JSON Key file
Click Connect to complete the GCP integration.Create a new Google Cloud Project or select an existing project that you want to integrate with Zero-X.

​
2. Create a Service Account

  1. In the Google Cloud Console, navigate to IAM & Admin → Service Accounts.
  2. Create a Service Account with Viewer (or the required read-only) permissions.
  3. Ensure the account has access to the resources you want Zero-X to analyze.

​
3. Generate Service Account JSON Key

  1. Open the created Service Account.
  2. Go to the Keys tab.
  3. Click Add Key → Create New Key.
  4. Select JSON.
  5. Download the generated Service Account JSON key securely.