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

> AI Release · @ai_release1 · https://ai-release.org/guides/kak-zashchitit-api-klyuchi-birzhi-ot-ii-agenta.html

## Паспорт гайда
![Иллюстрация к разделу «Паспорт гайда»](https://ai-release.org/guides/img/kak-zashchitit-api-klyuchi-birzhi-ot-ii-agenta-ru-1.jpg?v=1795308291)


- **Время:** 20–40 минут
- **Стек:** любой торговый бот или ИИ-агент, биржа с субаккаунтами, Docker, systemd, менеджер секретов
- **Уровень:** Intermediate
- **Что получите:** ключ, который нельзя превратить в вывод средств, изоляцию секрета от модели, ограничение сети, ротацию и готовый runbook на случай утечки

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

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

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

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

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

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

- **Компрометация инфраструктуры бота.** Telegram-бот Bloom хранил приватные ключи пользователей и за 94 секунды вывел 48 кошельков на ~$953 000. Причина — не взлом модели, а архитектура, в которой ключи были доступны сервису.
- **Открытые агентские платформы.** В феврале 2026 исследователи нашли более 40 000 доступных из интернета экземпляров OpenClaw. Открытый интерфейс плюс слабая аутентификация — и ключи становятся доступны снаружи.
- **Prompt injection.** Агент читает внешний текст, воспринимает его как команду и вызывает инструмент, которого не должен был. Если у инструмента есть ключ с правом вывода, инъекция превращается в кражу.

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

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

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

- Чтение баланса и позиций — да.
- Создание и отмена ордеров — да.
- **Вывод средств — нет.** Если биржа позволяет, отключите на уровне ключа.
- IP-allowlist — только адрес исполнителя.
- Ограничения на инструменты и максимальный размер ордера, если биржа их даёт.
- Отдельный ключ на каждого агента или сервис: ротация одного не ломает остальные.

```text
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. Изолируйте секрет от агента»](https://ai-release.org/guides/img/kak-zashchitit-api-klyuchi-birzhi-ot-ii-agenta-ru-2.jpg?v=1795308296)


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

- Храните ключ в менеджере секретов или в файле с `chmod 600`, доступном только процессу-исполнителю.
- Передавайте его через переменные окружения процесса, а не через промпт.
- Запускайте аналитика в контейнере **без** доступа к путям с ключами.
- Маскируйте секреты в логах: `sk-...abcd`, а не полная строка.
- Запретите агенту читать `.env` и каталог с конфигами.

```python
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. Ограничьте сеть и процессы

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

- Запускайте аналитика и исполнителя в разных контейнерах.
- Исполнителю разрешите egress только к API биржи.
- Аналитику — только к нужным источникам данных.
- Уберите административные интерфейсы из публичной сети: никаких открытых панелей «на всякий случай».
- Не монтируйте docker-socket и домашний каталог в контейнер агента.

```yaml
# 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. Настройте ротацию и мониторинг

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

- Держите **два активных ключа**: текущий и следующий. Ротация — создали новый, переключили, отозвали старый.
- Меняйте ключ по расписанию (например, раз в 30–90 дней) и при любом подозрении.
- Настройте алерты на неудачные попытки аутентификации, новые IP и всплеск отмен ордеров.
- Ведите журнал: когда создан ключ, где используется, когда ротирован.
- Проверяйте, что отозванный ключ действительно возвращает ошибку авторизации.

```bash
# быстрая проверка, что старый ключ мёртв
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. **Записать разбор**: как ключ оказался доступен и что это закрывает.

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

## Чек-лист

- ☐ Отдельный субаккаунт под агента
- ☐ Ключ без права вывода
- ☐ IP-allowlist только для исполнителя
- ☐ Отдельный ключ на каждый сервис
- ☐ Ключ не в промпте, не в логах, не в ответах инструментов
- ☐ Аналитик не имеет доступа к файлам с ключами
- ☐ Egress ограничен API биржи
- ☐ Нет открытых админ-панелей и docker-socket в контейнере агента
- ☐ Ротация по расписанию и два активных ключа
- ☐ Алерты на неудачную авторизацию и новые IP
- ☐ Независимый kill switch
- ☐ Runbook на случай утечки проверен

## Troubleshooting

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

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

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

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

## FAQ

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

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

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

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

## Что почитать дальше
![Иллюстрация к разделу «Что почитать дальше»](https://ai-release.org/guides/img/kak-zashchitit-api-klyuchi-birzhi-ot-ii-agenta-ru-3.jpg?v=1795308301)


- [Безопасный ИИ-трейдер: архитектура, лимиты и защита от prompt injection](https://ai-release.org/guides/bezopasnyy-ii-treyding-arhitektura-i-limity.html)
- [Как безопасно хранить API-ключи для LLM-сервисов](https://ai-release.org/guides/kak-bezopasno-hranit-api-klyuchi-dlya-llm-servisov-env.html)
- [Как запустить ИИ-агента в Docker: изоляция и права доступа](https://ai-release.org/guides/kak-zapustit-ii-agenta-v-docker-izolyatsiya-prava-dostu.html)
- [Как настроить лимиты расходов и бюджеты для ИИ-агентов](https://ai-release.org/guides/kak-nastroit-limity-rashodov-i-byudzhety-dlya-ii-agento.html)
