IAM-токен
IAM-токен (токен) — уникальная последовательность символов, которая выдается пользователю после прохождения аутентификации. С помощью этого токена пользователь авторизуется в API Яндекс.Облака и выполняет операции с ресурсами.
Использование токена
Полученный IAM-токен указывайте при обращении к ресурсам Яндекс.Облака через API. Передайте IAM-токен в заголовке Authorization в следующем формате:
Authorization: Bearer <IAM-TOKEN>
Если пользователь работает через консоль управления или интерфейса командной строки (CLI), то процесс получения и использования токена незаметен для пользователя.
Время жизни
Обычно IAM-токен действует 12 часов, но рекомендуется запрашивать новый токен чаще, например каждый час. Так не возникнет ситуации, что единственный токен истек в тот момент, когда IAM по какой-то причине не может создать для вас новый токен.
Если вы получаете IAM-токен через сервер метаданных изнутри виртуальной машины, то его время жизни может быть меньше, так как сервер метаданных не создает новый токен, а возвращает последний созданный. Новые токены создаются периодически.
Вместе с IAM-токеном сервер метаданных возвращает оставшееся время жизни токена. Учитывайте время жизни IAM-токена или запрашивайте токен чаще, например каждый час или при каждой операции.
Сервисы, поддерживающие этот способ аутентификации
Этот способ авторизации поддерживают все сервисы, кроме сервисов с AWS-совместимым API (в них IAM-токен нужен только для управления ключами доступа и сервисными аккаунтами).