# Google Cloud Storage

## Google Cloud Storage

This is a minimal guide on getting started with Google Cloud Storage buckets as a storage location for Qpoint Artifacts. Please keep in mind that Qpoint Artifacts often contain sensitive information so we don't recommend creating publicly available buckets.

There is likely some additional configurations that your organization will use to further lock down or configure access. Don't hesitate to stray from this guide to satisfy your organizational requirements.

### 1. Create a Service Account

<figure><img src="/files/pSO7XSXq9NB7Gifi0NLH" alt=""><figcaption></figcaption></figure>

1. Navigate to IAM & Admin > Service Accounts
2. Click "Create Service Account"
3. Name: `qpoint-storage`
4. Grant `Storage Object Admin` role

### 2. Create a Storage Bucket

<figure><img src="/files/tZkpO5Op9eGPbnCEelou" alt=""><figcaption></figcaption></figure>

1. Navigate to Cloud Storage > Buckets
2. Click "Create"
3. Name: Choose a globally unique name
4. Location type: Region
5. Choose the same region as your Qpoint deployment
6. Leave other settings as default

### 3. Generate HMAC Keys

<figure><img src="/files/bAd3b2X86D6Dhcgsnv4D" alt=""><figcaption></figcaption></figure>

1. Navigate to Cloud Storage > Settings > Interoperability
2. Find your service account
3. Click "Create Key For Another Service Account"
4. Save the Access Key and Secret

### 4. Configure Qpoint

<figure><img src="/files/xBTExMHKRgaqqINcGnxq" alt=""><figcaption></figcaption></figure>

#### Access URL Templates

URLs for specific objects can be found in the object's details page in the Google Cloud Console. Below are two common patterns:

* Authenticated: `https://storage.cloud.google.com/{{BUCKET}}/{{DIGEST}}?authuser=1`
* Public: `https://storage.googleapis.com/{{BUCKET}}/{{DIGEST}}`

<figure><img src="/files/lqjC9yOIwOKOKEKNmqxf" alt=""><figcaption></figcaption></figure>


---

# 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.qpoint.io/appendix/object-storage/google-cloud-storage.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.