Перейти к содержанию

Конфигурация источников IP-адресов

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

Внешний источник подключается в виде публичной ссылки на файл в формате .CSV.

Использование базы IP-адресов

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

Ограничения

Конфигурация источников IP-адресов недоступна при работе через партнерскую схему, когда одна нода используется для фильтрации трафика всех тенантов.

Требования к файлу конфигурации

Для успешного обновления базы формат данных в файле должен соответствовать следующим требованиям:

  • cidr должно быть корректным адресом/маской подсети.

  • Одно из полей datacenter, proxy_type, country всегда должно быть непустым.

  • Кодировка файла – UTF8, разделители значений – запятые.

Пример заполнения файла конфигурации

Пример заполнения CSV-файла

Для корректного заполнения значений в файле можно воспользоваться Справочником значений:

  • Перейдите в раздел Списки IP → вкладка Конфигурация источников.

  • В Справочнике значений выберите параметр: Местоположение, Прокси или Датацентры.

  • Выберите необходимые источники.

  • Скопируйте значения и вставьте в файл конфигурации.

Значения в CSV-файле

Использование файла конфигурации

Все изменения необходимо дописывать в существующий файл: если в прошлый раз было добавлено n строк, то чтобы добавить новые m строк, в файле должны быть n+m строк.

Скачать пример файла конфигурации

Сценарии обновления базы источников

Перед работой с базой источников ознакомьтесь с требованиями к файлу конфигурации.

Добавление новых IP/подсетей в базу

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

Чтобы добавить новые IP/подсети в базу, внесите данные в файл конфигурации – укажите значения cidr, datacenter, proxy_type, country:

добавление новых IP/подсетей в базу

Добавление значений источников для существующих записей

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

Чтобы добавить значения источников для существующих в базе записей, укажите их в соответствующей строке файла конфигурации:

добавление значений источников для существующих записей

Обновление значений источников для существующих записей

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

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

обновление значений источников для существующих записей

Удаление IP/подсети из базы источников

Чтобы удалить из базы источников IP/подсеть, укажите REMOVE для proxy_type в соответсвующей строке файла конфигурации:

удаление IP/подсети из базы источников

Очистка значений IP/подсети в базе для существующих записей

Сценарий может использоваться, если значения больше неактуальны или были внесены ошибочно.

Чтобы очистить значения источников для существующих в базе записей:

  1. Удалите существующие значения в соответсвующей строке файла конфигурации, указав REMOVE для proxy_type.

  2. На следующей строке введите актуальные значения источников:

очистка значений IP/подсети в базе для существующих записей

Загрузка файла конфигурации

  1. Разместите на своём ресурсе файл с конфигурацией в формате .CSV. Обратите внимание на требования к файлу.

  2. Скопируйте путь к файлу.

  3. Перейдите в раздел Списки IP → вкладка Конфигурация источников.

  4. Вставьте скопированный путь в строку Путь к файлу. Допускается указание в URL параметров basic auth.

  5. Нажмите кнопку Сохранить.

Начнется процесс получения файла и валидации данных. Статус процесса отражается в поле Статус обновления. Формирование и загрузка сконфигурированной базы источников на ноды происходит в течение часа.

Обновление базы источников IP-адресов

Обновление общей и сконфигурированной базы на нодах по умолчанию происходит 2 раза в неделю.

Вы можете принудительно обновить сконфигурированную базу, нажав кнопку Обновить в поле Статус обновления.
Статус, дату и время последнего обновления также можно посмотреть в поле Статус обновления.

Удаление сконфигурированной базы источников

Вы можете удалить сконфигурированную базу источников IP-адресов:

  • Перейдите в раздел Списки IP → вкладка Конфигурация источников.

  • Нажмите кнопку Удалить и подтвердите удаление базы.

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