13 октября 2026
ID 217787
Создание коррелятора
Вы можете создать коррелятор в веб-интерфейсе Kaspersky SIEM одним из следующих способов:
- В разделе Ресурсы нажмите Создать коррелятор.
- В разделе Ресурсы → Корреляторы на вкладке Текущий нажмите Создать.
Создание коррелятора состоит из следующих этапов:
Настройка основных параметров коррелятора
- В разделе Общие на вкладке Основные параметры заполните следующие поля:
- В поле Название введите уникальное имя коррелятора. Название должно содержать от 1 до 128 символов в кодировке Unicode.
- В раскрывающемся списке Тенант выберите тенант, которому будет принадлежать коррелятор. От выбора тенанта зависит, какие ресурсы будут доступны при его создании.
Если при создании коррелятора вы вернетесь в раздел Общие и выберите другой тенант, вам потребуется вручную изменить все ресурсы, которые вы успели добавить в сервис. В сервис можно добавлять только ресурсы из выбранного и Общего тенантов.
- При необходимости в поле Обработчики укажите количество обработчиков, которые коррелятор может запускать одновременно для параллельной обработки событий. Укажите целое положительное число от 0 до 999. Если указано 0, то используется число логических ядер CPU.
- В поле Время загрузки геоданных укажите максимальное время ожидания загрузки геоданных (GeoIP-информации) при выполнении правил обогащения с типом источника данных геоданные. Значение по умолчанию: 120 секунд.
- При необходимости в раскрывающемся списке Теги выберите теги для коррелятора.
- При необходимости в поле Описание добавьте описание сервиса: до 256 символов в кодировке Unicode.
- На вкладке Дополнительные параметры заполните следующие поля:
- При необходимости с помощью переключателя Отладка включите логирование операций сервиса.
- Переключатель Периодическое создание дампа используется по запросу техподдержки для генерации отчетов по потреблению ресурсов (cpu, ram и т.д.) в виде дампов.
- В поле Настройки дампа вы можете указать параметры создания дампа. Порядок заполнения этого поля уточняйте у техподдержки.
- В поле Число входящих запросов в очереди укажите максимальное число запросов на вставку событий в базу данных, которые могут одновременно находиться в очереди на обработку коррелятором.
Добавление глобальных переменных
Если для некоторых сценариев обеспечения безопасности недостаточно отслеживать значения в полях событий, активных листах или словарях, вы можете воспользоваться глобальными и локальными переменными. Эти переменные позволяют выполнять различные действия над поступающими в корреляторы значениями, реализуя сложную логику выявления угроз. Переменным можно присвоить какую-либо функцию, а затем обращаться к ним из правил корреляции, как к обычным полям событий, получая в ответ результат срабатывания функции.
Чтобы добавить глобальную переменную в корреляторе:
- В разделе Глобальные переменные нажмите на кнопку Добавить.
- Укажите следующие параметры:
- В окне Переменная введите название переменной.
- В окне Значение введите функцию переменной.
При вводе функций поддерживается автодополнение в виде списка подсказок с возможными вариантами имен функций, их кратким описанием и примерами использования. Вы можете выбрать нужную функцию из списка и вставить ее вместе со списком аргументов в поле ввода.
Для вызова списка всех подсказок в поле ввода используйте комбинацию клавиш Ctrl + Space. Для выбора нужной функции из списка используйте клавишу Enter. Для перехода к следующему аргументу в списке аргументов выбранной функции используйте клавишу Tab.
Глобальная переменная добавлена. К ней можно обращаться из правил корреляции, добавляя перед названием переменной символ $. Переменных может быть несколько. Добавленные переменные можно изменить или удалить с помощью значка
.
Добавление правила корреляции
Вы можете выбрать или создать правила корреляции. В них задаются последовательности событий, указывающих на происшествия, связанные с безопасностью: при обнаружении таких последовательностей коррелятор создает корреляционное событие и алерт.
Если вы добавили в коррелятор глобальные переменные, все добавленные правила корреляции могут к ним обращаться.
Чтобы добавить правило корреляции:
- В разделе Корреляция нажмите на кнопку Добавить.
- Укажите параметры для правила корреляции. Набор доступных параметров зависит от выбранного типа правила корреляции:
Правило корреляции создано и привязано к набору ресурсов для коррелятора. Оно отображается в таблице правил корреляции, а также в списке ресурсов в разделе Ресурсы → Правила корреляции.
С помощью поля Поиск можно искать правила корреляции. Добавленные правила корреляции можно убрать из набора ресурсов, выбрав нужные правила и нажав Удалить.
При выборе правила корреляции открывается окно с его параметрами: параметры можно изменить и Сохранить. При нажатии в этом окне на кнопку Удалить, правило корреляции отвязывается от набора ресурсов.
С помощью кнопок Поднять и Опустить можно изменять положение выбранных правил корреляции в таблице правил корреляции, что отражается на последовательности их выполнения при обработке событий. С помощью кнопки Поднять operational-правила можно переместить правила корреляции типа operational в начало списка правил корреляции.
Обогащение событий (необязательный этап)
Вы можете выбрать или создать правила обогащения с указанием, какими данными и из каких источников следует дополнить создаваемые коррелятором корреляционные события. Правил обогащения может быть несколько. Их можно добавить с помощью кнопки Добавить обогащение или удалить с помощью кнопки
.
Чтобы добавить правило обогащения:
- В разделе Обогащение нажмите на кнопку Добавить обогащение.
- В раскрывающемся списке Правило обогащения выберите нужное правило или создайте новое, нажав Создать.
Если вы выбрали правило обогащения из списка, то в разделе Обогащение отобразятся параметры выбранного правила.
- В поле Название укажите уникальное название для правила обогащения.
- В раскрывающемся списке Тип источника данных выберите, откуда будут поступать данные для обогащения, и заполните относящиеся к нему параметры:
- С помощью переключателя Отладка укажите, следует ли включить логирование операций сервиса. По умолчанию логирование выключено.
- В блоке параметров Фильтр можно задать условия определения событий, которые будут обрабатываться с применением правила обогащения. В раскрывающемся списке можно выбрать существующий фильтр или Создать новый фильтр.
В набор ресурсов для коррелятора добавлено новое правило обогащения.
Добавление правила реагирования (необязательный этап)
Вы можете выбрать или создать правила реагирования с указанием, какие действия требуется выполнить при срабатывании правил корреляции. Правил реагирования может быть несколько. Их можно добавить с помощью кнопки Добавить правило реагирования или удалить с помощью кнопки
.
Чтобы добавить правило реагирования:
- В разделе Реагирование нажмите на кнопку Добавить правило реагирования.
- В раскрывающемся списке Правило реагирования выберите нужное правило или создайте новое, нажав Создать.
Если вы выбрали правило реагирования из списка, то в разделе Реагирование отобразятся параметры выбранного правила.
- В раскрывающемся списке Тип выберите тип правила реагирования и заполните относящиеся к нему параметры:
- Реагирование через KSC – правила реагирования для автоматического запуска задач на активах Kaspersky Security Center. Например, вы можете настроить автоматический запуск антивирусной проверки или обновление базы данных.
Автоматический запуск задач выполняется при интеграции KUMA с Kaspersky Security Center. Задачи запускаются только на активах, импортированных из Kaspersky Security Center.
- Запуск скрипта – правила реагирования для автоматического запуска скрипта. Например, вы можете создать скрипт с командами, которые требуется выполнить на сервере KUMA при обнаружении выбранных событий.
Файл скрипта хранится на сервере, где установлен сервис коррелятора, использующий ресурс реагирования: /opt/kaspersky/kuma/correlator/<Идентификатор коррелятора>/scripts.
Пользователю
kumaэтого сервера требуются права на запуск скрипта. - Реагирование через KEDR – правила реагирования для автоматического создания правил запрета, запуска сетевой изоляции или запуска программы на активах Kaspersky Endpoint Detection and Response и Kaspersky Security Center.
Автоматические действия по реагированию выполняются при интеграции KUMA с Kaspersky Endpoint Detection and Response.
- Реагирование через KICS/KATA – правила реагирования для автоматического запуска задач в на активах KICS for Networks. Например, изменить статус актива в KICS for Networks.
Автоматический запуск задач выполняется при интеграции KUMA с KICS for Networks.
- Реагирование через Active Directory – правила реагирования для изменения прав пользователей Active Directory. Например, блокировать пользователя.
Запуск задач выполняется при интеграции с Active Directory.
- Реагирование через KSC – правила реагирования для автоматического запуска задач на активах Kaspersky Security Center. Например, вы можете настроить автоматический запуск антивирусной проверки или обновление базы данных.
- В поле Обработчики укажите количество обработчиков, которые коррелятор может запускать одновременно для параллельной обработки событий. Укажите целое положительное число от 0 до 999. Если указано 0, то используется число логических ядер CPU.
Поле не обязательно для заполнения.
- В блоке параметров Фильтр можно задать условия определения событий, которые будут обрабатываться с применением правила реагирования. В раскрывающемся списке можно выбрать существующий фильтр или Создать новый фильтр.
В набор ресурсов для коррелятора добавлено новое правило реагирования.
Добавление точки назначения (необязательный этап)
Вы можете выбрать или создать точки назначения, в параметрах которых будут определено, куда следует перенаправлять созданные коррелятором события. Обычно события от коррелятора перенаправляются в хранилище для хранения и для возможности просматривать их позднее. При необходимости события можно отправлять в другие места. Точек назначения может быть несколько.
Чтобы добавить точку назначения:
- В разделе Маршрутизация нажмите на кнопку Добавить.
- В открывшемся окне в поле Точка назначения выберите тип точки назначения, которую вы хотите добавить, или создайте новую, нажав Создать и настроив следующие параметры:
- На вкладке Основные параметры в поле Название введите уникальное имя точки назначения. Название должно содержать от 1 до 128 символов в кодировке Unicode.
- С помощью переключателя Состояние вы можете при необходимости включить или выключить сервис.
- В раскрывающемся списке Тип выберите тип точки назначения. Доступны следующие значения:
- На вкладке Дополнительные параметры укажите значения для параметров настройки. Набор параметров для настройки зависит от типа точки назначения, выбранного на вкладке Основные параметры. Более подробная информация о параметрах и значениях доступна по ссылке для каждого типа точки назначения в пункте c. этой инструкции.
В набор ресурсов для коррелятора добавлена новая точка назначения.
Проверка параметров коррелятора
На этом этапе в KUMA создается набор ресурсов для сервиса и на основе этого набора автоматически создаются сервисы:
- Набор ресурсов для коррелятора отображается в разделе Ресурсы → Корреляторы. Его можно использовать для создания новых сервисов коррелятора. При изменении этого набора ресурсов все сервисы, которые работают на его основе, будут использовать новые параметры, если сервисы перезапустить: для этого можно использовать кнопки Сохранить и перезапустить сервисы и Сохранить и обновить параметры сервисов.
Набор ресурсов можно изменять, копировать, переносить из папки в папку, удалять, импортировать и экспортировать, как другие ресурсы.
- Сервисы отображаются в разделе Ресурсы → Активные сервисы. Созданные с помощью мастера установки сервисы выполняют функции внутри решения KUMA – для связи с внешними частями сетевой инфраструктуры необходимо установить аналогичные внешние сервисы на предназначенных для них серверах и устройствах. Например, внешний сервис коррелятора следует установить на сервере, предназначенном для обработки событий; внешние сервисы хранилища – на серверах с развернутой службой ClickHouse; внешние сервисы агентов – на тех устройствах Windows, где требуется получать и откуда необходимо пересылать события Windows.
Чтобы проверить параметры коррелятора:
- Нажмите Сохранить и создать сервис.
В разделе Проверка параметров отображается таблица сервисов, созданных на основе набора ресурсов, выбранных в мастере установки. В нижней части окна отображаются примеры команд, с помощью которых необходимо установить внешние аналоги этих сервисов на предназначенные для них серверы и устройства.
Пример
sudo /opt/kaspersky/kuma/kuma correlator --core https://<FQDN>:<port> --pair.fingerprint <CA_certificate_ID> --id <service_ID> --api.port <API_port> --install
где:
<FQDN>– полное доменное имя сервера Ядра KUMA.<port>– номер порта Ядра KUMA для внутренних коммуникаций (по умолчанию используется порт 7210).<CA_certificate_ID>– идентификатор отпечатка CA-сертификата, используемый для проверки подлинности при подключении сервиса.<service_ID>– идентификатор сервиса, скопированный из веб-интерфейса KUMA.<API_port>– порт, используемый для связи с устанавливаемым компонентом.Файл kuma можно найти внутри установщика в директории /kuma-ansible-installer/roles/kuma/files/.
Порт для связи с Ядром KUMA, идентификатор сервиса, идентификатор CA-сертификата и порт для связи с сервисом добавляются в команду автоматически. Также следует убедиться в сетевой связности системы KUMA и при необходимости открыть используемые ее компонентами порты.
- Закройте окно создания коррелятора, нажав Создать.
После завершения создания и настройки коррелятора требуется установить коррелятор KUMA на сервере с помощью команды, скопированной из раздела Проверка параметров.
.