Управление доступом в Certificate Manager
В этом разделе вы узнаете:
- на какие ресурсы можно назначить роль;
- какие роли действуют в сервисе;
- какие роли необходимы для того или иного действия.
Об управлении доступом
Все операции в Yandex Cloud проверяются в сервисе Yandex Identity and Access Management. Если у субъекта нет необходимых разрешений, сервис вернет ошибку.
Чтобы выдать разрешения к ресурсу, назначьте роли на этот ресурс субъекту, который будет выполнять операции. Роли можно назначить аккаунту на Яндексе, сервисному аккаунту, федеративным пользователям или группе пользователей. Подробнее читайте в разделе Как устроено управление доступом в Yandex Cloud.
Назначать роли на ресурс могут пользователи, у которых на этот ресурс есть роль certificate-manager.admin
или одна из следующих ролей:
admin
;resource-manager.admin
;organization-manager.admin
;resource-manager.clouds.owner
;organization-manager.organizations.owner
.
На какие ресурсы можно назначить роль
Роль можно назначить на организацию, облако и каталог. Роли, назначенные на организацию, облако или каталог, действуют и на вложенные ресурсы.
На пользовательский сертификат роль можно назначить через YC CLI или API Yandex Cloud.
Какие роли действуют в сервисе
На диаграмме показано, какие роли есть в сервисе и как они наследуют разрешения друг друга. Например, в editor
входят все разрешения viewer
. После диаграммы дано описание каждой роли.
Сервисные роли
certificate-manager.auditor
Роль certificate-manager.auditor
позволяет просматривать информацию о сертификатах и доменах, а также о привязках прав доступа к ним.
Пользователи с этой ролью могут:
- просматривать список сертификатов и зависимых ресурсов, а также информацию о сертификатах и о привязках прав доступа к ним;
- просматривать список доменов и зависимых ресурсов, а также информацию о доменах и о привязках прав доступа к ним;
- просматривать информацию о квотах сервиса Certificate Manager.
certificate-manager.viewer
Роль certificate-manager.viewer
позволяет просматривать информацию о сертификатах и доменах, а также о привязках прав доступа к ним.
Пользователи с этой ролью могут:
- просматривать список сертификатов и зависимых ресурсов, а также информацию о сертификатах и о привязках прав доступа к ним;
- просматривать список доменов и зависимых ресурсов, а также информацию о доменах и о привязках прав доступа к ним;
- просматривать информацию о квотах сервиса Certificate Manager.
Включает разрешения, предоставляемые ролью certificate-manager.auditor
.
certificate-manager.editor
Роль certificate-manager.editor
позволяет управлять сертификатами и доменами, просматривать информацию о них, о привязках прав доступа к ним и о квотах сервиса Certificate Manager.
Пользователи с этой ролью могут:
- просматривать список сертификатов и зависимых ресурсов, а также информацию о сертификатах и привязках прав доступа к ним;
- добавлять, изменять, обновлять и удалять сертификаты;
- просматривать список доменов и зависимых ресурсов, а также информацию о доменах и привязках прав доступа к ним;
- создавать, изменять и удалять домены, а также привязывать сертификаты к доменам;
- просматривать информацию о квотах сервиса Certificate Manager.
Включает разрешения, предоставляемые ролью certificate-manager.viewer
.
certificate-manager.admin
Роль certificate-manager.admin
позволяет управлять сертификатами, доменами и доступом к ним, а также получать содержимое сертификатов.
Пользователи с этой ролью могут:
- просматривать список сертификатов и зависимых ресурсов, а также информацию о сертификатах;
- просматривать информацию о привязках прав доступа к сертификатам и изменять такие привязки;
- добавлять, изменять, обновлять и удалять сертификаты;
- получать содержимое сертификатов;
- просматривать список доменов и зависимых ресурсов, а также информацию о доменах;
- просматривать информацию о привязках прав доступа к доменам и изменять такие привязки;
- создавать, изменять и удалять домены, а также привязывать сертификаты к доменам;
- просматривать информацию о квотах сервиса Certificate Manager;
- просматривать информацию о каталоге.
Включает разрешения, предоставляемые ролью certificate-manager.editor
.
certificate-manager.certificates.downloader
Роль certificate-manager.certificates.downloader
позволяет просматривать список сертификатов и информацию о них, а также получать содержимое сертификатов.
Примитивные роли
auditor
Позволяет просматривать конфигурацию и метаданные сервиса без возможности доступа к данным.
viewer
Позволяет просматривать информацию о ресурсах.
editor
Позволяет управлять ресурсами, например создавать, изменять и удалять их.
admin
Позволяет управлять ресурсами и доступом к ним.
Подробнее о примитивных ролях см. в справочнике ролей Yandex Cloud.
Какие роли мне необходимы
В таблице ниже перечислено, какие роли нужны для выполнения указанного действия. Вы всегда можете назначить роль, которая дает более широкие разрешения, нежели указанная. Например, назначить editor
вместо viewer
.
Действие | Методы | Необходимые роли |
---|---|---|
Certificate Manager | ||
Получение списков сертификатов или доменов | list |
viewer на каталог |
Получение информации о сертификате или домене | get |
viewer на сертификат или каталог |
Добавление сертификата от Let's Encrypt | requestNew |
editor на каталог |
Изменение, удаление сертификата от Let's Encrypt | update , delete |
editor на сертификат или каталог |
Добавление пользовательского сертификата | create |
editor на каталог |
Обновление, изменение, удаление пользовательского сертификата | update , delete |
editor на сертификат или каталог |
Получение содержимого сертификата: пользовательского или сертификата от Let's Encrypt | get-content |
certificate-manager.certificates.downloader на сертификат или каталог |
Добавление домена | create |
editor на каталог |
Изменение домена и удаление домена | update , delete |
editor на домен или каталог |
Обновление сертификата у домена | setPrimaryCertificate |
editor на домен или каталог |
IAM | ||
Назначение роли, отзыв роли и просмотр назначенных ролей на каталог или облако | setAccessBinding , updateAccessBindings , listAccessBindings |
admin или certificate-manager.admin на сертификат, домен или каталог |