---
title: "Что такое белый список IP для API-ключа? Примеры CIDR"
description: "Белый список IP пропускает запросы только с указанных адресов или диапазонов CIDR. Как он защищает ключ LLM API, как устроен CIDR и подводные камни с IP облака."
url: https://broadrouter.com/ru/glossary/ip-allow-list/
lang: ru
updated: 2026-11-14
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Переведено с английского с помощью ИИ. [Читать оригинал на английском](https://broadrouter.com/glossary/ip-allow-list/) (обновлён 2026-11-14).

# Белый список IP (IP allow list)

Обновлено 2026-11-14

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

Также называют: белый список IP, белый список IP-адресов, список разрешённых IP, разрешённые IP-адреса, ограничение по IP, IP allow list, IP allowlist, IP whitelist, allowed IPs, IP restriction, allowed\_ips

По умолчанию API-ключ работает откуда угодно. Белый список привязывает его к тем местам, где на самом деле работает ваш код.

## Как это работает

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

Диапазоны записываются в нотации CIDR: адрес, косая черта и длина префикса. RFC 4632 объясняет, что длина префикса — это число фиксированных старших битов. Для IPv4:

| Запись | Охватывает |
| --- | --- |
| `203.0.113.7` | один адрес |
| `198.51.100.0/24` | 256 адресов, от `198.51.100.0` до `198.51.100.255` |
| `10.0.0.0/16` | 65 536 адресов |

IPv6 устроен так же, но со 128-битными адресами, например `2001:db8::/48`.

Важен ваш **исходящий** (egress) IP — публичный адрес, с которого уходит трафик сервера. За NAT, балансировщиком нагрузки или корпоративным прокси это часто не тот адрес, который машина показывает сама.

## Почему это важно

[API-ключи](https://broadrouter.com/ru/glossary/api-key/) — это bearer-токены: кто ими владеет, тот и пользуется. Ключи утекают через коммиты, логи, скриншоты и ноутбуки. С белым списком украденный ключ не работает из сети злоумышленника, и утечка превращается из инцидента с расходами в событие без последствий. GitHub, например, применяет свой белый список не только ко входу через веб, но и к вызовам API и персональным токенам доступа.

Цена — дополнительная операционная работа. Для каждого нового сервера, региона или CI-раннера нужно добавлять исходящий IP, а при динамических IP нужен фиксированный путь для исходящего трафика.

## В BroadNet Inference

На странице аккаунта добавьте по одному адресу IPv4 или IPv6 либо диапазону CIDR на строку, до 32 записей. Пустой список означает отсутствие ограничений. Новые ключи наследуют список аккаунта. Параметр `allowed_ips` на уровне ключа заменяет его для этого ключа:

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

Запросы с других адресов получают 403. После изменения списка или отзыва ключа новые запросы перестают проходить в течение пяти секунд. Пошаговая инструкция — в руководстве [API-ключи и белые списки IP](https://broadrouter.com/ru/guides/api-keys-ip-allow-lists/), таблица ошибок — в руководстве [ошибки и повторы](https://broadrouter.com/ru/guides/errors-and-retries/). Более широкую картину защиты данных даёт [чек-лист ZDR](https://broadrouter.com/ru/blog/zero-data-retention-llm-api-checklist/).

## Частые ошибки

-   Вносить в список частный адрес сервера, например `10.x.x.x`, вместо его публичного исходящего IP.
-   Указывать слишком широкий диапазон, лишь бы ошибки пропали. Диапазон `/8` охватывает более 16 млн адресов.

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

### Достаточно ли белого списка IP, чтобы защитить API-ключ?

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

### Мои серверы работают на serverless или с автомасштабированием. Можно ли использовать белый список?

Только если исходящий трафик уходит с известных адресов. Пропустите его через NAT-шлюз или исходящий прокси с фиксированными IP и внесите в список их.

### Какую ошибку я получу с IP, которого нет в списке?

В BroadNet Inference — 403. Другие API обычно тоже возвращают 403.

## См. также

-   [API-ключ (API key)](https://broadrouter.com/ru/glossary/api-key/) (термин)
-   [Нулевое хранение данных (ZDR)](https://broadrouter.com/ru/glossary/zero-data-retention/) (термин)
-   [Лимит запросов (rate limit)](https://broadrouter.com/ru/glossary/rate-limit/) (термин)
-   [Привязка API-ключей к серверам через белый список IP](https://broadrouter.com/ru/guides/api-keys-ip-allow-lists/) (руководство)
-   [Коды ошибок BroadNet Inference и когда повторять запрос](https://broadrouter.com/ru/guides/errors-and-retries/) (руководство)
-   [Нулевое хранение данных (ZDR) в LLM API: чек-лист из 10 вопросов](https://broadrouter.com/ru/blog/zero-data-retention-llm-api-checklist/) (статья)

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

[Начать](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ru-glossary-ip-allow-list&utm_content=page-cta) ·

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

-   [RFC 4632: Classless Inter-domain Routing (CIDR)](https://www.rfc-editor.org/rfc/rfc4632)
-   [GitHub Docs, управление разрешёнными IP-адресами организации](https://docs.github.com/en/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization)
-   [Справочник API BroadNet Inference, белые списки IP (на английском)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ru-glossary-ip-allow-list&utm_content=sources#ip-allow-lists)
