Управление доступом (ACL)

Обновлена 15 апреля 2024 г. в 08:50

Управление доступом

ACL (Access Control List) позволяет контролировать, какие операции разрешены каким пользователям. ACL может стоять как и на уровне всего бакета, так и на уровне конкретного объекта. Установить и прочесть ACL можно через приведенные методы ниже. По умолчанию, создаваемый бакет или объект максимально ограничен в доступе — только владелец бакета/объекта может работать с ним. У остальных пользователей — запрет доступа. ACL указывается в XML формате. Где в поле Owner ID нужно указать свой канонический идентификатор в системе VK Cloud. Получить его можно разными способами. Один из них:

aws s3api list-buckets --query Owner.ID --output text --endpoint-url https://hb.vkcs.cloud

Пример ACL, который дает те же права, что и по умолчанию (только владелец имеет полный доступ, никто больше):

<?xml version="1.0" encoding="UTF-8"?><AccessControlPolicy xmlns="http://<имя_бакета>.hb.vkcs.cloud/images/01.jpg/">  <Owner>    <ID>fcd68908-6c76-42d1-968b-82ae2a5a251d</ID>    <DisplayName>owner-display-name</DisplayName>  </Owner>  <AccessControlList>    <Grant>      <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"               xsi:type="Canonical User">        <ID>fcd68908-6c76-42d1-968b-82ae2a5a251d</ID>        <DisplayName>display-name</DisplayName>      </Grantee>      <Permission>FULL_CONTROL</Permission>    </Grant>  </AccessControlList></AccessControlPolicy>

Элемент <Owner> производит идентификацию владельца по каноническому идентификатору пользователя учетной записи VK Cloud.
Элемент <Grant> определяет идентификатор получателя для предоставляет разрешение.
Элемент <Permission> внутри <Grant> определяет тип доступа для получателя.

Базовый ACL, показанный выше в качестве примера, имеет один элемент <Grant>. Чтобы описать несколько получателей, то для каждого надо добавить свой элемент <Grant>.

При установке через HTTP заголовки, нужно использовать заголовки для выдачи специфичных для заголовка прав:

x-amz-grant-read — Список получателей прав для READ.
x-amz-grant-write — Список получателей прав для WRITE.
x-amz-grant-read-acp — Список получателей прав для READ_ACP.
x-amz-grant-write-acp — Список получателей прав для WRITE_ACP.
x-amz-grant-full-control — Список получателей прав для FULL_CONTROL.
x-amz-acl — Использование шаблонного ACL.

Ниже даны описания каждого из прав и что указывать в значениях заголовков.

Идентификатор для выдачи прав может быть несколько типов:

Конкретный пользователь в VK Cloud. Для этого нужно знать его уникальный идентификатор.
Проект в VK Cloud. Для этого нужно знать уникальный идентификатор проекта.
Предварительно определенные группы. Список указан ниже.
Весь мир. Включая анонимный доступ. Любой, знающий полный адрес до объекта, имеет доступ.

Выданное право для идентификатора выше может быть одним или составлено из нескольких типов:

READ — только чтение, какие-либо изменения не разрешены.
WRITE — только запись, какие-либо чтения не разрешены. Включая удаление.
READ_ACP — чтение ACL, какие-либо изменения не разрешены.
WRITE_ACP — запись ACL, какие-либо чтения не разрешены. Включая удаление.
FULL_CONTROL — все, что перечислено выше, сразу.

Идентификатор пользователя (он же известен как канонический ID/Canonical ID) -- это уникальный идентификатор, состоящий из набора символов. Пример - fcd68908-6c76-42d1-968b-82ae2a5a251d. Формат не фиксирован, при работе с идентификатором пользователя какие-либо преобразования и привязки к формату идентификатора не рекомендуются.

Если используется установка через XML, то внутри <Grantee> надо указать тег <ID>.

Пример: <ID>fcd68908-6c76-42d1-968b-82ae2a5a251d</ID>

Если используется установка через HTTP заголовок, то в значении заголовка надо использовать ключ id.

Пример: id="fcd68908-6c76-42d1-968b-82ae2a5a251d".

Канонический ID пользователя учетной записи VK Cloud можно получить, прочитав ACL бакета или объекта, к которому учетная запись VK Cloud имеет права доступа. Когда отдельная учетная запись VK Cloud получает разрешения по запросу на Grant, в ACL добавляется запись гранта с каноническим ID пользователя учетной записи VK Cloud.

Если идентификатор пользователя неизвестен, но известен идентификатор проекта, то можно указать проект. При обработке запроса на установку ACL, система ищет идентификатор пользователя и сохраняет его в ACL. В результате ACL всегда будут содержать канонический ID пользователя для проекта, а не идентификатор проекта.

Если используется установка через XML, то внутри <Grantee> надо указать тег <EmailAddress>.

Пример: <EmailAddress>mcs2400549523</EmailAddress>

Если используется установка через HTTP заголовок, то в значении заголовка надо использовать ключ id.

Пример: emailAddress="mcs2400549523".

Получить свой идентификатор проекта можно в личном кабинете в области информации об учетной записи. Кнопка, расположенная рядом с идентификатором проекта позволяет скопировать параметр для удобства.

Hotbox имеет набор предопределенных групп. Указывая специальный идентификатор "пользователя", система автоматически подставляет права по правилам, указанным ниже. То, что идентификатор выглядит как ссылка на AWS, не означает, что используются ресурсы AWS S3. Эти идентификаторы обрабатываются только как набор символов и используются для обратной совместимости с программами, которые созданы для AWS S3.

Authenticated Users — группа авторизованных пользователей. Эта метагруппа содержит все существующие учетные записи в системе VK Cloud, включая те, которыми вы не можете управлять. Разрешение на доступ к этой группе позволяет любой учетной записи VK Cloud получить доступ к ресурсу. Однако все запросы должны быть подписаны (аутентифицированы). Нужно указывать http://acs.amazonaws.com/groups/global/AuthenticatedUsers в поле URI. Авторизированным пользователям надо подписывать свои запросы для доступа к ресурсу.

All Users — группа «Все пользователи». Эта метагруппа снимает какие-либо ограничения на указанное право. Например, если сделать открытый доступ на READ, то любой пользователь может считывать содержимое, если он знает только имя бакета и имя объекта. А WRITE для всех позволяет любому пользователю все, что это право даёт. Нужно указывать http://acs.amazonaws.com/groups/global/AllUsers в поле URI.

Открывая доступ неопределенному кругу лиц, Вы теряете контроль, кто сможет совершать операции с Вашими ресурсами. Оплата за их действия совершается владельцем бакета. Самый неблагоприятный сценарий - анонимный пользователь с WRITE-доступом удаляет нужные для хранения объекты и размещает терабайты нежелательных файлов другому владельцу бакета.

Анонимные не авторизированные пользователи, если им предоставлен доступ, совершают действия под каноническим ID пользователя 65a011a29cdf8ec533ec3d1ccaae921c, так как у них нет учетной записи в VK Cloud.

Если используется установка через XML, то внутри <Grantee> надо указать тег <URI>.

Пример: <URI>http://acs.amazonaws.com/groups/global/AllUsers</URI>

Если используется установка через HTTP заголовок, то в значении заголовка надо использовать ключ id.

Пример: uri="http://acs.amazonaws.com/groups/global/AllUsers"

В таблице перечислены наборы разрешений, которые Cloud Storage поддерживает в ACL. Набор разрешений ACL одинаков для ACL объекта и ACL бакета. Эти ACL предоставляют разрешения для определенных бакетов или операций с объектами. В таблице перечислены разрешения и описано, что они означают в контексте объектов и бакетов.

| Разрешение | Применение к бакету | Применение к объекту |
| --- | --- | --- |
| READ | HeadBucketGetBucketLifecycleGetBucketNotificationListObjectsListPartsListMultiparts | Позволяет получить содержимое объекта и его метаданные |
| WRITE | Позволяет создавать, удалять, перезаписывать любые объекты в бакете | Не применимо |
| READ_ACP | Позволяет читать ACL бакета: GetBucketAclGetBucketCors | Позволяет читать ACL объекта: GetObjectAcl |
| WRITE_ACP | Позволяет изменять ACL бакета | Позволяет изменять ACL объекта PutObjectAcl |
| FULL_CONTROL | Комбинирует права READ, WRITE, READ_ACP, WRITE_ACP для бакета | Комбинирует права READ, WRITE, READ_ACP, WRITE_ACP для объекта |

ACL допускает только конечный набор разрешений по сравнению с количеством разрешений, которые можно установить в политике доступа. Каждое из этих разрешений позволяет выполнять одну или несколько операций Cloud Storage.

В следующей таблице показано, как каждое разрешение ACL сопоставляется с соответствующими разрешениями политики доступа. Как видно, политика доступа допускает больше разрешений, чем ACL. ACL используется в основном для предоставления базовых разрешений на чтение и запись, аналогично разрешениям файловой системы.

| Разрешение ACL | Политика доступа для бакета | Политика доступа для объекта |
| --- | --- | --- |
| READ | ListBucket,ListBucketMultipartUploads | GetObject |
| WRITE | PutObject,DeleteObject | Не применимо |
| READ_ACP | GetBucketAcl | GetObjectAcl |
| WRITE_ACP | PutBucketAcl | PutObjectAcl |
| FULL_CONTROL | Эквивалент предоставлению READ, WRITE,READ_ACP, и WRITE_ACP ACL разрешений | Эквивалент предоставлению READ, READ_ACP и WRITE_ACP ACL разрешений |

При предоставлении разрешения политики доступа, можно использовать условные ключи, чтобы ограничить значение ACL для объекта с помощью политики бакета. Приведенные ниже контекстные ключи соответствуют спискам ACL. Эти контекстные ключи предназначены для указания использования определенного ACL в запросе:

s3 - Доступ на чтение.
s3 - Права записи.
s3 - Доступ на чтение ACL бакета.
s3 - Права на запись ACL бакета.
s3 - Полный контроль.
s3 - Использование шаблонного ACL.

<?xml version="1.0" encoding="UTF-8"?><AccessControlPolicy xmlns="http://<имя_бакета>.hb.vkcs.cloud/images/01.jpg/">  <Owner>    <ID>Owner-canonical-user-ID</ID>    <DisplayName>display-name</DisplayName>  </Owner>  <AccessControlList>    <Grant>      <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="CanonicalUser">        <ID>Owner-canonical-user-ID</ID>        <DisplayName>display-name</DisplayName>      </Grantee>      <Permission>FULL_CONTROL</Permission>    </Grant>        <Grant>      <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="CanonicalUser">        <ID>user1-canonical-user-ID</ID>        <DisplayName>display-name</DisplayName>      </Grantee>      <Permission>WRITE</Permission>    </Grant>    <Grant>      <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="CanonicalUser">        <ID>user2-canonical-user-ID</ID>        <DisplayName>display-name</DisplayName>      </Grantee>      <Permission>READ</Permission>    </Grant>    <Grant>      <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="Group">        <URI>http://acs.amazonaws.com/groups/global/AllUsers</URI>       </Grantee>      <Permission>READ</Permission>    </Grant>    <Grant>      <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="Group">        <EmailAddress>project-ID</EmailAddress>      </Grantee>      <Permission>READ</Permission>    </Grant> </AccessControlList></AccessControlPolicy>

Cloud Storage поддерживает набор предопределенных разрешений, известных как стандартные списки ACL. Каждый фиксированный ACL имеет предопределенный набор получателей и разрешений. В следующей таблице перечислены стандартные списки ACL и связанные с ними предопределенные разрешения.

| Фиксированный ACL | Относится к | Разрешения добавлены в ACL |
| --- | --- | --- |
| private | Бакет и объект | Владелец получает FULL_CONTROL. Больше ни у кого нет прав доступа (по умолчанию). |
| public-read | Бакет и объект | Владелец получает FULL_CONTROL. Группа AllUsers получает READ доступ. |
| public-read-write | Бакет и объект | Владелец получает FULL_CONTROL. Группа AllUsers получает READ и WRITE доступ. |
| aws-exec-read | Бакет и объект | Владелец получает FULL_CONTROL. |
| authenticated-read | Бакет и объект | Владелец получает FULL_CONTROL. Группа AuthenticatedUsers получает READ доступ. |
| bucket-owner-read | Объект | Владелец объекта получает FULL_CONTROL. Владелец бакета получает READ доступ. Если указать этот шаблонный ACL при создании бакета, Cloud Storage проигнорирует его. |
| bucket-owner-full-control | Объект | И владелец объекта, и владелец бакета получают FULL_CONTROL над объектом. Если указать этот фиксированный ACL при создании бакета, Cloud Storage проигнорирует его. |

Hotbox предоставляет возможность управлять доступом к контейнерам и объектам с помощью списка управления доступа - ACL. У каждого контейнера и объекта есть свой список доступа. Этот список определяет каким проектам или глобальным группам предоставляются права доступа и соответствующие права доступа.При получении запроса на ресурс сервис проверяет соответствующий ACL на наличие прав доступа у запрашивающего.

При создании контейнера или объекта сервис создает стандартный ACL, который предоставляет владельцу ресурса право полного контроля над этим ресурсом, и запрещает доступ остальным проектам и глобальным группам. Это показано в следующем примере ACL бакета (стандартный ACL объекта имеет ту же структуру).

<?xml version="1.0" encoding="UTF-8"?><AccessControlPolicy xmlns="http://BucketName.hb.vkcs.cloud/doc/2006-03-01/">  <Owner>    <ID>***Owner-Canonical-User-ID***</ID>    <DisplayName>owner-display-name</DisplayName>  </Owner>  <AccessControlList>    <Grant>      <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:type="Canonical User">        <ID>***Owner-Canonical-User-ID***</ID>        <DisplayName>owner-display-name</DisplayName>      </Grantee>      <Permission>FULL_CONTROL</Permission>    </Grant>  </AccessControlList></AccessControlPolicy>

Блок Owner определяет владельца по каноническому идентификатору пользователя проекта и по домену.
Блок Grant определяет получателя прав (проект сервиса или глобальную группу) и предоставляемое право доступа.

Базовый ACL содержит один элемент Grant для владельца. Вы можете предоставлять права с помощью добавления элементов Grant, где каждый из них определяет получателя прав и соответствующее право доступа.

Получателем прав может являться проект сервиса или одна из глобальных групп сервиса. Вы можете предоставлять права проекту сервиса при помощи адреса электронной почты (домена) или канонического идентификатора проекта. При этом если вы указываете адрес электронной почты (домен) в вашем запросе на права доступа, то сервис определяет канонический идентификатор пользователя для соответствующего проекта и добавляет его в ACL. В результате ACL всегда будут содержать канонический идентификатор пользователя для проекта сервиса, а не адрес электронной почты проекта (домен).

У сервиса существует набор предопределенных групп. При предоставлении группе прав доступа к проекту вы указываете один из наших URI вместо канонического идентификатора пользователя. Сервисом предоставляются нижеуказанные глобальные группы.

Группа Authenticated Users — группа авторизованных пользователей.

Данная группа представляет собой все проекты сервиса. Наличие права доступа к этой группе позволяет любому проекту сервиса получать доступ к ресурсу. Но в то же время все запросы должны быть подписаны (авторизованы).

Группа All Users — группа всех пользователей.

Наличие права доступа к этой группе позволяет всем получать доступ к ресурсу. Запросы могут быть подписанными (авторизованными) или неподписанными (анонимными). В неподписанных запросах отсутствует заголовок аутентификации Authentication в запросе.

Следующая таблица содержит набор разрешений, поддерживаемых сервисом в ACL. Необходимо отметить, что набор разрешений ACL один и тот же для объекта и контейнера (за исключением запрета права WRITE на объекте).Нижеследующие таблицы содержат разрешения и описывают их в контексте разрешений объекта и контейнера.

| Разрешение | При предоставлении на контейнере | При предоставлении на объекте |
| --- | --- | --- |
| READ | Позволяет получателю прав получить список объектов в контейнере. | Позволяет получателю прав прочитать данные объекта и его метаданные. |
| WRITE | Позволяет получателю прав создавать, переписывать и удалять любой объект в контейнере. | Неприменимо. |
| READ_ACP | Позволяет получателю прав прочитать ACL контейнера. | Позволяет получателю прав прочитать ACL объекта. |
| WRITE_ACP | Позволяет получателю прав записывать ACL для соответствующего контейнера. | Позволяет получателю прав записывать ACL для соответствующего объекта. |
| FULL_CONTROL | Дает получателю прав следующие разрешения на контейнер: READ, WRITE, READ_ACP и WRITE_ACP. | Дает получателю прав следующие разрешения на объект: READ, READ_ACP и WRITE_ACP. |

Каждое из прав доступа позволяет провести в сервисе одну или несколько операций. Следующая таблица показывает соответствие прав доступа и операций.

| Разрешение ACL | Соответствующее разрешение политики доступа при предоставлении разрешения ACL на бакете | Соответствующее разрешение политики доступа при предоставлении разрешения ACL на объекте |
| --- | --- | --- |
| READ | HeadBucketListMultipartsListObjectsListParts | GetObjectHeadObject |
| WRITE | AbortMultipartUploadCompliteMultipartUploadInitiateMultipartUploadUploadPartPutObjectDeleteObject | Неприменимо |
| READ_ACP | GetBucketAcl | GetObjectAcl |
| WRITE_ACP | PutBucketAcl | PutObjectAcl |
| FULL_CONTROL | Эквивалентно предоставлению следующих разрешений ACL: READ, WRITE, READ_ACP и WRITE_ACP. | Эквивалентно предоставлению следующих разрешений ACL: READ, READ_ACP и WRITE_ACP. |

Сервис поддерживает набор предопределенных предоставлений разрешений — так называемых «готовых ACL». Каждый готовый ACL содержит предопределенный набор получателей прав и разрешений. Следующая таблица содержит набор готовых ACL и связанных с ними предопределенных предоставлений разрешений.

| Связанный ACL | Область применения | Добавленные в ACL разрешения |
| --- | --- | --- |
| private | Контейнер и объект | Владелец получает полные права (FULL_CONTROL). Остальные пользователи не получают прав доступа (по умолчанию). |
| public-read | Контейнер и объект | Владелец получает полные права (FULL_CONTROL). Группа всех пользователей Allusers получает право доступа на чтение (READ). |
| public-read-write | Контейнер и объект | Владелец получает полные права (FULL_CONTROL). Группа всех пользователей AllUsers получает права доступа на чтение (READ) и запись (WRITE). Как правило, не рекомендуется предоставлять данные разрешений на контейнер. |
| authenticated-read | Контейнер и объект | Владелец получает полные права (FULL_CONTROL). Группа авторизованных пользователей (AuthenticatedUsers) получает права доступа на чтение (READ). |
| bucket-owner-read | Объект | Владелец объекта получает полные права (FULL_CONTROL). Владелец бакета получает права на чтение (READ). |
| bucket-owner-full-control | Объект | Владелец объекта и владелец бакета получают полные права (FULL_CONTROL) на объект. |

API-сервис позволяет вам установить ACL при создании бакета или объекта. Сервис также предоставляет API для возможности установки ACL на существующем бакете или объекте. Эти API дают возможность устанавливать ACL с помощью нижеуказанных способов.

Установка ACL с помощью заголовков запроса — при отправке запроса по созданию ресурса (бакета или объекта) вы устанавливаете ACL при помощи заголовков запроса. Данные заголовки позволяют вам указать или готовый ACL, или установить предоставления разрешений явным образом (однозначно определить получателя прав и разрешения).
Установка ACL с помощью тела запроса — при отправке запроса по установке ACL на существующем ресурсе вы можете установить ACL или в заголовке запроса, или в теле.

Будьте внимательны когда устанавливаете новое право доступа. Политика назначения прав  доступа такова, что установлении прав доступа в некоторых случаях может видоизменяться ваш  ACL.  Например при установлении прав любой глобальной группе будут потеряны все права доступа для отдельных проектов. Чтобы этого не происходило вам нужно устанавливать все права доступа одновременно - только в этом случае утери прав доступа отдельными проектами не происходит

Рассмотрим пример. Вы завели проект client@bizmrg.ru и создали контейнер bucketname. Изначально контейнер частный — только вы имеете к нему доступ.

<?xml version="1.0" encoding="UTF-8"?><AccessControlPolicy xmlns="http://s3.amazonaws.com/doc/2006-03-01/">  <Owner>    <ID>client_canonical_id</ID>    <DisplayName>client@bizmrg.ru</DisplayName>  </Owner>  <AccessControlList>    <Grant>      <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="Canonical User">        <ID>client_canonical_id</ID>        <DisplayName>client@bizmrg.ru</DisplayName>      </Grantee>      <Permission>FULL_CONTROL</Permission>    </Grant>  </AccessControlList></AccessControlPolicy>

Допустим, вы захотели дать доступ на запись, удаление или перезапись объектов для вашего контейнера bucketname другому проекту friend_project@bizmrg.ru.

<?xml version="1.0" encoding="UTF-8"?><AccessControlPolicy xmlns="http://s3.amazonaws.com/doc/2006-03-01/">  <Owner>    <ID>***Owner-Canonical-User-ID***</ID>    <DisplayName>owner-display-name</DisplayName>  </Owner>  <AccessControlList>    <Grant>      <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="Canonical User">        <ID>friend_project_canonical_id</ID>        <DisplayName>friend_project@bizmrg.ru</DisplayName>      </Grantee>      <Permission>WRITE</Permission>    </Grant>  </AccessControlList></AccessControlPolicy>

Как вы видите, блок, содержащий ваши данные и предоставляемое право FULL_CONTROL (AccessControlPolicy.AccessControlList.Grant.Grantee, пропал. Однако это не значит что вы как владелец больше не обладаете правом FULL_CONTROL. Вы всегда владеете  этим правом и вас невозможно его лишить.

Данное поведение объясняется лишь синтаксисом ответа ACL, который требует наличие секций (AccessControlPolicy.AccessControlList.Grant.Grantee). Как вы можете заметить, при частном доступе на объекте никаким проектам или глобальным группам права не предоставляются.

Теперь, допустим, вы захотели сделать ваш контейнер публичным для чтения. Для этого есть два пути:

Добавить public ACL через заголовки x-amz-acl или x-amz-grant-read или через тело запроса:

**PUT /?acl HTTP/1.1** Authorization: authorization string Connection: close Date: Wed, 02 Aug 2017 09:53:13 GMT Host: bucketname.hb.vkcs.cloud X-amz-content-sha256: UNSIGNED-PAYLOAD X-amz-acl: public-read

**HTTP/1.1 200 OK** Server: nginx/1.12.1 Date: Wed, 02 Aug 2017 09:53:14 GMT Content-Type: text/html; charset=utf-8 Content-Length: 0 Connection: close X-req-id: iySm3Cph

Право WRITE для проекта friend_project@bizmrg.ru исчезло и теперь данный проект не может записывать, удалять, перезаписывать объекты в вашем контейнере. В блоках AccessControlPolicy.AccessControlList.Grant вы увидите информацию о пользователя который установил публичный ACL и сам публичный ACL.

Для сохранения прав доступа у проекта friend_project@bizmrg.ru  вам необходимо за один запрос установить права доступа и глобальной группе и вашему пользователю:

**PUT /?acl HTTP/1.1** Authorization: authorization string Connection: close Content-Length: 417 Date: Wed, 02 Aug 2017 09:53:13 GMT Host: bucketname.hb.vkcs.cloud X-amz-content-sha256: UNSIGNED-PAYLOAD