> For the complete documentation index, see [llms.txt](https://docs.compliance.phalcon.blocksec.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.compliance.phalcon.blocksec.com/ru/user-manual/account/api-keys/ip-allowlist.md).

# Список разрешенных IP-адресов

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

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

## Перед началом работы

Определите все публичные исходящие IP-адреса, которые используют ваши приложения для вызова API, включая производственные серверы, резервные среды и запланированные задания.

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

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

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

## Сохранение списка разрешённых IP-адресов

1. Откройте [Система → API](https://app.blocksec.com/phalcon/compliance/system/api).
2. Найдите API-ключ, который хотите защитить, и выберите **Управление**, чтобы открыть **Настройки безопасности**.
3. Выберите **Настроить список разрешённых IP-адресов**.
4. Введите публичные IP-адреса или диапазоны CIDR, используемые вашими приложениями. Нажмите **Добавить IP**, чтобы добавить другие записи.
5. Проверьте весь список, затем выберите **Сохранить список разрешённых IP-адресов** и подтвердите действие.

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

## Включение проверки по списку разрешённых IP-адресов

1. Откройте **Настройки безопасности** API-ключа и проверьте сохранённый список разрешённых IP-адресов.
2. Убедитесь, что в списке указаны все необходимые публичные исходящие IP-адреса.
3. Включите проверку по списку разрешённых IP-адресов, когда приложения будут готовы.
4. Отправьте запрос из приложения и убедитесь, что доступ работает как ожидается.

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

## Поддерживаемые записи

Можно указать:

* Один публичный IPv4-адрес.
* Один публичный IPv6-адрес.
* Диапазон публичной сети в стандартной нотации CIDR.

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

Домены, URL-адреса, номера портов, подстановочные знаки, например `*`, частные или loopback-адреса, а также диапазоны, разрешающие все адреса, например `0.0.0.0/0` или `::/0`, не поддерживаются.

Исправьте все ошибки проверки перед сохранением и не превышайте указанный на странице лимит записей.

## Обновление списка разрешённых IP-адресов

1. Откройте **Настройки безопасности** API-ключа.
2. В разделе списка разрешённых IP-адресов выберите **Изменить**.
3. Добавьте или удалите записи по необходимости.
4. Выберите **Сохранить список разрешённых IP-адресов**, проверьте подтверждение и примените изменения.

Сохранение обновляет список разрешённых IP-адресов. Если проверка включена, запросы с IP-адресов, удалённых из списка, будут отклоняться. Если проверка отключена, сохранение списка не включает её.

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

## Отключение проверки по списку разрешённых IP-адресов

1. Откройте **Настройки безопасности** API-ключа.
2. Отключите проверку по списку разрешённых IP-адресов и подтвердите действие.

Ограничения по IP-адресам снимаются немедленно. После этого API-ключ можно использовать с любого IP-адреса.

Сохранённые адреса останутся в списке. Чтобы снова включить проверку, проверьте список и включите проверку по списку разрешённых IP-адресов.

## Устранение неполадок

### Запросы не проходят после включения или обновления списка разрешённых адресов

* Убедитесь, что в запросе используется API-ключ, для которого настроен список разрешённых адресов.
* Проверьте фактический публичный исходящий IP-адрес приложения, отправляющего запрос.
* Добавьте все исходящие адреса, используемые производственными серверами, резервными средами, NAT-шлюзами или прокси-серверами.
* Если ваша инфраструктура использует IPv6, проверьте, не отправляются ли запросы с IPv6-адреса вместо добавленного IPv4-адреса.
* Проверьте, не появился ли новый исходящий IP-адрес после недавнего развертывания или изменения инфраструктуры.

Обновите список разрешённых адресов, добавив все отсутствующие исходящие адреса.

### Не удаётся сохранить запись

Убедитесь, что запись представляет собой поддерживаемый публичный IP-адрес или диапазон CIDR, а список не пуст. Исправьте ошибки, указанные на странице, и проверьте, что число записей не превышает отображаемый лимит.

### Истекло время ожидания при сохранении

Откройте **Настройки безопасности** заново или обновите страницу, чтобы проверить, сохранились ли изменения, прежде чем повторять попытку.

Если вам нужна дополнительная помощь, обратитесь по адресу <phalcon_support@blocksec.com>. Укажите время запроса, конечную точку, сведения об ответе и ID запроса, если он доступен. Не сообщайте полный API-ключ.
