API-ключ
API-ключ — секретный ключ, используемый для упрощенной авторизации в API Yandex Cloud. API-ключи используются только для авторизации сервисного аккаунта.
API-ключи не имеют срока действия, поэтому этот способ аутентификации проще, но менее безопасный. Используйте его, если у вас нет возможности автоматически запрашивать IAM-токен.
Внимание
Если кто-то мог узнать ваш секретный ключ, удалите его и создайте новый.
Пользователь самостоятельно хранит API-ключ. Yandex Cloud предоставляет доступ к API-ключу только в процессе его создания. Если ключ утрачен или поврежден, восстановить его нельзя. В этом случае вы можете перевыпустить ключ или создать новый.
В консоли управления на странице с информацией о сервисном аккаунте для каждого ключа отображаются дата и время его последнего использования. Эта информация позволяет отслеживать случаи несанкционированного использования ключей, а также удалять неиспользуемые ключи без риска нарушить работу сервисов Yandex Cloud.
Использование токена
Полученный API-ключ указывайте при обращении к ресурсам Yandex Cloud через API. Передавайте API-ключ в заголовке Authorization в следующем формате:
Authorization: Api-Key <API-ключ>
Сервисы, поддерживающие этот способ аутентификации
API-ключи в качестве способа аутентификации поддерживают несколько сервисов:
- Yandex Cloud Functions
- Yandex DataSphere
- Yandex Search API
- Yandex SpeechKit
- Yandex SpeechSense
- Yandex Translate
- Yandex Vision OCR