Настройка коннектора 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:
- В нижнем левом углу страницы нажмите на кнопку
.
Вы перейдете в меню администратора.
- Выберите раздел Системные параметры → HTTP Connector.
Справа отобразится список параметров.
- В поле Размер записываемого блока (количество тегов) укажите количество значений тегов, которое единовременно записывается в службу Message Broker.
Указанное значение влияет на количество итераций для записи значений тегов из CSV-файла в службу Message Broker в зависимости от общего количества наблюдений по тегам, полученным с помощью коннектора HTTP Connector.
- В поле Максимальный размер загружаемого файла (MБ) укажите максимальный размер файла в мегабайтах, передаваемого в коннектор HTTP Connector.
При попытке загрузить CSV-файл большего размера файл не будет передан в коннектор HTTP Connector.
- С помощью переключателя Использовать TLS-соединение включите или выключите использование защищенного TLS-соединения.
По умолчанию использование защищенного TLS-соединения включено.
Во избежание компрометации получаемых и/или отправляемых данных рекомендуется оставить включенным использование защищенного TLS-соединения.
- Если вы используете защищенное TLS-соединение, с помощью переключателя Использовать рекомендуемые параметры TLS-соединения включите или выключите использование рекомендуемых параметров TLS-соединения.
По умолчанию использование рекомендуемых параметров TLS-соединения включено.
При включенном переключателе используется защищенное TLS-соединение по протоколу TLS-1.2 или TLS-1.3 с использованием набора шифров из списка рекомендованных.
- Если вы используете защищенное TLS-соединение, выполните следующие действия:
- Добавьте сертификат HTTPS-сервера и ключ к сертификату с помощью кнопки Обзор под параметрами Сертификат HTTPS-сервера и Закрытый ключ к сертификату HTTPS-сервера.
Рекомендуется использовать сертификат с длиной ключа к сертификату 4 096 бит при использовании алгоритма RSA или 256 бит при использовании алгоритма ECDH.
- Если используются сертификаты клиента, то добавьте корневой сертификат для проверки подписи сертификата клиента с помощью кнопки Обзор под параметром Сертификат CA для проверки подписи сертификата клиента.
Загрузка сертификатов и ключа к сертификату возможна только в виде файла в формате DER или PEM.
Если требуется удалить файл сертификата или ключ к сертификату, нажмите на кнопку
в соответствующем поле. Если требуется сохранить файл сертификата или ключ к сертификату на компьютере, нажмите на кнопку
в соответствующем поле.
- Добавьте сертификат HTTPS-сервера и ключ к сертификату с помощью кнопки Обзор под параметрами Сертификат HTTPS-сервера и Закрытый ключ к сертификату HTTPS-сервера.
- С помощью переключателя Масштабировать полученные значения тегов включите или выключите конвертацию значений тегов с учетом параметров Смещение и Множитель, заданных при создании тега.
По умолчанию конвертация полученных значений тегов выключена.
- Нажмите на кнопку Сохранить.
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
где:
timestamp
– временная метка в формате %Y-%m-%dT%H:%M:%S.tag_name
– имя тега.value
– значение тега.Если значение тега содержит дробную часть, используйте точку при отделении целой и дробной частей.