> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zero-x.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# GCP account

# 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**.

<Accordion title="📖 View Setup Guide">
  ## 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**.

  **Example**

  | Field | Example |
  | - | - |
  | Project Name | Production |
  | Project ID | `my-production-project-123456` |
  | Project Number | `123456789012` |

  Enter the **Project ID** in the integration form.

  ```text theme={null}
  my-production-project-123456
  ```

  ***

  ## 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:

  | Role | Purpose |
  | - | - |
  | **Viewer** (`roles/viewer`) | Read-only access to most Google Cloud resources. |
  | **Security Reviewer** (`roles/iam.securityReviewer`) | View IAM policies and security configurations. |
  | **Browser** (`roles/browser`) *(Optional)* | Basic visibility of project resources. |

  > **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.
</Accordion>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.