[Документация Yandex Cloud](../../../index.md) > [Yandex Cloud Registry](../../index.md) > [Пошаговые инструкции](../index.md) > Управление артефактами > Docker-образ > Аутентифицироваться в Cloud Registry # Аутентифицироваться в Cloud Registry Перед началом работы с Cloud Registry необходимо [настроить Docker](installation.md) и аутентифицироваться для соответствующего интерфейса: * Для консоли управления минимально необходимая [роль](../../../iam/concepts/access-control/roles.md) на [каталог](../../../resource-manager/concepts/resources-hierarchy.md#folder) — `viewer`. * Для Docker CLI или Yandex Managed Service for Kubernetes минимально необходимая роль на [реестр](../../concepts/registry.md) — `cloud-registry.artifacts.puller`. Назначьте нужную роль пользователю Yandex Cloud. Ознакомьтесь со [способами аутентификации](#method) и выберите подходящий. Подробнее про роли читайте в разделе [Управление доступом в Yandex Cloud Registry](../../security/index.md). ## Способы аутентификации {#method} Вы можете аутентифицироваться: * [Как пользователь](#user): * С помощью IAM-токена. Время жизни — не более 12 часов. * С помощью API-ключа и сервисного аккаунта. [Время жизни](../../../iam/concepts/authorization/api-key.md#scoped-api-keys) API-ключа ограничивается вручную при создании. * [С помощью хранилища учетных данных Docker credential helper](#cred-helper). ## Аутентифицироваться как пользователь {#user} {% list tabs group=registry_auth %} - С помощью IAM-токена {#iam-token} {% note info %} У IAM-токена короткое [время жизни](../../../iam/concepts/authorization/iam-token.md#lifetime) — не более 12 часов. Поэтому такой способ подойдет для приложений, которые будут запрашивать IAM-токен автоматически. {% endnote %} 1. Если у вас не установлен Docker, [установите](installation.md) его. 1. [Получите](../../../iam/operations/iam-token/create.md) IAM-токен. 1. Выполните команду: ```bash echo | docker login \ --username iam \ --password-stdin \ registry.yandexcloud.net ``` Где: * `` — тело полученного ранее IAM-токена. * `--username` — тип токена: значение `iam` указывает, что для аутентификации используется IAM-токен. * `registry.yandexcloud.net` — эндпоинт, к которому будет обращаться [Docker](https://yandex.cloud/ru-kz/blog/posts/2022/03/docker-containers) при работе с реестром Docker-образов. Если его не указать, запрос пойдет в сервис по умолчанию — [Docker Hub](https://hub.docker.com). - С помощью API-ключа {#api-key} 1. Если у вас не установлен Docker, [установите](installation.md) его. 1. [Создайте](../../../iam/operations/authentication/manage-api-keys.md#create-api-key) API-ключ для [сервисного аккаунта](../../../iam/concepts/users/service-accounts.md), от имени которого вы будете выполнять аутентификацию. 1. Выполните команду: ```bash echo | docker login \ --username api_key \ --password-stdin \ registry.yandexcloud.net ``` Где: * `` — тело созданного ранее API-ключа. * `--username` — тип токена: значение `api_key` указывает, что для аутентификации используется API-ключ. * `registry.yandexcloud.net` — эндпоинт, к которому будет обращаться [Docker](https://yandex.cloud/ru-kz/blog/posts/2022/03/docker-containers) при работе с реестром образов. Если его не указать, запрос пойдет в сервис по умолчанию — [Docker Hub](https://hub.docker.com). {% endlist %} Если при выполнении команды вы получили сообщение об ошибке `docker login is not supported with yc credential helper`, [отключите Docker credential helper](#ch-not-use). ## Аутентифицироваться с помощью Docker credential helper {#cred-helper} Docker Engine может хранить учетные данные пользователя во внешнем хранилище. Такой способ безопаснее, чем хранение учетных данных в конфигурационном файле Docker. Чтобы использовать хранилище учетных данных, необходима внешняя программа — [Docker credential helper](https://docs.docker.com/engine/reference/commandline/login/#credential-helpers). В состав [Yandex Cloud CLI](../../../cli/quickstart.md) входит утилита `docker-credential-yc`, которая выступает в роли Docker credential helper для Yandex Cloud. Она хранит учетные данные пользователя и позволяет работать с приватными реестрами Yandex Cloud, не выполняя команду `docker login`. ### Настройка credential helper {#ch-setting} Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), [установите и инициализируйте его](../../../cli/quickstart.md#install). По умолчанию используется каталог, указанный при [создании](../../../cli/operations/profile/profile-create.md) профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду `yc config set folder-id <идентификатор_каталога>`. Также для любой команды вы можете указать другой каталог с помощью параметров `--folder-name` или `--folder-id`. Если вы обращаетесь к ресурсу по имени, поиск будет выполнен в каталоге по умолчанию. Если вы обращаетесь к ресурсу по идентификатору, поиск будет выполнен глобально — во всех каталогах с учетом прав доступа. 1. Сконфигурируйте Docker для использования `docker-credential-yc`: ```bash yc cloud-registry configure-docker ``` Результат: ```text Credential helper is configured in '/home//.docker/config.json' ``` Настройки сохраняются в профиле текущего пользователя. {% note warning %} Credential helper работает только при использовании Docker без `sudo`. О том, как настроить запуск Docker от имени текущего пользователя без использования `sudo`, читайте в [официальной документации Docker](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user). {% endnote %} 1. Проверьте, что Docker сконфигурирован. В конфигурационном файле `${HOME}/.docker/config.json` должна появиться строка: ```json "registry.yandexcloud.net": "yc" ``` 1. Docker готов к использованию, например, для [загрузки Docker-образов](push.md). ### Дополнительные опции credential helper {#ch-feature} #### Использовать credential helper для другого профиля Yandex Cloud CLI {#ch-profile} Вы можете использовать credential helper для другого профиля, не переключая текущий, с помощью команды: ```bash yc cloud-registry configure-docker --profile <имя_профиля> ``` Подробнее об управлении профилями читайте в [пошаговых инструкциях Yandex Cloud CLI](../../../cli/operations/index.md#profile). #### Не использовать credential helper {#ch-not-use} Чтобы не использовать credential helper при аутентификации, удалите в конфигурационном файле `${HOME}/.docker/config.json` из блока `credHelpers` строку с доменом `registry.yandexcloud.net`.