> For the complete documentation index, see [llms.txt](https://docs.zata.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.zata.ai/manage/bucket/bucket-policy-configuration.md).

# Bucket Policy Configuration

Bucket Policy is used to manage access control for a bucket by defining who can access it and what actions they can perform. It allows secure and fine-grained permission management without changing the bucket’s public visibility. By creating a bucket policy, specific users or the public can be granted limited access such as read-only or download permissions. This ensures better security and controlled usage of object storage resources.

<br>

### Creating an Access Policy

1. From the left sidebar menu, navigate to **Policies**.
2. Click on the **+ Create Policy** button.

<figure><img src="https://2683631041-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPPVG4W649TwXN8OejRhb%2Fuploads%2Fgit-blob-a1639d170122aa779f0d711905ac201ae09f2cc7%2Fbucket-policy-configuration-1.png?alt=media" alt="Access Policies Dashboard"><figcaption></figcaption></figure>

The policy creation process follows a simple 4-step wizard:

#### Step 1: Grantee

Choose who should get access to your bucket. You can grant access to:

* **Public**: Anyone on the internet.
* **Subuser**: A specific team member.

After selecting the grantee, choose the **Region** from the dropdown menu and select the specific subuser if applicable.

<figure><img src="https://2683631041-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPPVG4W649TwXN8OejRhb%2Fuploads%2Fgit-blob-c86921fd30eb27e351ab94f56d899a245a8ed96f%2Fbucket-policy-configuration-2.png?alt=media" alt="Select Grantee - Public"><figcaption></figcaption></figure>

<figure><img src="https://2683631041-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPPVG4W649TwXN8OejRhb%2Fuploads%2Fgit-blob-16b75f08a4687371e2ce6b8f2f6b585f017a5b78%2Fbucket-policy-configuration-3.png?alt=media" alt="Select Grantee - Subuser"><figcaption></figcaption></figure>

#### Step 2: Bucket and scope

Select the specific bucket you want to apply this access policy to.

<figure><img src="https://2683631041-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPPVG4W649TwXN8OejRhb%2Fuploads%2Fgit-blob-f27511859f34c1ad94909302183f71aed77d6f57%2Fbucket-policy-configuration-4.png?alt=media" alt="Select Bucket"><figcaption></figcaption></figure>

Next, define the **Access scope**:

* **Entire bucket**: Access all objects within the selected bucket.
* **Specific folders**: Restrict access to specific paths within the bucket.

<figure><img src="https://2683631041-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPPVG4W649TwXN8OejRhb%2Fuploads%2Fgit-blob-c96bdac1c7b7fa29c2996437ed6101bd7c4a4b6c%2Fbucket-policy-configuration-5.png?alt=media" alt="Select Access Scope"><figcaption></figcaption></figure>

#### Step 3: Permissions

Choose the specific actions that are allowed or denied for the grantee. You can select individual Object operations (e.g., Download files, View file tags) or Bucket operations.

<figure><img src="https://2683631041-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPPVG4W649TwXN8OejRhb%2Fuploads%2Fgit-blob-56aaea1aaa46c9a949b5d4b891f33154afa2c2cc%2Fbucket-policy-configuration-6.png?alt=media" alt="Select Permissions"><figcaption></figcaption></figure>

#### Step 4: Review

Review the details of your policy setup, including the Grantee, Bucket, and Permissions.

* Select the **Effect**: Choose `Allow` to grant the permissions or `Deny` to explicitly restrict them.
* (Optional) Enter a **Policy name** for easier identification later.

Click **Create access policy** to finalize and apply the rules.

<figure><img src="https://2683631041-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPPVG4W649TwXN8OejRhb%2Fuploads%2Fgit-blob-a18b8f4b09c77ef42de88148e057150346ee3e7d%2Fbucket-policy-configuration-7.png?alt=media" alt="Review Policy Details"><figcaption></figcaption></figure>

### Managing Policies

After successful creation, your new policy will appear in the Access Policies list. From here, you can view, edit, or delete existing policies.

<figure><img src="https://2683631041-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPPVG4W649TwXN8OejRhb%2Fuploads%2Fgit-blob-a9ab3ab71c121d51e62f6769853e07cd20982737%2Fbucket-policy-configuration-8.png?alt=media" alt="Active Access Policy List"><figcaption></figcaption></figure>

**Delete a Bucket policy:** To delete a policy, navigate to the **Policies** section, locate the policy you want to remove, and select the delete option from the actions menu. This removes all custom access rules defined in that policy.
