# Google Cloud Storage

> Connect Google Cloud Storage to BucketMate Web with HMAC keys

Canonical: https://docs.bucketmate.app/web/providers/connect-google-cloud-storage

BucketMate Web connects to Google Cloud Storage through its S3-compatible XML API using HMAC keys. Make sure the companion browser extension is connected before testing the connection.

## Prerequisites

- Google Cloud project
- Cloud Storage bucket
- HMAC access key
- HMAC secret
- Bucket location
- BucketMate browser extension

## Endpoint and region

Use the global endpoint for the best compatibility:

```text
https://storage.googleapis.com
```

Select the bucket location as the region. BucketMate Web also supports custom regions when your location is not in the preset list.

## Connection steps

1. Open Google Cloud Console.
2. Create or locate an HMAC key for Cloud Storage.
3. Open BucketMate Web.
4. Confirm the extension bridge is connected.
5. Choose **Add Connection**.
6. Select **Google Cloud Storage**.
7. Enter `https://storage.googleapis.com`.
8. Enter the HMAC access key as the access key ID.
9. Enter the HMAC secret as the secret access key.
10. Select the bucket location.
11. Use **Test Connection**.
12. Save the connection.

## Common issues and fixes

### HMAC keys are required

BucketMate Web's S3-compatible connection uses HMAC credentials. Service account JSON keys are not the same credential format. Create HMAC keys for Cloud Storage access.

### Locational endpoints may have limited compatibility

BucketMate Web warns when a locational endpoint may not support every operation. Use `https://storage.googleapis.com` unless you specifically need a locational endpoint.

### Bucket list permission is restricted

If credentials can access a bucket but cannot list all buckets, add bucket names in **Explicit Buckets**.

### Direct URLs do not open

Direct copied URLs work only when the object is public or otherwise reachable. Use presigned links for private objects.

## Read More

- [Google Cloud Storage interoperability](https://docs.cloud.google.com/storage/docs/interoperability)
- [Google Cloud Storage HMAC keys](https://docs.cloud.google.com/storage/docs/authentication/hmackeys)