Access Control List (ACL)
ACL (Access Control List) in the VK Object Storage service defines which storage accounts or groups are granted access to a bucket or object. Each bucket or object has its own ACL, which can contain up to 100 entries. Each entry specifies the grantee and the type of permission granted to it. When a request to a bucket or object is received, VK Object Storage checks the corresponding ACLs to verify whether the requester has the required permissions.
The VK Object Storage service supports a set of pre-defined ACLs — ready-made lists of grantees and the permissions assigned to them. When creating a bucket, VK Object Storage applies the private pre-defined ACL by default. This ACL grants the bucket owner full control over the bucket and denies access to all other users.
An object ACL can be assigned:
- When uploading a new object to a bucket via the management console, you select one of the pre-defined ACLs for it.
- When uploading via the API, you can specify the object ACL in the request body or headers.
If no ACL is specified, the private pre-defined ACL with maximally restricted access will be assigned to the new bucket or object: when creating a bucket, only the bucket owner will get access; when adding an object, only the object owner will get access.
The ACL for a bucket or object can be changed later. The ACL of a bucket and the ACL of an object inside it may differ.
ACL parameters can be passed via configuration in the following formats:
- XML, when sending a request via the API;
- JSON, if AWS CLI is used.
Access to buckets and objects can be granted to the following categories of grantees:
-
A project VK Cloud.
-
Pre-defined metagroups:
AuthenticatedUsers— all VK Object Storage accounts in any VK Cloud project.AllUsers— any anonymous user, including those who are not VK Object Storage or VK Cloud users.
In the table below are the types of permissions that VK Object Storage supports in ACLs. For each permission, the rights it grants and the operations it allows are shown for when it is granted on a bucket and on an object.
ACL permission | Granted on a bucket | Granted on an object |
|---|---|---|
| Lists the objects in the bucket HeadBucket, ListMultiparts, ListObjects, ListParts | Reads the object's content and metadata GetObject, HeadObject |
| Creates, overwrites, and deletes any object in the bucket AbortMultipartUpload, CompleteMultipartUpload, InitiateMultipartUpload, UploadPart, PutObject, DeleteObject | Not applicable |
| Reads the bucket's ACL GetBucketAcl | Reads the object's ACL GetObjectAcl |
| Sets the ACL for the bucket PutBucketAcl | Sets the ACL for the object PutObjectAcl |
| All rights within the bucket permissions: | All rights within the object permissions: |
Information about the operations listed in the table can be found in the section describing the VK Object Storage API.
VK Object Storage provides pre-configured access control lists — pre-defined ACLs. These lists can be used in API requests for access to a bucket, object, or their current ACLs.
A pre-defined ACL is specified in a request using the x-amz-acl HTTP header. Only one pre-defined ACL can be specified. When VK Object Storage receives a request containing a pre-defined ACL, it adds the pre-configured permissions to the ACL of the corresponding bucket or object.
Pre-defined ACL | Scope | Pre-configured permissions |
|---|---|---|
(default) | Bucket and object | The owner has full rights ( |
| Bucket and object | The owner has full rights ( |
| Bucket and object | The owner has full rights ( If this pre-defined ACL is specified when creating a bucket, VK Object Storage will ignore it |