Настройка коннектора HTTP Connector

Kaspersky MLAD использует коннектор HTTP Connector для получения данных из CSV-файлов путем загрузки данных методом POST. Вы можете загружать данные через порт 4999 по протоколу HTTP или HTTPS, указав нужный протокол в запросе.

В Kaspersky MLAD загрузка файлов сертификатов и файла ключа возможна только в формате DER или PEM. Если требуется, вы можете изменить формат файлов сертификатов и ключа к сертификату, используя утилиту OpenSSL. Например, для изменения формата файла сертификата с P12 на PEM в консоли выполните команду:

openssl pkcs12 -in <имя сертификата>.p12 -clcerts -nokeys -out <имя сертификата>.pem

Работы по настройке коннектора HTTP Connector могут выполнять системные администраторы.

Чтобы настроить работу коннектора HTTP Connector:

  1. В нижнем левом углу страницы нажмите на кнопку Пиктограмма в виде двух горизонтальных бегунков эквалайзера..

    Вы перейдете в меню администратора.

  2. Выберите раздел Системные параметры → HTTP Connector.

    Справа отобразится список параметров.

  3. В поле Размер записываемого блока (количество тегов) укажите количество значений тегов, которое единовременно записывается в службу Message Broker.

    Указанное значение влияет на количество итераций для записи значений тегов из CSV-файла в службу Message Broker в зависимости от общего количества наблюдений по тегам, полученным с помощью коннектора HTTP Connector.

  4. В поле Максимальный размер загружаемого файла (MБ) укажите максимальный размер файла в мегабайтах, передаваемого в коннектор HTTP Connector.

    При попытке загрузить CSV-файл большего размера файл не будет передан в коннектор HTTP Connector.

  5. С помощью переключателя Использовать TLS-соединение включите или выключите использование защищенного TLS-соединения.

    По умолчанию использование защищенного TLS-соединения включено.

    Во избежание компрометации получаемых и/или отправляемых данных рекомендуется оставить включенным использование защищенного TLS-соединения.

  6. Если вы используете защищенное TLS-соединение, с помощью переключателя Использовать рекомендуемые параметры TLS-соединения включите или выключите использование рекомендуемых параметров TLS-соединения.

    По умолчанию использование рекомендуемых параметров TLS-соединения включено.

    При включенном переключателе используется защищенное TLS-соединение по протоколу TLS-1.2 или TLS-1.3 с использованием набора шифров из списка рекомендованных.

  7. Если вы используете защищенное TLS-соединение, выполните следующие действия:
    1. Добавьте сертификат HTTPS-сервера и ключ к сертификату с помощью кнопки Обзор под параметрами Сертификат HTTPS-сервера и Закрытый ключ к сертификату HTTPS-сервера.

      Рекомендуется использовать сертификат с длиной ключа к сертификату 4 096 бит при использовании алгоритма RSA или 256 бит при использовании алгоритма ECDH.

    2. Если используются сертификаты клиента, то добавьте корневой сертификат для проверки подписи сертификата клиента с помощью кнопки Обзор под параметром Сертификат CA для проверки подписи сертификата клиента.

    Загрузка сертификатов и ключа к сертификату возможна только в виде файла в формате DER или PEM.

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

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

    По умолчанию конвертация полученных значений тегов выключена.

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

Kaspersky MLAD будет получать данные из CSV-файлов с помощью коннектора HTTP Connector.

Пример отправки CSV-файла в коннектор HTTP Connector через curl по протоколу HTTP методом POST на порт 4999 сервера Kaspersky MLAD:

curl -F "file=@<имя файла>.csv" -X POST "http://<IP-адрес или доменное имя сервера Kaspersky MLAD>:4999/upload"

Коннектор HTTP Connector принимает CSV-файлы со следующими полями:

timestamp;tag_name;value

где:

В начало