
Ключ биржи — это не пароль от форума. Если он утечёт, ущерб измеряется не сменой пароля, а историей ордеров и балансом. Этот гайд — про то, как свести цену такой утечки к нулю ещё до того, как она случится.
Ключ LLM тратит токены. Ключ биржи двигает деньги. Разница в правах определяет всё:
| Право | Ключ LLM | Ключ биржи |
|---|---|---|
| Чтение данных | да | да |
| Создание операций | генерация текста | ордера на реальные деньги |
| Вывод средств | нет | **часто есть по умолчанию** |
| Цена утечки | счёт за токены | весь баланс субаккаунта |
Поэтому защита строится не вокруг «спрятать строку», а вокруг сокращения прав. Даже украденный ключ без права вывода и с IP-allowlist — это ограниченная проблема, а не потеря депозита.
Вывод: угроза почти никогда не в «хитром взломе криптографии». Она в правах, которые вы выдали, и в каналах, по которым секрет доступен.
На бирже, где это поддерживается, заведите субаккаунт и отдельный ключ только для торговли.
subaccount: agent-hot-01
key label: executor-01
scopes: read, trade
withdraw: disabled
ip allow: 203.0.113.10
symbols: BTC/USDC, ETH/USDC
Почему так: если ключ утечёт, атакующий не сможет вывести средства. Максимум — наторговать убыток в пределах ваших лимитов. Это неприятно, но не смертельно.

Главное правило: ключ не попадает в контекст модели, в логи и в ответы инструментов. Модель может попросить «показать конфиг», и если ключ лежит в файле, который ей доступен, — он уйдёт в чат или в историю.
chmod 600, доступном только процессу-исполнителю.sk-...abcd, а не полная строка..env и каталог с конфигами.import os, re
KEY = os.environ["EXCHANGE_TRADE_KEY"] # только у исполнителя
def redact(text: str) -> str:
# не даём ключу утечь в лог или ответ модели
return re.sub(r"(?i)(api[_-]?key|secret|token)(\s*[:=]\s*)\S+", r"\1\2***", text or "")
Почему так: даже если модель ошибётся и попытается вывести конфиг, она не увидит ключ. Секрет живёт в процессе исполнителя, а не в общем контексте.
Изоляция секрета бесполезна, если контейнер агента имеет доступ ко всему серверу и ко всем доменам.
# docker-compose.yml (фрагмент)
services:
executor:
build: ./executor
env_file: ./secrets/executor.env # chmod 600, вне git
read_only: true
networks: [exchange_net]
# без docker.sock, без домашних каталогов
analyst:
build: ./analyst
networks: [data_net]
# ключей биржи здесь нет вообще
networks:
exchange_net: {}
data_net: {}
Почему так: скомпрометированный аналитик не достанет ключ и не дотянется до биржи напрямую. Ему останется только формировать предложения, которые проверит контролёр.
Ключ без срока жизни — это ключ навсегда. Сделайте ротацию рутиной, а не реакцией на инцидент.
# быстрая проверка, что старый ключ мёртв
curl -s -H "X-API-KEY: $OLD_KEY" https://api.exchange.example/account | head
# ожидаемо: 401 / invalid key
Почему так: ротация ограничивает окно, в котором утёкший ключ остаётся полезным. Мониторинг ловит утечку раньше, чем её заметит баланс.
Действуйте по порядку, не полагаясь на модель.
1. Отозвать ключ в панели биржи — сразу, не «после разбора».
2. Остановить исполнителя независимым kill switch.
3. Проверить историю: ордера, отмены, попытки вывода, новые IP.
4. Оценить ущерб по фактическим операциям, а не по логам агента.
5. Ротировать остальные ключи, если они могли быть рядом.
6. Проверить инфраструктуру: открытые порты, админки, доступы контейнеров.
7. Записать разбор: как ключ оказался доступен и что это закрывает.
Если у ключа было право вывода — считайте средства потерянными до подтверждения обратного и действуйте как при инциденте, а не как при «подозрении».
Бот перестал торговать после включения IP-allowlist. Исполнитель ходит через другой egress-IP (VPN, NAT, второй сервер). Решение: узнать фактический IP исходящих запросов и добавить его, а не отключать allowlist.
Ключ виден в логах приложения. Причина — логирование переменных окружения или полного ответа API. Решение: включить redact() на всех путях логирования и проверить, что .env не попадает в docker inspect и отчёты об ошибках.
После ротации часть сервисов отвалилась. У каждого сервиса был общий ключ. Решение: с самого начала выдавать отдельный ключ на сервис и ротировать их по очереди.
Агент «видит» ключ в контексте. Причина — ключ лежит в файле, который читает инструмент агента, или в системном промпте. Решение: убрать ключ из доступных путей и из промпта, оставить его только в процессе исполнителя.
Достаточно ли отключить вывод средств? Это самый важный шаг, но не единственный. Без IP-allowlist и изоляции секрета ключ всё ещё можно использовать для торговли в убыток или для разведки баланса.
Можно ли хранить ключ в переменной окружения? Да, если доступ к окружению есть только у исполнителя. Но не передавайте это окружение агенту, не логируйте его и не коммитьте в git.
Нужен ли отдельный ключ, если агент один? Да. Отдельный ключ на сервис упрощает ротацию и ограничивает ущерб: отзыв одного не останавливает всё.
Что важнее — ротация или allowlist? Оба. Allowlist сокращает круг источников, ротация сокращает время жизни утёкшего ключа. По отдельности каждое слабее.

Статус: практическое руководство. Часть утверждений — заявления вендоров и проектов; проверяйте на своей среде.
Пошаговая защита API-ключей биржи от ИИ-агента: минимальные права, изоляция секретов, egress, ротация и runbook на случай утечки.
Машинные данные публикации: Citation Map JSON · JSON-LD · Semantic Embeddings — отдельный этап.
| Сущность | Тип | Роль в публикации |
|---|---|---|
| API-ключи биржи | тема/инструмент | упоминается в заголовке, TL;DR или разделах гайда |
| защита API-ключей | тема/инструмент | упоминается в заголовке, TL;DR или разделах гайда |
| ИИ-агент | тема/инструмент | упоминается в заголовке, TL;DR или разделах гайда |
| торговый бот | тема/инструмент | упоминается в заголовке, TL;DR или разделах гайда |
| ротация ключей | тема/инструмент | упоминается в заголовке, TL;DR или разделах гайда |
| изоляция секретов | тема/инструмент | упоминается в заголовке, TL;DR или разделах гайда |
| Telegram | платформа/технология | упоминается в заголовке, TL;DR или разделах гайда |
| Docker | платформа/технология | упоминается в заголовке, TL;DR или разделах гайда |
В материале нет отдельного независимого подтверждения; ниже разделены заявления источников и редакционные выводы.
| Источник | Тип | Роль |
|---|---|---|
| api.exchange.example | внешний источник | ссылка из тела гайда |
Как цитировать: AI Release. Как защитить API-ключи биржи от ИИ-агента: изоляция, права и ротация. ai-release.org.