Скопировано

13 октября 2026

ID 232952

Точка назначения, тип nats-jetstream

Точки назначения с типом nats-jetstream используются для коммуникации через NATS. Доступные параметры точки назначения с типом nats-jetstream описаны в таблицах ниже.

Вкладка Основные параметры

Параметр

Описание

Название

Уникальное имя ресурса. Максимальная длина имени составляет до 128 символов в кодировке Unicode.

Обязательный параметр.

Тенант

Название тенанта, которому принадлежит ресурс.

Обязательный параметр.

Состояние

Переключатель, включающий отправку событий в точку назначения. По умолчанию этот переключатель включен.

Тип

Тип точки назначения – nats-jetstream.

Обязательный параметр.

URL

URL-адрес, с которым требуется установить связь. Поддерживаются следующие форматы URL-адресов:

<имя хоста>:<номер порта>;
<IPv4-адрес>:<номер порта>;
<IPv6-адрес><номер порта>.
IPv6-адреса можно указать в формате [<IPv6-адрес>%<интерфейс>:<номер порта>, например [fe80::5054:ff:fe4d:ba0c%eth0]:4222.

Вы можете добавить несколько URL-адресов и удалить URL-адрес. KUMA не позволяет сохранить ресурс или сервис если в поле URL есть знак табуляции или пробел. Для добавления URL-адреса нажмите на кнопку + Добавить. Для удаления URL-адреса нажмите рядом с ним на значок удаления Black cross. .

Обязательный параметр.

Тема

Тема сообщений NATS. Символы вводятся в кодировке Unicode.

Обязательный параметр.

Авторизация

Тип авторизации при подключении к URL-адресу, указанному в поле URL.

Выключена. Это значение выбрано по умолчанию.
Обычная. Этот тип авторизации осуществляется с помощью механизма SASL/PLAIN, который передает имя пользователя и пароль в открытом виде. Как правило, для обеспечения безопасности передачи данных (шифрования) в SASL/PLAIN используется TLS.
При выборе этого значения в раскрывающемся списке Секрет укажите секрет, содержащий учетные данные пользователя для авторизации при подключении к точке назначения. Вы можете выбрать существующий секрет или создать новый секрет. Для создания нового секрета выберите значение Создать.

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

Как создать секрет?
Чтобы создать секрет:
1. В поле Название введите название секрета.
2. В полях Пользователь и Пароль введите данные учетной записи, под которой агент будет подключаться к коннектору.
3. При необходимости в поле Описание введите описание секрета.
4. Нажмите на кнопку Создать.
Секрет будет добавлен и отобразится в раскрывающемся списке Секрет.

Теги

Теги для поиска ресурса.

Необязательный параметр.

Описание

Описание ресурса. Максимальная длина описания составляет до 4000 символов в кодировке Unicode.

Вкладка Дополнительные параметры

Параметр

Описание

Размер буфера

Размер буфера в байтах для накопления событий в оперативной памяти сервера перед отправкой на дальнейшую обработку или хранение. Вы можете указать целое положительное число. Размер буфера по умолчанию: 67 108 864 (64 МБ), в интерфейсе отображается как 0.

Интервал очистки буфера

Интервал в секундах для отправки событий в точку назначения. Значение по умолчанию: 1 секунда.

Размер дискового буфера

Размер дискового буфера в байтах. Значение по умолчанию: 10 ГБ, в интерфейсе отображается как 0.

Обработчики

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

Допускается указать целое положительное число не больше 999.

Выходной формат

Формат, в котором события отправляются во внешний источник:

JSON.
CEF. При выборе этого значения в отправляемых событиях содержится заголовок CEF и только поля с непустыми значениями.
Syslog-CEF.

Режим TLS

Режим шифрования TLS. При использовании шифрования TLS вы не можете указать IP-адрес в поле URL на вкладке Основные параметры. Доступные значения:

Выключено – не использовать шифрование TLS. Это значение выбрано по умолчанию.
Включено – использовать шифрование TLS, но без верификации сертификатов.
Нестандартный CA – использовать шифрование TLS с верификацией сертификата, подписанного центром сертификации. При выборе этого значения в раскрывающемся списке Нестандартный CA укажите секрет с сертификатом, подписанным центром сертификации. Вы можете выбрать существующий секрет или создать новый секрет. Для создания нового секрета выберите значение Создать.
Если вы хотите изменить параметры существующего секрета, нажмите рядом с ним на значок карандаша .

Как создать сертификат, подписанный центром сертификации?
Вы можете создать сертификат, подписанный центром сертификации, на сервере Ядра KUMA (в примерах команд ниже используется OpenSSL).

Чтобы создать сертификат, подписанный центром сертификации:
1. Создайте ключ, который будет использоваться центром сертификации, например:
  openssl genrsa -out ca.key 2048
2. Создайте сертификат для созданного ключа, например:
  openssl req -new -x509 -days 365 -key ca.key -subj "/CN=<общее имя хоста центра сертификации>" -out ca.crt
3. Создайте приватный ключ и запрос на его подписание в центре сертификации, например:
  openssl req -newkey rsa:2048 -nodes -keyout server.key -subj "/CN=<общее имя хоста сервера KUMA>" -out server.csr
4. Создайте сертификат, подписанный центром сертификации. Вам нужно включить в переменную subjectAltName доменные имена или IP-адреса сервера, для которого вы создаете сертификат, например:
  openssl x509 -req -extfile <(printf "subjectAltName=DNS:domain1.ru,DNS:domain2.com,IP:192.168.0.1") -days 365 -in server.csr -CA ca.crt -CAkey ca.key -CAcreateserial -out server.crt
5. Загрузите созданный сертификат server.crt в веб-интерфейсе KUMA в секрет с типом certificate, после чего в раскрывающемся списке Нестандартный CA выберите секрет с типом certificate.
Для использования сертификатов KUMA на сторонних устройствах вам нужно изменить расширение файла сертификата с CERT на CRT. В противном случае вы можете получить ошибку x509: certificate signed by unknown authority.
Нестандартный PFX – использовать шифрование TLS с PFX-секретом. Вам нужно сформировать PFX-сертификат с закрытым ключом в формате PKCS#12-контейнера, после чего загрузить PFX-сертификат в веб-интерфейс KUMA в виде PFX-секрета. При выборе этого значения в раскрывающемся списке PFX секрет укажите PFX-секрет с сертификатом, подписанным центром сертификации. Вы можете выбрать существующий PFX-секрет или создать новый PFX-секрет. Для создания нового PFX-секрета выберите значение Создать.
Если вы хотите изменить параметры существующего секрета, нажмите рядом с ним на значок карандаша .

Как создать PFX-секрет?
Чтобы создать PFX-секрет:
1. В поле Название введите название PFX-секрета.
2. Нажмите на кнопку Загрузить PFX и выберите файл в формате PKCS#12-контейнера, в который вы экспортировали файл PFX с закрытым ключом.
3. В поле Пароль введите пароль для защиты файла PFX, указанный в мастере экспорта PFX.
4. Нажмите на кнопку Создать.
PFX-секрет будет создан и отобразится в раскрывающемся списке PFX секрет.
Режим Нестандартный PFX не отображается, если для параметра Авторизация выбрано значение Обычная.

Сжатие

Определяет, будет ли поток событий, отправляемый агентом KUMA в точку назначения, сжиматься перед передачей. Доступные значения:

Выключено.
Snappy.
gzip.

Разделитель

Символ, определяющий границу между событиями:

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

Дисковый буфер

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

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

Время ожидания

Время в секундах, в течение которого точка назначения ожидает ответа другого сервиса или компонента.

Отладка

Переключатель, включающий логирование ресурса. По умолчанию переключатель выключен.

Фильтр

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

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

Как создать фильтр?

Все поля события KUMA имеют значение по умолчанию. Для всех числовых полей это значение равно 0. Для всех строковых полей значение по умолчанию – пустая строка. Если событие не имеет какого-то поля, это значит, что полю присвоено значение по умолчанию. Поэтому фильтр может сработать на событие, даже если у этого события нет указанного в фильтре поля. Например, если вы в фильтре указали условие DestinationPort <= 1024, но событие не содержит поля DestinationPort, фильтр сработает, так как по умолчанию DestinationPort = 0.

Чтобы создать фильтр:

В раскрывающемся списке Фильтр выберите Создать.
Если вы хотите сохранить фильтр и использовать его в качестве фильтра для других ресурсов, установите флажок Сохранить фильтр. По умолчанию флажок снят.
Если вы установили флажок Сохранить фильтр, в поле Название введите название нового фильтра. Максимальная длина названия: до 128 символов в кодировке Unicode.
Выберите режим создания фильтра: Конструктор или Код.
При формировании условий фильтрации вы можете переключаться между режимами. При переключении между режимами сформированные условия фильтров сохраняются. Если после привязки созданного фильтра к ресурсу на вкладке Код не отображается код фильтра, выберите вкладку Конструктор, после чего снова выберите вкладку Код для отображения кода фильтра.
Если вы выбрали вариант Конструктор, выполните следующие действия:
1. В раскрывающемся списке выберите логический оператор:
  - И – отбирает события, которые соответствуют всем указанным условиям.
  - ИЛИ – отбирает события, которые соответствуют одному из указанных условий.
  - НЕ – отбирает события, которые не соответствуют всем указанным условиям.
2. Нажмите на кнопку Добавить условие.
3. Если вы хотите добавить отрицательное условие, в раскрывающемся списке Если выберите Если не.
4. В последовательно отображающихся раскрывающихся списках выберите операнды и операторы фильтра.
  Операнды фильтров
  - Поля событий – поле события, которое требуется использовать как операнд фильтра.
  - Активные листы – активный лист или поле активного листа, которое требуется использовать как операнд фильтра. При выборе активного листа укажите одно или несколько полей событий, которые используются для создания записи активного листа и выступают ключом записи активного листа. Для завершения указания полей событий нажмите комбинацию клавиш Ctrl/Command+F1.
    Если вы не указали оператор inActiveList, вам нужно указать имя поля активного листа, которое требуется использовать как операнд фильтра.
  - Словари – значение из ресурса словарь, которое требуется присвоить операнду. Дополнительные параметры:
    - словарь (обязательно) – словарь, который требуется использовать.
    - ключевые поля (обязательно) – поля событий, которые используются для формирования ключа значения словаря.
  - Контекстные таблицы – в этом разделе вы можете указать значение контекстной таблицы, которое требуется использовать как операнд фильтра. При выборе контекстной таблицы вам нужно указать поле события.
    - название контекстной таблицы (обязательно) – контекстная таблица, которую требуется использовать.
    - ключевые поля (обязательно) – поля событий или локальные переменные, которые используются для создания записи контекстной таблицы и выступают ключом записи контекстной таблицы.
    - поле – имя поля контекстной таблицы, из которого требуется извлечь значение операнда.
    - индекс – индекс списочного поля таблицы, из которого требуется извлечь значение операнда.
  - Таблицы – пользовательские значения, которые требуется присвоить операнду. Дополнительные параметры:
    - словарь (обязательно) – тип словаря. Вам нужно выбрать тип словаря Таблица.
    - ключевые поля (обязательно) – поля событий, которые используются для формирования ключа значения словаря.
  - TI – параметры чтения данных Kaspersky CyberTrace об угрозах (TI) из событий. Дополнительные параметры:
    - поток (обязательно) – категория угрозы Kaspersky CyberTrace.
    - ключевые поля (обязательно) – поле события с индикаторами угроз Kaspersky CyberTrace.
    - поле (обязательно) – поле фида Kaspersky CyberTrace с индикаторами угроз.
  - Константа – пользовательское значение, которое требуется присвоить операнду. Дополнительные параметры:
    - значение (обязательно) – константа, которую требуется присвоить операнду.
  - Список – пользовательские значения, которые требуется присвоить операнду. Дополнительные параметры:
    - значение (обязательно) – константы, которые требуется присвоить операнду. Когда вы вводите значение в поле и нажимаете ENTER, значение добавляется в список, и вы можете ввести новое значение.
  Операторы фильтров
  - = – левый операнд равен правому операнду.
  - < – левый операнд меньше правого операнда.
  - <= – левый операнд меньше или равен правому операнду.
  - > – левый операнд больше правого операнда.
  - >= – левый операнд больше или равен правому операнду.
  - inSubnet – левый операнд (IP-адрес) находится в подсети правого операнда (подсети).
  - contains – левый операнд содержит значения правого операнда.
  - startsWith – левый операнд начинается с одного из значений правого операнда.
  - endsWith – левый операнд заканчивается одним из значений правого операнда.
  - match – левый операнд соответствует регулярному выражению правого операнда. Используются регулярные выражения RE2.
  - hasBit – установлены ли в левом операнде (в строке или числе), биты, позиции которых перечислены в правом операнде (в константе или в списке).
    Проверяемое значение переводится в двоичную систему счисления, после чего рассматривается справа налево. Проверяются символы, индекс которых указан в качестве константы или списка.
    
    Если проверяемое значение – это строка, то производится попытка перевести ее в целое число и обработать указанным выше способом. Если перевести строку в число невозможно, фильтр возвращает False.
  - hasVulnerability – находится ли в левом операнде актив с уязвимостью и уровнем важности уязвимости, указанными в правом операнде.
    Если идентификатор и значение важности уязвимости не указаны, фильтр будет срабатывать при наличии любых уязвимостей у актива в проверяемом событии.
  - inActiveList – этот оператор имеет только один операнд. Его значения выбираются в поле Ключевые поля и сравниваются с записями активного листа, выбранного в раскрывающемся списке активных листов.
  - inDictionary – присутствует ли в указанном словаре запись, соответствующая ключу, составленному из значений выбранных полей события.
  - inCategory – активу в левом операнде назначена по крайней мере одна из категорий активов правого операнда.
  - inActiveDirectoryGroup – учетная запись Active Directory в левом операнде принадлежит одной из групп Active Directory в правом операнде.
  - TIDetect – этот оператор используется для поиска событий с данными Kaspersky CyberTrace. Этот оператор можно использовать только на событиях, прошедших обогащение данными из Kaspersky CyberTrace, то есть только в коллекторах на этапе выбора точки назначения и в корреляторах.
  - inContextTable – присутствует ли в указанной контекстной таблице запись.
  - intersect – находятся ли в левом операнде элементы списка, указанные в списке в правом операнде.
  Если вы хотите, чтобы оператор игнорировал регистр значений, установите флажок без учета регистра. Действие не распространяется на операторы InSubnet, InActiveList, InCategory, InActiveDirectoryGroup, hasBit и inDictionary. По умолчанию флажок снят.
  
  Вы можете изменить и удалить указанный оператор. Для изменения оператора нажмите на него и укажите новый оператор. Для удаления оператора нажмите на него и затем нажмите на клавишу Backspace.
5. Если вы хотите добавить группу условий для фильтра, нажмите на кнопку Добавить группу.
  Вы можете добавить несколько групп условий.
Если вы выбрали вариант Код, укажите текстовую команду фильтра.
В правой части конструктора отображается навигатор для перемещения по коду фильтра. Перенос строк выполняется автоматически по логическим операторам И, ИЛИ, НЕ или запятым, являющимися разделителем элементов списка значений.
Если вы хотите изменить порядок условий фильтрации, используйте значки изменения порядка . Если вы хотите удалить условие, нажмите на значок удаления .
Нажмите Сохранить.

Вкладка Сервисы

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

Для привязки точки назначения к сервису, нажмите на кнопку Привязать к сервису → Привязать к <название_сервиса>. В открывшемся окне выберите один или несколько сервисов и нажмите ОК. Точка назначения будет привязана к выбранным сервисам.

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

Назад Точка назначения, тип internal

Точка назначения, тип tcp Вперед

Вам помогла эта статья?

Что нам нужно улучшить?

Спасибо за ваш отзыв, вы помогаете нам становиться лучше!