Настройка коннектора 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. С помощью переключателя Игнорировать регистр в именах тегов включите или выключите учет регистра при соотнесении имен тегов, добавленных в программу, с именами тегов, по которым в программу поступают данные из CSV-файлов.
10. Нажмите на кнопку Сохранить.

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

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

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

timestamp;tag_name;value

где:

• timestamp – временная метка в формате %Y-%m-%dT%H:%M:%S.
• tag_name – имя тега.
• value – значение тега.

  Если значение тега содержит дробную часть, используйте точку при отделении целой и дробной частей.