Как дать ИИ-агенту доступ к GitHub и облаку и не отдать ему свои ключи

Как дать ИИ-агенту доступ к GitHub и облаку и не отдать ему свои ключи

Чтобы ИИ-агент открыл pull request или заглянул в логи облачного сервиса, ему нужен доступ. Проще всего отдать ему свой токен GitHub или оставить ключи в файле .env. Но это и самый рискованный путь: агент может случайно прочитать ключ, вывести его в лог или отправить модели вместе с остальными данными.

Разработчики, которые работают с агентами каждый день, сходятся в одном: агент должен уметь пользоваться ключом, но не должен его видеть. Объясняем, как этого добиться — от простых мер до полной изоляции.

Коротко

  • По умолчанию агент запускается от вашего имени и может прочитать всё, что можете вы: папки с ключами ~/.ssh и ~/.aws, файл .env, переменные окружения.
  • Первое, что стоит сделать, — заменить «вечные» ключи с широкими правами на токены для одного проекта, которые истекают через час или через несколько дней.
  • Второе — поставить посредника. Он хранит ключ у себя, выполняет действие по просьбе агента и возвращает только результат.
  • Третье — изоляция. Облачные агенты GitHub и Anthropic уже делают её сами, а на своём компьютере защиту по-прежнему нужно включать и настраивать вручную.

Как ключи попадают не туда

ИИ-агент для кода — это программа, которая по вашему заданию сама читает файлы, запускает команды и правит код. Обычно он работает с правами того, кто его запустил, поэтому всё, что лежит в вашей домашней папке, доступно и ему.

Для утечки хватает обычной отладки. Авторы ghbrk, инструмента для защиты ключей от агентов, описывают два типичных случая. В первом агент не может отправить изменения на GitHub и, чтобы понять почему, открывает настройки SSH или сам закрытый ключ. Во втором падает команда gh, и агент выводит токен в терминал, чтобы разобраться, в чём дело.

В первом случае ключ попадает в контекст агента, во втором токен остаётся в журнале сессии. Контекст — это всё, что агент на каждом шаге отправляет модели: ваш запрос, содержимое файлов, вывод команд. Если туда попал ключ, он уже покинул ваш компьютер и может осесть в логах и истории.

Ключ может утечь и через файлы самого агента. Когда вы разрешаете Claude Code команду с пометкой «больше не спрашивать», он сохраняет её целиком в файл .claude/settings.local.json — вместе с ключом, если тот был в команде.

По данным GitGuardian, которые в ноябре привёл CSO Online, в таких файлах в открытых репозиториях GitHub нашли 31 088 разных секретов, и 5343 из них на момент проверки работали. Claude Code сам добавляет этот файл в исключения git, но только на вашем компьютере, поэтому на другой машине или при сборке Docker-образа защита может не сработать.

Бывает и угроза извне. В сентябре 2025 года червь Shai-Hulud заразил больше 500 пакетов npm. Как пишет The Record со ссылкой на агентство кибербезопасности США CISA, червь искал на компьютерах разработчиков токены GitHub и облачные ключи. Найденное он выкладывал в открытый репозиторий. Агент, который сам ставит пакеты, работает рядом с теми же ключами.

Главное правило: пользоваться, но не видеть

Патрик Макканна в статье про ssh-agent описывает подход так: агент может попросить выполнить действие с ключом, но сам ключ ему не выдают. Это похоже на охранника на проходной. Вы просите открыть дверь, и он открывает, но связку ключей вам в руки не даёт.

Дальше — пять шагов, от простого к сложному. Пример наш, а меры взяты из документации GitHub, AWS, 1Password и опыта разработчиков. Агент чинит баг: ему нужно отправить ветку на GitHub, открыть pull request и прочитать логи сервиса в AWS.

Шаг 1. Решить, что агенту на самом деле нужно

Начинать стоит не с ключей, а со списка действий. В нашем примере их три: отправить ветку, открыть pull request и прочитать логи.

Всё остальное — удалять ветки, менять настройки, заходить в другие проекты и трогать рабочие серверы — агенту не нужно. Из этого списка и получатся его права.

Шаг 2. Выдать пропуск на час, а не ключ от всех дверей

Токен доступа — это строка, которая заменяет логин и пароль, когда программа обращается к сервису. Классический токен GitHub (personal access token) для агента подходит плохо. GitHub прямо предупреждает, что такой токен открывает все репозитории, к которым есть доступ у вас.

Вместо него GitHub советует токены с тонкой настройкой прав (fine-grained). Им можно разрешить работу только с выбранными репозиториями и только нужные действия, а срок действия компания настоятельно рекомендует ограничивать. В нашем примере хватит одного репозитория, права вносить изменения в код и открывать pull requests и срока в несколько дней.

Для регулярной работы, например в CI, удобнее приложение GitHub (GitHub App): по документации, его токен действует час и тоже ограничивается нужными репозиториями и правами.

С AWS логика та же. Там есть два вида учётных записей, и AWS различает их как раз по сроку жизни ключей. Обычные пользователи IAM получают долгосрочные ключи. Пользователи IAM Identity Center получают временные: они создаются при каждом входе и живут от 1 до 12 часов, по умолчанию час.

Агенту стоит давать только временные ключи и отдельную роль, которая умеет одно — читать нужную группу логов. Даже если такой ключ утечёт, через час он перестанет работать, а изменить с ним ничего не получится.

Шаг 3. Убрать ключи из файлов проекта

Файл .env в папке проекта агент, скорее всего, прочитает одним из первых. Лучше, чтобы ключей там не было, а подставлялись они только при запуске программы.

Так умеют менеджеры секретов. Например, у 1Password есть команда op run. По описанию компании, в переменных окружения хранятся не сами ключи, а ссылки на них. Команда находит эти ссылки, подгружает настоящие значения и запускает программу.

Ключи при этом существуют только внутри запущенного процесса и только пока он работает.

То же касается служебных папок агентов вроде .claude/. Их стоит добавить в .gitignore самого проекта, а если вы публикуете пакеты или собираете образы — ещё в .npmignore и .dockerignore.

У этого шага есть предел. Он защищает от ключей в файлах, коммитах и резервных копиях. Но если секрет передан в переменные окружения самого агента, агент может его прочитать, поэтому шаг 3 не заменяет ни второй, ни четвёртый.

Шаг 4. Поставить посредника

Посредник — это программа, которая хранит ключ у себя и выполняет действие по просьбе агента. Агент получает результат, но не сам ключ.

Самый доступный вариант для git — ssh-agent из стандартного набора OpenSSH. Он держит расшифрованный ключ в памяти и, когда git нужно подтвердить, кто вы, сам ставит подпись. По словам Макканны, файл с ключом агенту при этом читать не нужно.

Слабое место у ssh-agent тоже есть: пока он запущен, попросить его о подписи может любая программа, которая работает под вашим пользователем. Поэтому Макканна советует запускать агента в контейнере или виртуальной машине со своим ssh-agent и отдельным ключом развёртывания (deploy key). А когда работа закончена, останавливать ssh-agent командой ssh-agent -k.

Строже защищают специальные посредники для учётных данных. Например, ghbrk работает в Linux как отдельная служба под собственным системным пользователем. Ключ SSH и токен GitHub лежат в папке, которую учётная запись агента открыть не может. Агент не отправляет изменения сам, а просит об этом службу: вместо git push вызывает ghbrk git push.

Каждую такую просьбу ghbrk сверяет со списком правил. Этот файл принадлежит администратору системы (root), и агент не может ни прочитать его, ни изменить. Всё, что явно не разрешено, запрещено, а каждое решение записывается в журнал.

Шаг 5. Запускать агента там, где ключей нет

Самый надёжный способ не отдать ключи — запускать агента в среде, где их просто нет. Для этого есть три способа, и их можно сочетать:

  • Отдельный пользователь системы. У него своя домашняя папка, в которой нет ваших ~/.ssh и ~/.aws.
  • Контейнер или виртуальная машина. Внутрь подключается только папка проекта, а не вся ваша домашняя папка.
  • Ограниченная сеть. Агент может обращаться только к нужным адресам: GitHub, реестру пакетов и API модели.

Отдельное правило — для рабочих систем. Ключей от боевых баз данных и платёжных сервисов на машине с агентом быть не должно, а любые действия там должен выполнять человек.

Весь порядок одной строкой: список действий → короткие узкие токены → ключи вне файлов → посредник → изоляция.

Что уже встроено в самих агентов

Часть этой работы платформы уже взяли на себя — прежде всего для облачных агентов, которые работают на серверах компании, а не у вас.

У облачного агента GitHub Copilot токен по умолчанию ограничен тем репозиторием, где он работает, а секреты GitHub Actions, Codespaces и Dependabot ему недоступны. В блоге GitHub компания добавляет, что токен отзывается, как только агент закончил работу. Выход в интернет ограничен файрволом, а в основную ветку агент писать не может, только открывает pull request.

Anthropic заявляет, что в облачной версии Claude Code ключи git и ключи подписи в песочницу с агентом не попадают.

Работу с git берёт на себя прокси: у агента внутри только ограниченный пропуск, а прокси проверяет запрос, например, что push идёт в нужную ветку, и лишь потом подставляет настоящий токен. По сути это шаг 4, встроенный в продукт.

Для запуска на своём компьютере есть Docker Sandboxes. По документации Docker, ssh-agent пробрасывается внутрь, и программы там могут попросить подпись, но не прочитать ключ. Ключи API подставляет прокси снаружи, а внутри песочницы в переменной лежит только заглушка. Среди поддерживаемых агентов — Claude Code, Codex и Cursor.

Встроенная песочница локального Claude Code, по его документации, по умолчанию выключена. Даже включённая, она по умолчанию разрешает командам читать большую часть машины, в том числе ~/.ssh и ~/.aws/credentials, а переменные окружения с секретами передаются внутрь. Закрыть это можно настройкой sandbox.credentials, но встроенного списка запретов у неё нет: защищено только то, что вы перечислите сами.

Если коротко, в облаке платформы уже решают задачу за вас, а на своём компьютере защиту нужно включать самому — для этого и нужны шаги выше.

От чего защищает каждый шаг

МераОт чего защищаетОт чего не защищает
Токены на один проект и короткий срокУтечка затронет один репозиторий и ненадолгоАгент может злоупотребить тем, что ему разрешено
Ключи подставляются при запуске (op run и аналоги)Ключи в файлах, коммитах, резервных копияхАгент может прочитать свои переменные окружения
ssh-agentАгент не читает файл с ключомПодписать запрос может любая программа вашего пользователя
Посредник со списком правил (ghbrk)Агент не видит ключ и не может выйти за правилаОшибки в самих правилах
Встроенная песочница агентаЧтение тех файлов и переменных, которые вы запретилиВсё, что не перечислено в настройках; по умолчанию часто выключена
ИзоляцияДоступ к ключам и данным на вашем компьютереДействия с теми правами, что выданы внутри

Ограничения

Ни один из этих шагов не поможет, если агент неправильно использует то, что ему разрешено. Если токен позволяет отправлять изменения прямо в основную ветку, агент может это сделать. Поэтому защита веток и обязательная проверка кода человеком важны не меньше, чем хранение ключей.

Инструменты-посредники пока молодые: ghbrk, например, работает только в Linux с systemd и на процессорах x86_64. Кроме того, многие решения в этой области продают компании, которые делают менеджеры секретов, и их советы стоит читать с этой поправкой.

На наш взгляд, разумный минимум для всех — первые три шага и ssh-agent, а посредник и полная изоляция окупаются, когда агенты часами работают без присмотра.

Открытый вопрос. Облачные агенты уже прячут ключи сами, а локальные — только если их настроить. Станет ли такая защита включённой по умолчанию и на компьютере разработчика, или это так и останется заботой пользователя?

Вывод

Агенту не нужны ваши ключи — ему нужно выполнить несколько конкретных действий. Чем точнее вы их перечислите, тем уже будут права и тем меньше вы потеряете, если что-то пойдёт не так.

Начать можно уже сегодня. Замените классический токен GitHub на токен для одного репозитория с ограниченным сроком, уберите ключи из .env, добавьте .claude/ и похожие папки агентов в .gitignore и дайте агенту работать через ssh-agent, а не с доступом к ~/.ssh.

Полезная новость?

Читайте также

Комментарии

 logo