Skip to help content
API, MCP and webhooks

Bring your own storage

Connect an S3-compatible bucket or Google Cloud Storage with short-lived, tenant-scoped credentials.

Storage ownership and cost

With bring your own storage, file bytes stay in the connected customer bucket while Astral manages transfer metadata, policy, and audit. The customer remains responsible for provider storage, request, egress, retention, and recovery costs.

Use short-lived credentials

Configure a dedicated role or service identity limited to the approved bucket and prefix. Astral resolves the referenced credential at runtime and does not place long-lived secrets in connection records.

  • Deny public bucket access.
  • Restrict object operations to the tenant prefix.
  • Keep credential lifetimes short and rotate the underlying trust relationship.
  • Do not reuse a human administrator key.

Validate before using the connection

  1. Create the storage connection with its provider, region, bucket, and allowed prefix.
  2. Run the built-in health check.
  3. Verify upload, download, and deletion against a non-production test object.
  4. Only then assign the connection to production transfers.

Related guides