Почему стало важным безопасно хранить ключи в Gemini Managed Agents
Современные ИИ-агенты часто работают в изолированной Linux-песочнице — виртуальной среде, где запускается код с ограниченными правами. При работе с внешними сервисами (GitHub, Notion, API) агенту нужны секреты — токены, ключи для авторизации. Если просто передавать секреты через переменные окружения, любой скрипт в контейнере может их прочитать и случайно или намеренно «слить». Появилась новая Credentials API для Gemini Managed Agents, которая решает эту проблему.
Для вас как пользователя это значит: теперь можно безопасно использовать агента с внешними сервисами, не опасаясь утечки ключей даже если в песочнице есть сторонний код.
Как устроена Credentials API и в чём её преимущества
Credentials API — это интерфейс для управления секретами, который реализован таким образом:
-
Секреты записываются один раз и шифруются. Сервисы Gemini хранят учетные данные (ключи, токены) в зашифрованном виде. При запросе на создание учетной записи (credentials.create()) возвращается только метаданная — ID, тип и статус, сама секретная строка не возвращается никуда, исключая утечки.
-
Типы учетных данных для разных случаев:
- bearer_token — обычные токены и API-ключи, которые агент вставляет в HTTP-заголовок Authorization или в кастомный заголовок;
- oauth2 — токены с обновлением (refresh_token, client_id и client_secret), которые Gemini самостоятельно обновляет по расписанию;
- environment_variable — секреты, которые обычно читаются из переменных окружения CLI/SDK. Здесь в контейнере у агента будет заглушка (_GEMINI_CRED
__), а реальный ключ подставляет egress proxy только для доверенных доменов.
-
Использование по ID. Вместо передачи секретов напрямую, агент и подключаемые инструменты получают только ID учетных данных. При обращении к внешнему сервису прокси проверяет целевой домен и только тогда «подставляет» настоящий ключ по защищённому каналу.
Таким образом секрет остаётся на стороне сервера Gemini и не покидает защищённое окружение вплоть до «последнего шага» — выхода запроса во внешний мир.
Практический пример: безопасный запуск агента для проверки pull requests на GitHub
В оригинале приведён пример, как с этой системой создать агента, который использует GitHub и Gemini API с безопасной авторизацией.
- Для GitHub создаётся Personal Access Token с минимальными правами — только чтение репозиториев и pull requests.
- Этот токен регистрируют в Credentials API как bearer_token.
- Gemini API ключ регистрируют в системе как environment_variable, указывая trusted_domains, куда можно подставлять ключ (например, generativelanguage.googleapis.com).
- В конфигурации агента (agents.create()) эти учетные данные подключаются по ID.
- При запуске агента (interactions.create()) он получает инструкции, например, составить релизные заметки по последним pull requests и проверить код на тестовом стенде Gemini.
Преимущество: в песочнице запускается код, который видит только заглушки для ключей. Реальные ключи используются только при активных запросах, причём их нельзя эксплуатировать или увидеть напрямую.
Где полезна Credentials API в ваших задачах и как начать использовать
Если вы запускаете ИИ-агентов с интеграциями к внешним сервисам — это обязательный инструмент. Особенно если:
- Вы хотите обезопасить API-ключи и токены.
- В контейнерной среде есть не только ваш код, а сторонние библиотеки или скрипты.
- Работа идёт с GitHub, Notion, или частными API, требующими авторизации.
Простой первый шаг:
- Создайте защищённый токен для сервиса (например, GitHub PAT с правами только на чтение).
- С помощью SDK GoogleGenAI зарегистрируйте этот токен как credentials.create({type: “bearer_token”})
- Используйте возвращённый id в настройках вашего агента.
Попробовать можно по примеру из исходника (TypeScript-код в документе). Установка SDK и запуск с реальными ключами продемонстрирует, как секреты не раскрываются, но агент работает.
Для кого важно и кому можно не беспокоиться
На сегодня Credentials API — мощный инструмент для разработчиков и продвинутых пользователей, делающих сложные агенты с интеграциями. Если вы используете только чат с ИИ без работы с внешними API или кодом — в данный момент можно не заморачиваться.
Для компаний и сервисов, где безопасность критична — внедрение Credentials API снижает риски утечек, автоматизирует обновление токенов oauth2 и упрощает интеграции.
Credentials API изменяет подход к безопасному управлению секретами в ИИ-агентах на платформе Gemini. Используя централизованное хранение и умное внедрение ключей в реальные запросы, она уменьшает возможность утечек и упрощает работу с разными типами данных для авторизации.
Если вы заинтересованы в работе с ИИ-агентами с интеграциями, изучите Credentials API, попробуйте пример с GitHub и Gemini API, а потом развивайте собственные сценарии с безопасным управлением аккаунтами и токенами.
Подробнее про инфраструктуру и работу ИИ-агентов смотрите в нашем полном гиде по OpenClaw и других обзорных материалах в разделе новостей OpenClaw.
Источник: Credentials API for Gemini Managed Agents, Phil Schmid, 2026