# Connect Your GCP Account

Noros connects to your Google Cloud environment using read-only access to your BigQuery billing dataset. The entire setup process is guided by Noros directly in the chat.

### Prerequisites

* An active Noros account
* **BigQuery Data Owner** role for your billing account
* Billing export enabled in your GCP project (if not already enabled, data migration may take up to 5 days)

### Onboarding Steps

#### Step 1: Enable Billing Export

If you haven't already, enable billing export in your GCP project:

1. Go to **Billing Export** in the Google Cloud Console.
2. Click **Edit Settings**.
3. Enable export for:
   * Standard usage cost
   * Detailed usage cost
   * Pricing

#### Step 2: Create or Select a Dataset

Select an existing BigQuery dataset or create a new one for your billing data. We recommend naming it `noros_billing_dataset` for clarity.

#### Step 3: Enable Recommender

Set up the GCP Recommender with the following configuration:

* **Frequency**: Daily
* **Versions**: 1
* **Start time**: 00:00

#### Step 4: Share Your Billing Dataset

Noros will provide a **Principal ID** during onboarding. Share your billing dataset with this principal:

1. In BigQuery, select your billing dataset.
2. Click **Share > Permissions > Add Principal**.
3. Enter the Principal ID provided by Noros.
4. Assign the following roles:
   * **BigQuery Data Viewer**
   * **BigQuery Metadata Viewer**

#### Step 5: Select Datasets in Noros

Confirm which datasets to use for Standard usage cost, Detailed usage cost, and Pricing data.

#### Step 6: Verify and Start

Noros will verify access to your billing data. You'll receive a confirmation when analysis is complete and Noros is ready to answer questions about your GCP environment.

### Security

Noros uses **Workload Identity Federation** to access your BigQuery data — no service account keys are required. Access is:

* **Read-only** — Noros can only read data from the shared billing dataset
* **Time-limited** — Credentials are automatically rotated
* **Scoped** — No access to other projects, datasets, or resources

Learn more about GCP permissions →

### Connecting Additional Projects

You can connect multiple GCP projects to Noros. To add another project, simply ask Noros in the chat and it will guide you through the process.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.noros.ai/getting-started/connect-your-gcp-account.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.