---
title: "Как защитить API-ключ LLM: хранение, ротация, IP | BroadRouter"
description: "Как не допустить API-ключ LLM в код и логи, выдать каждой нагрузке свой ключ, ротировать по графику, привязать к IP серверов и отозвать утёкший ключ за секунды."
url: https://broadrouter.com/ru/blog/llm-api-key-security/
lang: ru
updated: 2026-11-14
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Переведено с английского с помощью ИИ. [Читать оригинал на английском](https://broadrouter.com/blog/llm-api-key-security/) (обновлён 2026-11-15).

# Безопасность API-ключей LLM: хранение, ротация и белые списки IP

Команда BroadNet Inference · 6 мин чтения · Опубликовано 2026-11-14 · Обновлено 2026-11-15

Храните API-ключи LLM в менеджере секретов и никогда — в коде или в браузере. Выдайте каждому приложению или агенту свой ключ, ротируйте ключи по графику и привяжите их к своим серверам белым списком IP. По словам BroadNet Inference, в её белый список помещается 32 записи, отзыв останавливает новые запросы в течение пяти секунд, а ключи действуют один год.

## Главное

-   Никогда не встраивайте ключ в браузерное или мобильное приложение: вызывайте LLM со своего сервера.
-   Один ключ на нагрузку: до 10 действующих ключей на аккаунт BroadNet позволяют легко изолировать утечку.
-   Белый список IP не даёт украденному ключу работать где-то ещё. BroadNet принимает до 32 записей IPv4, IPv6 или CIDR.
-   Отзыв ключа и изменения белого списка вступают в силу в BroadNet Inference в течение пяти секунд.
-   Ключи истекают через год после создания, поэтому ротация должна быть рутиной, а не авралом.

**На этой странице**

1.  Где хранить API-ключ LLM?
2.  Можно ли положить API-ключ в браузерное или мобильное приложение?
3.  Зачем выдавать каждой нагрузке свой ключ?
4.  Как белый список IP защищает ключ?
5.  Зачем отделять ключи инференса от административных учётных данных?
6.  Как часто ротировать API-ключи?
7.  Что делать, если ключ утёк?
8.  Как ключи утекают через логи?
9.  Как ограничить ущерб от утечки, которую вы ещё не обнаружили?
10.  Какие механизмы защиты ключей даёт BroadNet Inference?

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

В этой статье — привычки, которые сохраняют ключи в безопасности, и конкретные механизмы, которые для этого даёт BroadNet Inference. Пошаговые действия в портале — в [руководстве по API-ключам и белым спискам IP](https://broadrouter.com/ru/guides/api-keys-ip-allow-lists/); о бюджетах и защите от зациклившихся процессов — в статье [контроль расходов на LLM API](https://broadrouter.com/ru/blog/llm-api-spend-control/).

## Где хранить API-ключ LLM?

Храните ключи в менеджере секретов или в зашифрованных секретах вашей платформы, никогда — в коде. [OWASP Secrets Management Cheat Sheet](https://cheatsheetseries.owasp.org/cheatsheets/Secrets_Management_Cheat_Sheet.html) подробно разбирает варианты. Обратите внимание на его предупреждение: переменные окружения “are generally accessible to all processes and may be included in logs or system dumps” (перевод: «обычно доступны всем процессам и могут попасть в логи или системные дампы»), поэтому OWASP, когда есть выбор, предпочитает смонтированные файлы секретов или получение секретов из хранилища. Переменная окружения, которую при запуске заполняет менеджер секретов, — распространённый компромисс.

```python
import os
from openai import OpenAI

client = OpenAI(
    base_url="https://inference.broadnet.ai/v1",
    api_key=os.environ["BROADNET_API_KEY"],  # fails loudly if missing
)
```

Используйте `os.environ[...]`, а не `os.getenv(...)` с захардкоженным значением по умолчанию: именно так ключи и попадают в Git. Для локальной разработки файл `.env` допустим, если он внесён в `.gitignore` с первого коммита. Включите сканирование секретов и push protection на вашем Git-хостинге. На GitHub [push protection](https://docs.github.com/en/code-security/secret-scanning/introduction/about-push-protection) блокирует push с секретами известных форматов ещё до того, как они попадут в репозиторий. Push protection для пользователей включена по умолчанию, а на уровне репозитория она по умолчанию выключена, и включить её должен администратор репозитория или владелец организации.

## Можно ли положить API-ключ в браузерное или мобильное приложение?

Нет. Всё, что отдано клиенту, можно извлечь. Фронтенд-код и сборки приложений публичны, как бы их ни минифицировали и ни обфусцировали. Вызывайте LLM со своего сервера, аутентифицируйте там своих пользователей и применяйте собственные лимиты на пользователя, прежде чем пересылать запрос дальше.

То же касается десктопных инструментов, которые вы передаёте другим. Если коллеге нужен доступ к агенту для программирования, дайте ему собственный ключ в его собственном аккаунте, а не общий.

## Зачем выдавать каждой нагрузке свой ключ?

В BroadNet Inference на аккаунте может быть **до десяти действующих ключей**. Пользуйтесь этим:

| Метка ключа | Кто использует |
| --- | --- |
| `prod-api` | Продакшен-бэкенд |
| `prod-worker` | Пакетные задания |
| `staging` | Staging-окружение |
| `agent-ci` | Агент для программирования в CI |
| `dev-laptop-<name>` | Локальная разработка |

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

## Как белый список IP защищает ключ?

[Белый список IP](https://broadrouter.com/ru/glossary/ip-allow-list/) означает, что украденный ключ не сработает нигде, кроме вашей собственной инфраструктуры. В BroadNet Inference:

-   Белый список аккаунта принимает **до 32 записей**: по одному адресу IPv4 или IPv6 или диапазону CIDR на строку.
-   Пустой список означает отсутствие ограничений.
-   Новые ключи наследуют список аккаунта, если только вы не создаёте ключ с собственным `allowed_ips`, который заменяет унаследованный список для этого ключа.
-   Запрос с адреса вне списка отклоняется с кодом 403 (“refused by model, route or IP policy”, перевод: «отклонено политикой модели, маршрута или IP»).

Создайте ключ с собственным списком через API портала:

```bash
curl -X POST https://inference.broadnet.ai/portal/keys \
  -H "Authorization: Bearer $BROADNET_PORTAL_CREDENTIAL" \
  -H "Content-Type: application/json" \
  -d '{"label":"prod-worker","allowed_ips":["203.0.113.7","198.51.100.0/24"]}'
```

Ответ содержит ключ в открытом виде один раз. Сразу сохраните его в менеджере секретов: прочитать его повторно нельзя. Полные шаги — в [руководстве по белым спискам IP](https://broadrouter.com/ru/guides/api-keys-ip-allow-lists/).

Белые списки подходят серверам со стабильными исходящими IP: VPS, NAT-шлюзу, фиксированному IP офиса. Для ноутбуков, которые меняют сети, используйте отдельный ключ без списка и держите сумму, которой он рискует, небольшой.

## Зачем отделять ключи инференса от административных учётных данных?

BroadNet использует два вида учётных данных:

| Учётные данные | Что позволяют | Где хранить |
| --- | --- | --- |
| Ключ инференса | Запросы к моделям через `/v1/*` | Там, где работает приложение |
| Учётные данные портала | Создавать и отзывать ключи, менять разрешённые IP, совершать покупки | Только в вашей автоматизации или админских инструментах |

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

## Как часто ротировать API-ключи?

OWASP рекомендует регулярную ротацию, “so that any stolen credentials will only work for a short time” (перевод: «чтобы любые украденные учётные данные работали лишь короткое время»). Ключи BroadNet действуют **один год** с момента создания, так что заменять каждый ключ всё равно придётся. Сделайте ротацию рутиной:

1.  Создайте новый ключ с той же схемой меток и тем же белым списком.
2.  Разверните его рядом со старым или замените секрет и перезапустите приложение.
3.  Убедитесь, что трафик перешёл на новый ключ.
4.  Отзовите старый ключ через `DELETE /portal/keys/{alias}`.

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

## Что делать, если ключ утёк?

Если ключ утёк, сначала отзовите его, а потом разбирайтесь. В BroadNet Inference новые запросы прекращаются **в течение пяти секунд** после отзыва или изменения белого списка; документация объясняет, что решения об авторизации могут оставаться в реплицируемом кэше в течение этого ограниченного интервала.

После отзыва:

-   проверьте использование ключа на странице аккаунта или через `GET /portal/usage`;
-   выясните, как он утёк (история коммитов, логи CI, чей-то скриншот);
-   ротируйте другие секреты, которые хранились там же.

Отозванный или заблокированный ключ возвращает 401 или 403; загляните в [руководство по ошибкам](https://broadrouter.com/ru/guides/errors-and-retries/), чтобы мониторинг не считал эти ошибки временными.

## Как ключи утекают через логи?

Утечку через логи легко пропустить. Маскируйте заголовок `Authorization` в отладочных HTTP-логах, системах сбора ошибок и логах доступа прокси. Обращаясь в поддержку, присылайте `X-Request-ID`, время, маршрут, код состояния и **псевдоним** ключа (alias), но никогда не сам ключ. По документации BroadNet, портал хранит только хеш каждого ключа, поэтому показать вам потерянный ключ он тоже не сможет.

## Как ограничить ущерб от утечки, которую вы ещё не обнаружили?

Даже при соблюдении всех привычек выше исходите из того, что ключ когда-нибудь может утечь. Уменьшите радиус поражения:

-   Держите баланс для оплаты по факту на уровне, потерю которого вы готовы пережить, и пополняйте его по мере необходимости.
-   Для нагруженных агентов используйте тариф с фиксированной ценой: у сессии тарифа фиксированная цена, поэтому украденный ключ тарифа не накрутит счёт за токены. См. статью [что на самом деле значит «безлимитный»](https://broadrouter.com/ru/blog/what-unlimited-llm-api-really-means/).
-   Настройте оповещения о необычных расходах или частоте запросов по каждому ключу; [калькулятор стоимости LLM API](https://broadrouter.com/tools/llm-api-cost-calculator/) даст вам нормальную месячную цифру, относительно которой срабатывают оповещения. Бюджеты и оповещения разобраны в статье [контроль расходов на LLM API](https://broadrouter.com/ru/blog/llm-api-spend-control/).

## Какие механизмы защиты ключей даёт BroadNet Inference?

| Механизм | BroadNet Inference |
| --- | --- |
| Ключ показывается один раз, хранится в виде хеша | Да |
| Действующих ключей на аккаунт | До 10 |
| Срок действия ключа | Один год |
| Белый список IP | До 32 записей IPv4, IPv6 или CIDR |
| Белый список на отдельный ключ | Да, `allowed_ips` при создании |
| Отзыв вступает в силу | В течение пяти секунд |
| Отдельные административные учётные данные | Учётные данные портала |

Ключи защищают ваш аккаунт; [нулевое хранение данных](https://broadrouter.com/ru/privacy/) защищает то, что вы через него отправляете. Прочитайте о том и другом до запуска.

Бесплатные инструменты по теме (на английском)

-   [OpenAI to BroadNet migration helper](https://broadrouter.com/tools/openai-to-broadnet-migration/) Paste OpenAI SDK code; get base URL, key and model edits, a diff and the checks that remain.
-   [max\_tokens calculator for reasoning models](https://broadrouter.com/tools/reasoning-token-budget/) Answer length + reasoning budget + margin = a max\_tokens that does not cut the answer off.
-   [JSON schema generator for LLM structured output](https://broadrouter.com/tools/json-schema-generator/) Sample JSON to strict schema, Pydantic, Zod and a ready request.
-   [LLM JSON output validator](https://broadrouter.com/tools/llm-json-output-validator/) Parse errors by line and column, safe repairs, cut-off detection and JSON Schema checks for model output.

[Бесплатные инструменты (на английском)](https://broadrouter.com/tools/)

## Термины в этой статье

[Белый список IP (IP allow list)](https://broadrouter.com/ru/glossary/ip-allow-list/)

Белый список IP — это механизм безопасности, который принимает запросы только с перечисленных IP-адресов или диапазонов CIDR и отклоняет все остальные. В API он ограничивает ущерб от утёкшего ключа, потому что ключ не работает из сетей, которых нет в списке.

[Безлимитный тариф LLM (flat-rate LLM plan)](https://broadrouter.com/ru/glossary/flat-rate-llm-plan/)

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

[Вызов инструментов (tool calling)](https://broadrouter.com/ru/glossary/tool-calling/)

Вызов инструментов (function calling) — это функция LLM API, при которой модель возвращает структурированный запрос на выполнение функции, заданной разработчиком, с аргументами в JSON. Приложение выполняет функцию и отправляет результат обратно; сама модель код никогда не выполняет.

[ИИ-агент (AI agent)](https://broadrouter.com/ru/glossary/agent/)

ИИ-агент — это система, в которой языковая модель сама направляет свои шаги к цели: решает, какие инструменты вызвать, читает результаты и повторяет, пока не выдаст итоговый ответ или не упрётся в лимит. Фиксированный сценарий, который вызывает модель в заранее заданных местах, обычно называют не агентом, а workflow.

[ИИ-агент для программирования (AI coding agent)](https://broadrouter.com/ru/glossary/coding-agent/)

ИИ-агент для программирования — это инструмент, в котором языковая модель работает с кодовой базой в цикле: читает файлы, правит их, запускает команды, например тесты, читает вывод и решает, каким будет следующий шаг, пока задача не выполнена или не достигнут лимит.

[Нулевое хранение данных (ZDR)](https://broadrouter.com/ru/glossary/zero-data-retention/)

Нулевое хранение данных (ZDR) — это политика обработки данных, при которой AI-провайдер обрабатывает промпты и ответы только для выполнения запроса и после этого не сохраняет их содержимое ни в логах, ни в кэшах, ни в обучающих данных. Записи без содержимого, например число токенов и время выполнения, обычно всё же хранятся.

[Токен (token)](https://broadrouter.com/ru/glossary/token/)

Токен — это единица текста, которую языковая модель читает и пишет: слово, часть слова, знак препинания или последовательность байтов, которую выдаёт токенизатор модели. LLM API считают, ограничивают и обычно тарифицируют использование в токенах.

## Вопросы и ответы

### Где хранить API-ключ LLM?

В менеджере секретов или в зашифрованных секретах вашей платформы, откуда он передаётся процессу как переменная окружения, например BROADNET\_API\_KEY. Не в исходном коде, не в закоммиченном файле .env и никогда — во фронтенд-коде.

### Как быстро можно отозвать ключ BroadNet Inference?

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

### Сколько действует ключ BroadNet Inference?

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

### Может ли BroadNet показать ключ ещё раз, если я его потерял?

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

### Что делать, если утёк мой API-ключ, совместимый с OpenAI?

Сначала отзовите его, потом разбирайтесь. Проверьте использование ключа на предмет незнакомого трафика, найдите место утечки (история коммитов, логи CI, скриншоты), ротируйте другие секреты, которые хранились там же, и выпустите ключ на замену с белым списком IP.

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

-   [Контроль расходов на LLM API: бюджеты, лимиты ключей, защита от циклов](https://broadrouter.com/ru/blog/llm-api-spend-control/)
-   [Конфиденциальные данные в LLM API: маскирование, минимизация, логи](https://broadrouter.com/ru/blog/llm-api-sensitive-data/)
-   [Ошибка 429 в LLM API: экспоненциальная задержка, jitter и лимитеры](https://broadrouter.com/ru/blog/handle-llm-api-429-rate-limits/)
-   [GDPR и LLM API: 15 вопросов, которые стоит задать провайдеру](https://broadrouter.com/ru/blog/gdpr-llm-api-checklist/)
-   [GPU-парк и подход к инференсу BroadNet — по описанию самой BroadNet](https://broadrouter.com/ru/blog/broadnet-gpu-fleet-and-serving/)
-   [Кэширование ответов LLM API: кэш точных совпадений на Python](https://broadrouter.com/ru/blog/cache-llm-responses-cut-cost/)
-   [Руководство: Привязка API-ключей к серверам через белый список IP](https://broadrouter.com/ru/guides/api-keys-ip-allow-lists/)
-   [Руководство: Коды ошибок BroadNet Inference и когда повторять запрос](https://broadrouter.com/ru/guides/errors-and-retries/)
-   [Руководство: OpenAI Python SDK и BroadNet Inference](https://broadrouter.com/ru/guides/openai-python-sdk/)

Проверьте на своей реальной нагрузке. Новые аккаунты получают стартовый грант US$5 на Gemma и распознавание речи. Для DeepSeek, GLM и Qwen3.8 нужно пополнить баланс.

[Начать](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ru-blog-llm-api-key-security&utm_content=page-cta) ·

**Источники**

-   [Справочник API BroadNet Inference, лимиты: срок действия ключа, действующие ключи (дата обращения 2026-11-14) (на английском)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ru-blog-llm-api-key-security&utm_content=sources#limits)
-   [Справочник API BroadNet Inference, белые списки IP и ключи портала (дата обращения 2026-11-14) (на английском)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ru-blog-llm-api-key-security&utm_content=sources#ip-allow-lists)
-   [OWASP Secrets Management Cheat Sheet (дата обращения 2026-11-14)](https://cheatsheetseries.owasp.org/cheatsheets/Secrets_Management_Cheat_Sheet.html)
-   [GitHub Docs, сканирование секретов (дата обращения 2026-11-14)](https://docs.github.com/en/code-security/secret-scanning/about-secret-scanning)
-   [GitHub Docs, о push protection (дата обращения 2026-11-14)](https://docs.github.com/en/code-security/secret-scanning/introduction/about-push-protection)
