> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Настройка белого списка IP-адресов
> Ограничьте использование API-ключа аккаунта только утвержденными публичными IP-адресами.
Белый список IP-адресов ограничивает источники запросов, аутентифицированных с помощью API-ключа вашего аккаунта YCloud. Когда эта функция включена, YCloud принимает API-вызовы с использованием ключа только с IP-адресов из белого списка.
YCloud рекомендует включать белый список IP-адресов для каждого аккаунта, который выполняет вызовы API из известных серверных сред. Это обеспечивает важный уровень защиты: даже в случае компрометации API-ключа запросы с неутвержденных IP-адресов будут заблокированы.
Добавьте все исходящие IP-адреса рабочей среды (production), тестовой среды (staging), резервных систем и систем аварийного переключения перед включением белого списка. Если активная система отправит запрос с адреса, которого нет в списке, ее API-вызовы к YCloud завершатся ошибкой.
## Перед началом работы
Убедитесь в следующем:
* Ваша роль имеет доступ к разделу **Developers** > **IP whitelist** в панели управления YCloud.
* Вам известен публичный исходящий IP-адрес каждой системы, которая вызывает API YCloud.
* Ваша инфраструктура использует статические исходящие IP-адреса, или у вас налажен процесс обновления белого списка при изменении адреса.
* Вы включили в список резервные шлюзы, шлюзы NAT, прокси-серверы и среды аварийного переключения, которые могут отправлять запросы.
Добавьте публичный IP-адрес, который видит YCloud для исходящего трафика. Не добавляйте приватные внутренние адреса, такие как адреса из диапазонов `10.0.0.0/8`, `172.16.0.0/12` или `192.168.0.0/16`.
## Добавление утвержденных IP-адресов
1. Войдите в [панель управления YCloud](https://www.ycloud.com/console/).
2. Перейдите в **Developers** > **IP whitelist**.
3. Нажмите **Add Whitelist IP**.
4. Введите публичный исходящий IP-адрес системы, которая вызывает API YCloud.
5. Сохраните адрес.
6. Повторите эти шаги для каждого источника в рабочей, тестовой, резервной среде и среде аварийного переключения.
В таблице отображаются все утвержденные IP-адреса и даты их добавления.
## Включение белого списка IP-адресов
После того как вы добавили все необходимые адреса:
1. Согласуйте белый список с вашей командой по инфраструктуре или сетевым технологиям.
2. Включите параметр **Enable IP whitelists feature**.
3. Отправьте тестовый запрос из каждой предполагаемой среды.
4. Убедитесь, что запланированные задачи, сервисы, связанные с Webhook, и системы аварийного переключения по-прежнему могут вызывать API YCloud.
Белый список применяется к исходному IP-адресу исходящего API-запроса. Если запросы проходят через NAT-шлюз или прокси-сервер, укажите публичный исходящий IP этого шлюза или прокси, а не внутренний IP-адрес приложения.
## Безопасное обновление белого списка
Изменения в инфраструктуре могут привести к смене публичного исходящего IP-адреса. Следуйте этому порядку действий, чтобы избежать перебоев в обслуживании:
1. Добавьте новый публичный IP-адрес в белый список.
2. Отправьте успешный тестовый запрос через новый адрес.
3. Перенаправьте рабочий трафик на новый маршрут.
4. Убедитесь, что старый адрес больше не используется трафиком.
5. Удалите предыдущий IP-адрес из белого списка.
Не удаляйте адрес до тех пор, пока все зависящие от него сервисы не будут перенесены.
## Рекомендации по безопасности
* Включайте белый список IP-адресов, даже если ваш API-ключ хранится в менеджере секретов.
* Предоставляйте доступ к настройкам белого списка только доверенным участникам аккаунта.
* Регулярно проверяйте список и удаляйте адреса, которые больше не используются.
* Отслеживайте неудачные попытки аутентификации после изменений в сети или инфраструктуре.
* Немедленно выполните ротацию API-ключа аккаунта при подозрении на его утечку. См. [Управление API-ключами](/ru/documentation/developer/manage-api-keys).
Белый список IP-адресов дополняет безопасную работу с API-ключами, но не заменяет ротацию ключей, принцип наименьших привилегий или управление секретами.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.