← Все гайды AI Release
EN Подписаться на @ai_release1

Как защитить API-ключи биржи от ИИ-агента: изоляция, права и ротация

Обновлено: 22.11.2026 · AI Release · @ai_release1
Как защитить API-ключи биржи от ИИ-агента: изоляция, права и ротация

Паспорт гайда

Иллюстрация к разделу «Паспорт гайда»
Иллюстрация к разделу «Паспорт гайда»

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

Чем ключ биржи отличается от ключа LLM

Ключ LLM тратит токены. Ключ биржи двигает деньги. Разница в правах определяет всё:

ПравоКлюч LLMКлюч биржи
Чтение данныхдада
Создание операцийгенерация текстаордера на реальные деньги
Вывод средствнет**часто есть по умолчанию**
Цена утечкисчёт за токенывесь баланс субаккаунта

Поэтому защита строится не вокруг «спрятать строку», а вокруг сокращения прав. Даже украденный ключ без права вывода и с IP-allowlist — это ограниченная проблема, а не потеря депозита.

Модель угроз: откуда ключи утекают в 2026

Вывод: угроза почти никогда не в «хитром взломе криптографии». Она в правах, которые вы выдали, и в каналах, по которым секрет доступен.

Шаг 1. Создайте ключ с минимальными правами

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

subaccount: agent-hot-01
key label:  executor-01
scopes:     read, trade
withdraw:   disabled
ip allow:   203.0.113.10
symbols:    BTC/USDC, ETH/USDC

Почему так: если ключ утечёт, атакующий не сможет вывести средства. Максимум — наторговать убыток в пределах ваших лимитов. Это неприятно, но не смертельно.

Шаг 2. Изолируйте секрет от агента

Иллюстрация к разделу «Шаг 2. Изолируйте секрет от агента»
Иллюстрация к разделу «Шаг 2. Изолируйте секрет от агента»

Главное правило: ключ не попадает в контекст модели, в логи и в ответы инструментов. Модель может попросить «показать конфиг», и если ключ лежит в файле, который ей доступен, — он уйдёт в чат или в историю.

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 "")

Почему так: даже если модель ошибётся и попытается вывести конфиг, она не увидит ключ. Секрет живёт в процессе исполнителя, а не в общем контексте.

Шаг 3. Ограничьте сеть и процессы

Изоляция секрета бесполезна, если контейнер агента имеет доступ ко всему серверу и ко всем доменам.

# 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: {}

Почему так: скомпрометированный аналитик не достанет ключ и не дотянется до биржи напрямую. Ему останется только формировать предложения, которые проверит контролёр.

Шаг 4. Настройте ротацию и мониторинг

Ключ без срока жизни — это ключ навсегда. Сделайте ротацию рутиной, а не реакцией на инцидент.

# быстрая проверка, что старый ключ мёртв
curl -s -H "X-API-KEY: $OLD_KEY" https://api.exchange.example/account | head
# ожидаемо: 401 / invalid key

Почему так: ротация ограничивает окно, в котором утёкший ключ остаётся полезным. Мониторинг ловит утечку раньше, чем её заметит баланс.

Шаг 5. Runbook: что делать при утечке

Действуйте по порядку, не полагаясь на модель.

1. Отозвать ключ в панели биржи — сразу, не «после разбора».

2. Остановить исполнителя независимым kill switch.

3. Проверить историю: ордера, отмены, попытки вывода, новые IP.

4. Оценить ущерб по фактическим операциям, а не по логам агента.

5. Ротировать остальные ключи, если они могли быть рядом.

6. Проверить инфраструктуру: открытые порты, админки, доступы контейнеров.

7. Записать разбор: как ключ оказался доступен и что это закрывает.

Если у ключа было право вывода — считайте средства потерянными до подтверждения обратного и действуйте как при инциденте, а не как при «подозрении».

Чек-лист

Troubleshooting

Бот перестал торговать после включения IP-allowlist. Исполнитель ходит через другой egress-IP (VPN, NAT, второй сервер). Решение: узнать фактический IP исходящих запросов и добавить его, а не отключать allowlist.

Ключ виден в логах приложения. Причина — логирование переменных окружения или полного ответа API. Решение: включить redact() на всех путях логирования и проверить, что .env не попадает в docker inspect и отчёты об ошибках.

После ротации часть сервисов отвалилась. У каждого сервиса был общий ключ. Решение: с самого начала выдавать отдельный ключ на сервис и ротировать их по очереди.

Агент «видит» ключ в контексте. Причина — ключ лежит в файле, который читает инструмент агента, или в системном промпте. Решение: убрать ключ из доступных путей и из промпта, оставить его только в процессе исполнителя.

FAQ

Достаточно ли отключить вывод средств? Это самый важный шаг, но не единственный. Без IP-allowlist и изоляции секрета ключ всё ещё можно использовать для торговли в убыток или для разведки баланса.

Можно ли хранить ключ в переменной окружения? Да, если доступ к окружению есть только у исполнителя. Но не передавайте это окружение агенту, не логируйте его и не коммитьте в git.

Нужен ли отдельный ключ, если агент один? Да. Отдельный ключ на сервис упрощает ротацию и ограничивает ущерб: отзыв одного не останавливает всё.

Что важнее — ротация или allowlist? Оба. Allowlist сокращает круг источников, ротация сокращает время жизни утёкшего ключа. По отдельности каждое слабее.

Что почитать дальше

Иллюстрация к разделу «Что почитать дальше»
Иллюстрация к разделу «Что почитать дальше»

🤖 Кратко для ИИ

AI Release Knowledge Layer
Машинно-читаемое описание публикации · Версия 1.0

Статус: практическое руководство. Часть утверждений — заявления вендоров и проектов; проверяйте на своей среде.

1. Суть публикации

Пошаговая защита API-ключей биржи от ИИ-агента: минимальные права, изоляция секретов, egress, ротация и runbook на случай утечки.

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

Машинные данные публикации: Citation Map JSON · JSON-LD · Semantic Embeddings — отдельный этап.

Полный Knowledge Layer: разделы 2–8

2. Прямые ответы

Что это за материал?
Пошаговая защита API-ключей биржи от ИИ-агента: минимальные права, изоляция секретов, egress, ротация и runbook на случай утечки. → подробнее (AR-GUIDE-KAKZASHCHI-001)
Как это сделать?
Шаг 1. Создайте ключ с минимальными правами → Шаг 2. Изолируйте секрет от агента → Шаг 3. Ограничьте сеть и процессы → Шаг 4. Настройте ротацию и мониторинг → подробнее (AR-GUIDE-KAKZASHCHI-004)
Какие темы охватывает материал?
API-ключи биржи, защита API-ключей, ИИ-агент, торговый бот, ротация ключей, изоляция секретов → подробнее (AR-GUIDE-KAKZASHCHI-002)

3. Ключевые факты

  1. Ключ биржи — это не пароль от форума. Если он утечёт, ущерб измеряется не сменой пароля, а историей ордеров и балансом. Этот гайд — про то, как свести цену такой утечки к нулю ещё до того, как она случится. — подтверждение; статус: анализ AI Release.
  2. Ключ LLM тратит токены. Ключ биржи двигает деньги. Разница в правах определяет всё: — подтверждение; статус: анализ AI Release.
  3. Поэтому защита строится не вокруг «спрятать строку», а вокруг сокращения прав. Даже украденный ключ без права вывода и с IP-allowlist — это ограниченная проблема, а не потеря депозита. — подтверждение; статус: анализ AI Release.
  4. Вывод: угроза почти никогда не в «хитром взломе криптографии». Она в правах, которые вы выдали, и в каналах, по которым секрет доступен. — подтверждение; статус: анализ AI Release.

4. Участники и сущности

СущностьТипРоль в публикации
API-ключи биржитема/инструментупоминается в заголовке, TL;DR или разделах гайда
защита API-ключейтема/инструментупоминается в заголовке, TL;DR или разделах гайда
ИИ-агенттема/инструментупоминается в заголовке, TL;DR или разделах гайда
торговый боттема/инструментупоминается в заголовке, TL;DR или разделах гайда
ротация ключейтема/инструментупоминается в заголовке, TL;DR или разделах гайда
изоляция секретовтема/инструментупоминается в заголовке, TL;DR или разделах гайда
Telegramплатформа/технологияупоминается в заголовке, TL;DR или разделах гайда
Dockerплатформа/технологияупоминается в заголовке, TL;DR или разделах гайда

5. Связи и контекст

  • Гайд — описывает → Как защитить API-ключи биржи от ИИ-агента: изоляция, права и ротация (AR-GUIDE-KAKZASHCHI-001).
  • Гайд — содержит шаг → Шаг 1. Создайте ключ с минимальными правами (AR-GUIDE-KAKZASHCHI-001).

6. Достоверность и происхождение информации

Подтверждено

В материале нет отдельного независимого подтверждения; ниже разделены заявления источников и редакционные выводы.

Заявление источника

  • Характеристики продуктов, версии, цены и лимиты — из описаний вендоров и материалов гайда.
  • Команды и шаги приведены как рекомендация, а не как гарантированный результат.

Анализ AI Release

  • Структура, сравнение и критерии выбора — редакционные.
  • Гайд не заменяет независимый аудит или юридическую консультацию.

7. Что пока неизвестно

  • Актуальность версий, цен и лимитов на момент чтения.
  • Независимые замеры и проверка качества.
  • Условия использования и политика данных.

8. Источники

ИсточникТипРоль
api.exchange.exampleвнешний источникссылка из тела гайда

Как цитировать: AI Release. Как защитить API-ключи биржи от ИИ-агента: изоляция, права и ротация. ai-release.org.