BucketMate
Providers

Google Cloud Storage

Step-by-step guide to connect Google Cloud Storage to BucketMate Web in your browser with HMAC keys, the XML API endpoint, and bucket CORS settings.

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:

https://storage.googleapis.com

Select the bucket location as the region. If your location is not listed, choose Custom... and type it. The Google Cloud Storage default is auto.

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 shows Connected in Settings > Advance.
  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. Choose Save 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

Locational endpoints 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.

Copy URL in BucketMate Web creates a presigned URL that works for 1 hour, so it opens private objects. For longer access, create a share link. Plain object URLs outside BucketMate Web work only for public objects.

Read More