Аутентификация в Yandex Cloud CLI с IAM-токеном из переменной окружения

IAM-токен — это уникальная последовательность символов, которая подтверждает личность пользователя или сервисного аккаунта и используется для аутентификации в Yandex Cloud. IAM-токен действует не больше 12 часов.

Аутентификацию с IAM-токеном из переменной окружения YC_IAM_TOKEN удобно использовать в скриптах, CI/CD-процессах, автоматических тестах, контейнерах и временных рабочих окружениях, где не подходит интерактивная аутентификация или хранение учетных данных в профиле CLI. Для автоматизации используйте IAM-токен сервисного аккаунта с необходимыми ролями. Настройте получение нового IAM-токена до истечения срока действия текущего.

Перед началом работыПеред началом работы

1. Установите Yandex Cloud CLI.

2. Получите IAM-токен.

   • Аккаунт на Яндексе
   • Сервисный аккаунт
   • Федеративный аккаунт
   • Аккаунт локального пользователя

Аутентифицируйтесь с IAM-токеномАутентифицируйтесь с IAM-токеном

1. Добавьте IAM-токен в переменную окружения YC_IAM_TOKEN:

   macOS/Linux

   Windows (PowerShell)

   export YC_IAM_TOKEN="<IAM-токен>"
   

   $env:YC_IAM_TOKEN = "<IAM-токен>"
   

   Переменная будет доступна в текущем сеансе командной оболочки и запущенных из него процессах.

   Важно

   Значение из переменной окружения YC_IAM_TOKEN переопределяет учетные данные для аутентификации, заданные в профиле CLI.

2. Выполните команду CLI, например получите список виртуальных машин в каталоге:

   yc compute instance list
   

Удалите IAM-токен из переменной окруженияУдалите IAM-токен из переменной окружения

Чтобы в CLI снова использовались учетные данные из профиля, удалите переменную окружения YC_IAM_TOKEN:

unset YC_IAM_TOKEN

Remove-Item Env:YC_IAM_TOKEN

Полезные ссылкиПолезные ссылки

• IAM-токен

• Получение IAM-токена для аккаунта на Яндексе

• Получение IAM-токена для сервисного аккаунта

• Получение IAM-токена для федеративного аккаунта

• Получение IAM-токена для аккаунта локального пользователя

• Отзыв IAM-токена

• Аутентификация в Yandex Cloud CLI с аккаунтом на Яндексе

• Аутентификация в Yandex Cloud CLI от имени сервисного аккаунта

• Аутентификация в Yandex Cloud CLI от имени федеративного пользователя

• Аутентификация в Yandex Cloud CLI от имени локального пользователя

• Аутентификация в Yandex Cloud CLI на сервере без графического интерфейса

• Решение проблем с Yandex Cloud CLI