Private bucket origin · Google Cloud Storage
Fetch and resize originals from a private Google Cloud Storage bucket. Edge nodes sign requests with GCS interoperability HMAC keys and deliver AVIF or WebP.
Google Cloud Storage offers an XML API compatible with AWS Signature Version 4 at https://storage.googleapis.com/<bucket>/. With an HMAC key for a service account that has Storage Object Viewer on the bucket, edge nodes sign each GET request without making the bucket public and without loading a Google Cloud SDK.
Signing: AWS Signature Version 4 (HMAC-SHA256) for service s3 with region auto against https://storage.googleapis.com/<bucket>/.
| Field | What to give |
|---|---|
| Bucket | The Google Cloud Storage bucket name, such as my-images. |
| Folder (optional) | A prefix inside the bucket, such as images/originals. |
| Access key id and secret | An HMAC key (Access ID and Secret) from Cloud Storage → Settings → Interoperability, for a service account with roles/storage.objectViewer on the bucket. |
The secret is sealed at rest with the Data Protection key ring and never shown back in the console. Rotating credentials means entering a new key on the bucket row; edge nodes pick it up within a minute.
An account can configure up to 10 private buckets and point the account origin or individual custom hostnames at them.
Other private bucket origins: Amazon S3 & S3-compatible , Cloudflare R2 , Azure Blob Storage .