Access management in Container Registry

In this section, you will learn about:

• Resources you can assign a role for.
• Roles this service has.
• Roles required for specific actions.

Access managementAccess management

Yandex Identity and Access Management checks all operations in Yandex Cloud. If an entity does not have required permissions, IAM returns an error.

To grant permissions for a resource, assign the relevant resource roles to an entity performing operations. You can assign roles to a Yandex account, service account, local user, federated user, user group, system group, or public group. For more information, see How access management works in Yandex Cloud.

To assign a role for a resource, you need the container-registry.admin role or one of the following roles for that resource:

• admin
• resource-manager.admin
• organization-manager.admin
• resource-manager.clouds.owner
• organization-manager.organizations.owner

Resources you can assign a role forResources you can assign a role for

You can assign a role to an organization, cloud, or folder. The roles assigned to organizations, clouds, and folders also apply to their nested resources.

You can also assign roles for individual resources within the service:

Roles this service hasRoles this service has

The chart below shows service’s roles and their permission inheritance. For example, editor inherits all viewer permissions. You can find role descriptions below the chart.

Service rolesService roles

container-registry.viewercontainer-registry.viewer

The container-registry.viewer role enables viewing info on registries, Docker images, and repositories, as well as on the relevant folder, cloud, and Container Registry quotas.

Users with this role can:

• View the list of registries, info on them and the access permissions granted for them, as well as on the access policy settings for IP addresses and the vulnerability scanner settings.
• View info on repositories and the access permissions granted for them.
• View the list of the Docker image auto-delete policies and info on them.
• View the list of the testing results for Docker image auto-delete policies and info on such results.
• View the list of Docker images in the registry and the info on them, as well as download Docker images from the registry.
• View the Docker image vulnerability scan history and the info on the result of such scans.
• View info on the Container Registry quotas.
• View info on the relevant cloud and folder.

container-registry.editorcontainer-registry.editor

The container-registry.editor role enables managing registries, Docker images, repositories, and their settings.

Users with this role can:

• View the list of registries and info on them, as well as create, modify, and delete them.
• View info on the access permissions granted for registries, as well as on the access policy settings for IP addresses.
• View info on the vulnerability scanner settings, as well as create, modify, and delete scan rules.
• View the list of Docker images in the registry and info on them, as well as create, download, modify, and delete them.
• Start and cancel Docker image vulnerability scans, as well as view scan history and the info on scan results.
• View info on repositories and the access permissions granted for them, as well as create and delete repositories.
• View the list of the Docker image auto-delete policies and info on them, as well as create, modify, and delete such policies.
• Test the Docker image auto-delete policies, view the list of testing results and the info on such results.
• View info on the Container Registry quotas.
• View info on the relevant cloud and folder.

This role includes the container-registry.viewer permissions.

container-registry.admincontainer-registry.admin

The container-registry.admin role enables managing access to registries and repositories, as well as managing registries, Docker images, repositories and their settings.

Users with this role can:

• View the list of registries and info on them, as well as create, modify, and delete them.
• View info on granted access permissions to registries and modify such permissions.
• View info on the access policy settings for IP address and modify such settings.
• View info on the vulnerability scanner settings, as well as create, modify, and delete scan rules.
• View the list of Docker images in the registry and info on them, as well as create, download, modify, and delete them.
• Start and cancel Docker image vulnerability scans, as well as view scan history and the info on scan results.
• View info on repositories, as well as create and delete them.
• View info on granted access permissions to repositories and modify such permissions.
• View the list of the Docker image auto-delete policies and info on them, as well as create, modify, and delete such policies.
• Test the Docker image auto-delete policies, view the list of testing results and the info on such results.
• View info on the Container Registry quotas.
• View info on the relevant cloud and folder.

This role includes the container-registry.editor permissions.

container-registry.images.pushercontainer-registry.images.pusher

The container-registry.images.pusher role enables managing Docker images and repositories, as well as viewing info on Docker images, repositories, and registries.

Users with this role can:

• View the list of registries and info on them.
• View the list of Docker images in the registry and info on them, as well as push, download, update, and delete them.
• Create and delete repositories.

container-registry.images.pullercontainer-registry.images.puller

The container-registry.images.puller role enables downloading Docker images from the registry and viewing the list of registries and Docker images, as well as info on them.

container-registry.images.scannercontainer-registry.images.scanner

The container-registry.images.scanner role enables scanning Docker images for vulnerabilities, as well as viewing info on registries, Docker images, repositories, the relevant cloud and folder, and the Container Registry quotas.

Users with this role can:

• View the list of Docker images in the registry and info on them, as well as download Docker images from the registry.
• Start and cancel Docker image vulnerability scans, as well as view scan history and the info on scan results.
• View the list of registries, info on them and the access permissions granted for them, as well as on the access policy settings for IP addresses and the vulnerability scanner settings.
• View info on repositories and the access permissions granted for them.
• View the list of the Docker image auto-delete policies and info on them.
• View the list of the testing results for Docker image auto-delete policies and info on such results.
• View info on the Container Registry quotas.
• View info on the relevant cloud and folder.

This role includes the container-registry.viewer permissions.

To learn more about service roles, see Roles in the Yandex Identity and Access Management guides.

Primitive rolesPrimitive roles

Primitive roles allow users to perform actions in all Yandex Cloud services.

auditorauditor

The auditor role grants a permission to read configuration and metadata of any Yandex Cloud resources without any access to data.

For instance, users with this role can:

• View info on a resource.
• View the resource metadata.
• View the list of operations with a resource.

auditor is the most secure role that does not grant any access to the service data. This role suits the users who need minimum access to the Yandex Cloud resources.

viewerviewer

The viewer role grants the permissions to read the info on any Yandex Cloud resources.

This role includes the auditor permissions.

Unlike auditor, the viewer role provides access to service data in read mode.

editoreditor

The editor role provides permissions to manage any Yandex Cloud resources, except for assigning roles to other users, transferring organization ownership, removing an organization, and deleting Key Management Service encryption keys.

For instance, users with this role can create, modify, and delete resources.

This role includes the viewer permissions.

adminadmin

The admin role enables assigning any roles, except for resource-manager.clouds.owner and organization-manager.organizations.owner, and provides permissions to manage any Yandex Cloud resources (except for transferring organization ownership and removing an organization).

Prior to assigning the admin role for an organization, cloud, or billing account, make sure to check out the information on protecting privileged accounts.

This role includes the editor permissions.

Instead of primitive roles, we recommend using service roles with more granular access control, allowing you to implement the least privilege principle.

For more information on primitive roles, see the Yandex Cloud role reference.

Required rolesRequired roles

The table below lists the roles required for specific actions. You can always assign a role with more permissions, e.g., editor instead of viewer.

Action	Methods	Required roles
Viewing data
Getting a list of registries	list	container-registry.viewer for the folder
Getting information about registries, Docker images, and repositories	get, list	container-registry.viewer for the registry containing the resource
Pulling a Docker image	pull	container-registry.images.puller for the registry or repository
Getting information about lifecycle policies and results of their dry runs	get, list, getDryRunResult, listDryRunResults	container-registry.viewer for the registry or repository for which the lifecycle policy was created
Managing resources
Creating registries in a folder	create	container-registry.editor for the folder
Updating and deleting registries	update, delete	container-registry.editor for the registry
Creating Docker images using base Docker images from the registry	—	container-registry.images.puller for the registry or repository
Creating Docker images without using base Docker images from the registry	—	No roles required
Pushing Docker images to a registry	push	container-registry.images.pusher for the registry or repository
Deleting Docker images	delete	container-registry.images.pusher for the registry or repository containing the Docker image
Creating, editing, deleting, and performing a dry run of a lifecycle policy	create, update, delete, dryRun	container-registry.editor for the registry or repository for which the lifecycle policy was created
Managing resource access
Assigning a role, revoking a role, and viewing the roles assigned for a folder, cloud, or registry	setAccessBindings, updateAccessBindings, listAccessBindings	admin for the resource
Scanning for vulnerabilities
Scanning a Docker image	scan	container-registry.images.scanner for the registry or repository containing the Docker image
Getting the results of a Docker image scan	get, getLast, list, listVulnerabilities	container-registry.images.scanner for the registry or repository containing the Docker image

What's next {what-is-next}What's next

• Assigning a role.
• Viewing assigned roles.
• Revoking a role.
• Learn more about access management in Yandex Cloud.
• Learn more about role inheritance.