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

В Object Storage реализовано несколько механизмов для управления доступом к ресурсам. Алгоритм взаимодействия этих механизмов см. в Обзор способов управления доступом в Object Storage.

ACL Object Storage — список разрешений для каждого объекта и бакета, хранящийся непосредственно в Object Storage.

Разрешения, выданные на бакет, распространяются на все находящиеся в нем объекты. Также ACL позволяет расширить доступы к отдельному объекту.

Например, если у пользователя в сервисе IAM есть роль viewer на каталог с бакетом, то он может просматривать его содержимое, даже если это не отражено в ACL бакета.

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

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

В консоли управления разрешения можно выдать только тем сервисным аккаунтам, которые созданы в том же каталоге, что и сам бакет. Выдать разрешения для сервисных аккаунтов, относящихся к другим каталогам, можно с помощью YC CLI (только для ACL бакета), AWS CLI, Terraform или API.

Описание структуры ACL смотрите в разделе XML-схема ACL. В одном ACL вы можете задать не более 100 правил.

Идентификатор получателя разрешенийИдентификатор получателя разрешений

• Пользователь Yandex Cloud

  Идентификатор можно получить:

  • В разделе IAM консоли управления.
  • С помощью CLI или API IAM.

• Сервисный аккаунт

  Для получения идентификатора в консоли управления в списке сервисов выберите Identity and Access Management, на панели слева выберите Сервисные аккаунты и выберите нужный сервисный аккаунт.

• Публичная группа

  Для выдачи разрешений используйте URI публичной группы.

• Группа пользователей

  Для получения идентификатора перейдите на вкладку Группы в интерфейсе Cloud Center.

  Задать группу пользователей можно с помощью Yandex Cloud CLI, AWS CLI, Terraform и API. Подробнее см. на страницах Редактирование ACL бакета и Редактирование ACL объекта.

Операции с ACLОперации с ACL

• В консоли управления вы можете редактировать ACL для бакетов и объектов.

• С помощью API, совместимого с Amazon S3, вы можете загрузить или скачать ACL для бакета или объекта.

  Удалить ACL невозможно. Чтобы удалить все разрешения, загрузите пустой ACL.

Виды разрешенийВиды разрешений

Разрешения соответствуют ролям пользователей в IAM.

Предопределенные ACLПредопределенные ACL

Предопределенные ACL могут применяться как к объектам, так и к бакетам. ACL public-read-write, примененный к объекту, эквивалентен public-read.

Загрузить предопределенный ACL можно только с помощью HTTP API, совместимого с Amazon S3. При загрузке ACL используйте HTTP-заголовок X-Amz-Acl.

Публичные группыПубличные группы

AllUsersAllUsers

Включает в себя всех пользователей интернета.

Разрешение для AllUsers выглядит следующим образом:

<Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="Group">
    <URI>http://acs.amazonaws.com/groups/global/AllUsers</URI>
</Grantee>

AuthenticatedUsersAuthenticatedUsers

Включает в себя всех аутентифицированных пользователей Yandex Cloud: как из вашего облака, так и из облаков других пользователей.

Разрешение для AuthenticatedUsers выглядит следующим образом:

<Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="Group">
    <URI>http://acs.amazonaws.com/groups/global/AuthenticatedUsers</URI>
</Grantee>

Наследование прав доступа к бакету публичными группами Yandex CloudНаследование прав доступа к бакету публичными группами Yandex Cloud

Бакет наследует такие же права доступа в сервисе IAM, как у каталога и облака, в котором он находится. Если у пользователя есть права доступа к каталогу или облаку, которым принадлежит бакет, то у него будут права доступа и к самому бакету.

Как посмотреть права на бакет, наследуемые от каталогаКак посмотреть права на бакет, наследуемые от каталога

Бакет наследует права от каталога. Если вы хотите знать, какие именно права унаследовал бакет, получите список ролей на каталог. Также вы можете в любой момент отозвать эти роли.

• Чтобы получить список ролей на каталог, выполните команду:

  yc resource-manager folder list-access-bindings \
    --id b1g7gvsi89m3********
  

  Результат:

  +---------+--------------+-----------------------+
  | ROLE ID | SUBJECT TYPE |      SUBJECT ID       |
  +---------+--------------+-----------------------+
  | viewer  | system       | allAuthenticatedUsers |
  | viewer  | system       | allUsers              |
  +---------+--------------+-----------------------+
  

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

• Чтобы отозвать роль у публичной группы All authenticated users выполните команду:

  yc resource-manager folder remove-access-binding \
    --id b1g7gvsi89m3******** \
    --role viewer \
    --allAuthenticatedUsers
  

• Чтобы отозвать роль у публичной группы All users выполните команду:

  yc resource-manager folder remove-access-binding \
    --id b1g7gvsi89m3******** \
    --role viewer \
    --allUsers
  

См. такжеСм. также

• Редактирование ACL бакета
• Редактирование ACL объекта