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
- Open Google Cloud Console.
- Create or locate an HMAC key for Cloud Storage.
- Open BucketMate Web.
- Confirm the extension shows Connected in Settings > Advance.
- Choose Add connection.
- Select Google Cloud Storage.
- Enter
https://storage.googleapis.com. - Enter the HMAC access key as the access key ID.
- Enter the HMAC secret as the secret access key.
- Select the bucket location.
- Use Test Connection.
- 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.
Links to private files
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.