Downloads and signed URLs
Authenticated downloads always stream through Django. A signed URL is a separate, optional pointer at the blob. This page is both paths.
You need read access on the object, from bucket defaults or an access grant. Someone without a token uses a share link, which streams the same way.
Stream a file
GET /storage/v1/object/{bucket}/{path} returns a FileResponse. The Files UI can open the file on the storage host with the Authorization header. The response does not redirect to S3, and it does not use X-Accel-Redirect.
The same bytes are available at /storage/v1/object/authenticated/{bucket}/{path}.
| Header | Value |
|---|---|
Content-Type | Object MIME type |
Content-Disposition | inline, or attachment when the download query parameter is present |
Content-Length | Object size |
ETag | Quoted content hash when one is stored |
Cache-Control | private, no-store |
download with an empty value, true, or 1 uses the object's file name. Any other download value is sent as the file name. The response also sets last_accessed_at on the row.
GET /storage/v1/object/public/… does not serve bytes. It returns 403 public_download_disabled.
Signed URLs
POST /storage/v1/object/sign/{bucket}/{path} returns a time-limited URL. Object GET does not redirect to it. You can also POST /storage/v1/object/sign/{bucket} with the path in the body.
The body field is expiresIn or expires_in, in seconds. The value is capped at SIGNED_URL_EXPIRES (default 3600). A larger number is reduced. The minimum used is 1 second.
| Backend | URL | Use |
|---|---|---|
STORAGE_BACKEND=s3 | Pre-signed URL with query-string authentication | Clients that should fetch from object storage |
filesystem | Plain /media/objects/… path. Not signed | Local development. Do not publish /media/ |
On S3, anyone who holds the URL can fetch the object until it expires. There is no download counter and no revoke short of waiting for expiry. For a link you can revoke, use Share links.
Filesystem signed URLs are ordinary media paths. If that path is reachable, knowing or guessing it is enough. Production installs that need signed URLs set STORAGE_BACKEND=s3 and leave /media/ off the public host. See Security hardening.