Как настроить белый список IP-адресов для API
Что это такое и зачем нужно
Белый список IP-адресов — это перечень доверенных IP-адресов, с которых разрешены запросы к вашему API. Все запросы с адресов, не указанных в списке, будут автоматически отклоняться.
Настройка белого списка IP-адресов решает три главные задачи:
- Защищает ваш аккаунт от несанкционированного доступа, даже если API-ключ случайно попал в чужие руки.
- Дает полный контроль над тем, какие сервисы могут обращаться к вашему API.
- Исключает случайные или злонамеренные запросы из неизвестных источников.
Настроив белый список, вы получаете гарантию, что доступ к вашему API есть только у тех IP-адресов сервисов, которым вы доверяете.
Как настроить
- Авторизуйтесь в Личном кабинете UIS с правами Администратора, откройте раздел Администратор → Безопасность → Настройки безопасности:
Откроется окно с правилами настройки безопасности. Перейдите на вкладку «API» и нажмите кнопку «Добавить».
- В открывшихся строках заполните поля и нажмите на иконку дискеты рядом с полями, чтобы сохранить добавленный адрес:
- «IP/маска» — введите IP-адрес, с которого будут приходить запросы. Поддерживаются одиночные адреса (например, 192.168.1.1) и диапазоны (например, 192.168.1.0/24).
Для случаев, когда IP-адрес динамический или запросы отправляются с большого количества устройств, можно использовать маску 0.0.0.0/0. Она открывает доступ с любого IP.
Важно понимать, что это снижает уровень защиты, так как доступ к API больше не ограничен по IP.
«Описание» — укажите короткий комментарий, чтобы легко идентифицировать адрес (например, «Сервер CRM» или «Офисный IP»). Это поле необязательно, но очень полезно, если адресов будет много.
После сохранения адресов отправьте тестовый запрос к API с доверенного IP-адреса, чтобы убедиться, что он внесен корректно.
Если запрос прошел успешно — настройка завершена, можно приступать к работе.
Если запрос не проходит:
- проверьте, правильно ли указан IP-адрес сервера, с которого отправляется запрос;
- убедитесь, что этот адрес добавлен в белый список;
- при необходимости отредактируйте адрес в списке или добавьте новый.