Access management in Certificate Manager
In this section, you will learn:
- Which resources you can assign a role for.
- Which roles exist in the service.
- Which roles are required for particular actions.
About access management
In Yandex Cloud, all transactions are checked in Yandex Identity and Access Management. If a subject does not have the required permission, the service returns an error.
To grant permission for a resource, assign roles for this resource to the subject that will perform operations. Roles can be assigned to a Yandex account, a service account, federated users, a user group, or a system group. For more information, see How access management works in Yandex Cloud.
Only users with the admin
, resource-manager.clouds.owner
, or organization-manager.organizations.owner
role for a resource can assign roles for this resource.
Which resources you can assign a role for
You can assign a role for a cloud, folder, or certificate. These roles also apply to nested resources.
Which roles exist in the service
The chart below shows which roles are available in the service and how they inherit each other's permissions. For example, the editor
role includes all the permissions of viewer
. You can find the description of each role under the chart.
Service roles
certificate-manager.auditor
The certificate-manager.auditor
role allows you to get information about valid and revoked certificates, a list of certificates, their versions, and permissions to certificates, information about domains, a list of domains, and permissions to domains, as well as information about quotas.
certificate-manager.viewer
The certificate-manager.viewer
role allows getting information about valid and revoked certificates, a list of certificates, their versions, and permissions to certificates, information about domains, a list of domains, and permissions to domains, as well as information about quotas.
Includes all permissions granted by the certificate-manager.auditor
role.
certificate-manager.editor
The certificate-manager.editor
role enables you to add, modify, update, reissue, delete, and revoke certificates, link them to domains, as well as create, update, and delete domains. The role also allows users to get information about valid and revoked certificates, a list of certificates, their versions, and permissions to certificates, information about domains, a list of domains, and permissions to domains, as well as information about quotas.
certificate-manager.admin
The certificate-manager.admin
role lets you manage certificates and access them.
certificate-manager.certificates.downloader
The certificate-manager.certificates.downloader
role lets you get the contents of a certificate.
Primitive roles
auditor
Grants permission to view service configuration and metadata without access to data.
viewer
Enables you to view information about resources.
editor
Allows you to manage resources, e.g., create, edit, and delete them.
admin
Allows you to manage your resources and access to them.
For more information about primitive roles, see Roles.
What roles do I need
The table below lists the roles needed to perform a particular action. You can always assign a role granting more permissions than the role specified. For example, you can assign the editor
role instead of the viewer
one.
Action | Methods | Required roles |
---|---|---|
Certificate Manager | ||
Getting a list of certificates or domains | list |
viewer for a folder |
Getting certificate or domain details | get |
viewer for a certificate or folder |
Adding a Let's Encrypt certificate | requestNew |
editor for the folder |
Updating and deleting a Let's Encrypt certificate | update , delete |
editor for the certificate or folder |
Adding a custom certificate | create |
editor for the folder |
Renewing, updating, or deleting a custom certificate | update , delete |
editor for the certificate or folder |
Getting the contents of a custom certificate or Let's Encrypt certificate | get-content |
certificate-manager.certificates.downloader for the certificate or folder |
Adding a domain | create |
editor for the folder |
Updating a domain and deleting a domain | update , delete |
editor for the domain or folder |
Updating a domain certificate | setPrimaryCertificate |
editor for the domain or folder |
IAM | ||
Assigning a role, revoking a role, and viewing the roles assigned for a folder or cloud | setAccessBinding , updateAccessBindings , listAccessBindings |
admin or certificate-manager.admin for the certificate, domain, or folder |