Skip to navigation

Bucket Policies

Bucket access is about who can read and write the files in a bucket. Every bucket starts private: only S3 credentials from its workspace can read or write it. You open it up in one of three ways:

  • Public Access: a switch on the bucket that lets anyone on the internet read every file in it, through a Public Access URL or a custom domain.
  • S3 credentials: keys for your own apps and tools, each with a permission level and a list of buckets.
  • Presigned URLs: links that let someone download or upload one file, until the link expires.

Which option should I use?

You want to…UseWho can get inFor how long
Host website files, images or public downloadsPublic AccessAnyone with the addressUntil you turn it off
Share one private file with a person, or let them upload onePresigned URLAnyone with the link1 second to 7 days, you choose
Let your app, server or backup tool use the bucketS3 credentialOnly programs with the keysUntil you revoke it
Keep everything privateNothing: buckets are private by defaultOnly your S3 credentials—

Public Access applies to the whole bucket: every file in it becomes public. To share some files publicly and keep others private, use two buckets, or presigned URLs for the private files.

For browser-based cross-origin access, see CORS. For Object Lock retention, see Objects → Locking.

Before you begin

  • A bucket. See Create a bucket.
  • Permission to change the bucket’s settings in the portal. The Public Access switch needs write access to the bucket.

Public access

Enabling Public Access allows objects in the bucket to be served unauthenticated via a Public Access URL.

1

Open General settings

Open your bucket → click Settings → click the General tab.

2

Enable Public Access

Toggle Public Access from Disabled to Enabled. A confirmation toast appears: “Bucket access changed to public”.

3

Enable the Public Access URL

The Public Access URL section becomes active but no URL is assigned automatically — it shows “No Public Access URL is assigned to this bucket.”

Click Enable in the top-right of the Public Access URL card to assign a URL to the bucket.

Copy the URL. Objects are then accessible at:

https://<public-access-url>/<object-key>

The Public Access URL is rate-limited and not recommended for production. For production traffic, connect a custom domain to the bucket. To turn the URL off, click Disable on the Public Access URL card.

Enabling Public Access makes all objects in the bucket readable without authentication. Only enable this for buckets intended for public content.

If Public Access is disabled, the Public Access URL section shows: “Please enable public access in General to use the Public Access URL.”

To serve from your own hostname instead of the assigned Public Access URL, see Custom Domains — the bucket must be public to register a custom domain.

API Credential access

For programmatic access via the AWS CLI, rclone, or any S3-compatible tool, use an S3 credential, created under Organization → API Tokens → S3 Credentials. Each credential belongs to one workspace and provides:

  • Access Key ID + Secret Access Key — for S3-compatible tools
  • S3 Endpoint — https://{workspaceId}.blob.ibeestorage.com

Permission levels

Each credential is created with one Object Storage permission level:

PermissionWhat it allows
Admin Read & WriteCreate, list, delete buckets, edit bucket configuration, read, write, and list objects.
Admin Read onlyList buckets, view configuration, read and list objects.
Object Read & WriteRead, write, and list objects in specific buckets.
Object Read onlyRead and list objects in specific buckets.

Bucket scoping

Admin credentials always apply to every bucket in the credential’s workspace. Object Read & Write and Object Read only credentials can apply to:

  • Apply to all buckets in this organization (including newly created buckets): the simplest option for application-wide access.
  • Apply to specific buckets only: pick one or more buckets the credential can access.

This is the bucket-level access boundary: a credential scoped to bucket A cannot read or write to bucket B.

Create an API credential →

Troubleshooting

You seeWhat it meansWhat to do
Please enable public access in General to use the Public Access URL.The bucket is still privateTurn on Public Access in Settings → General first, then click Enable on the Public Access URL card.
No Public Access URL is assigned to this bucket.Public Access is on, but no URL has been createdClick Enable on the Public Access URL card.
A public link returns 403 or AccessDeniedPublic Access is off for that bucket, or the file name in the link is wrong (names are case-sensitive)Check the Public Access switch, and the full file key.
Public files load slowly or are throttledThe Public Access URL is rate-limitedConnect a custom domain for production traffic.
A custom domain can’t be addedCustom domains need a public bucketTurn on Public Access first.
An app gets 403 AccessDenied on one bucketThe S3 credential is limited to other buckets, or its permission level is too lowCreate a credential that includes the bucket, with the right permission level.

Best practices

  • Default to private. Only enable Public Access on buckets that genuinely serve public content (websites, media, downloads).
  • Use one credential per application or environment with the narrowest permission level and bucket scope that works.
  • Rotate credentials by creating a new credential, switching applications to use it, then revoking the old one. The Secret Access Key is shown only once — store it securely.
  • Separate buckets for prod / staging / dev rather than relying on prefix-based separation alone.