Создание коррелятора
Скопировано

13 октября 2026

ID 217787

Создание коррелятора

Вы можете создать коррелятор в веб-интерфейсе Kaspersky SIEM одним из следующих способов:

  • В разделе Ресурсы нажмите Создать коррелятор.
  • В разделе Ресурсы → Корреляторы на вкладке Текущий нажмите Создать.

Создание коррелятора состоит из следующих этапов:

Настройка основных параметров коррелятора

  1. В разделе Общие на вкладке Основные параметры заполните следующие поля:
    • В поле Название введите уникальное имя коррелятора. Название должно содержать от 1 до 128 символов в кодировке Unicode.
    • В раскрывающемся списке Тенант выберите тенант, которому будет принадлежать коррелятор. От выбора тенанта зависит, какие ресурсы будут доступны при его создании.

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

    • При необходимости в поле Обработчики укажите количество обработчиков, которые коррелятор может запускать одновременно для параллельной обработки событий. Укажите целое положительное число от 0 до 999. Если указано 0, то используется число логических ядер CPU.
    • В поле Время загрузки геоданных укажите максимальное время ожидания загрузки геоданных (GeoIP-информации) при выполнении правил обогащения с типом источника данных геоданные. Значение по умолчанию: 120 секунд.
    • При необходимости в раскрывающемся списке Теги выберите теги для коррелятора.
    • При необходимости в поле Описание добавьте описание сервиса: до 256 символов в кодировке Unicode.
  2. На вкладке Дополнительные параметры заполните следующие поля:
    • При необходимости с помощью переключателя Отладка включите логирование операций сервиса.
    • Переключатель Периодическое создание дампа используется по запросу техподдержки для генерации отчетов по потреблению ресурсов (cpu, ram и т.д.) в виде дампов.
    • В поле Настройки дампа вы можете указать параметры создания дампа. Порядок заполнения этого поля уточняйте у техподдержки.
    • В поле Число входящих запросов в очереди укажите максимальное число запросов на вставку событий в базу данных, которые могут одновременно находиться в очереди на обработку коррелятором.

Добавление глобальных переменных

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

Чтобы добавить глобальную переменную в корреляторе:

  1. В разделе Глобальные переменные нажмите на кнопку Добавить.
  2. Укажите следующие параметры:
    1. В окне Переменная введите название переменной.

      Требования к наименованию переменных

    2. В окне Значение введите функцию переменной.

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

      Для вызова списка всех подсказок в поле ввода используйте комбинацию клавиш Ctrl + Space. Для выбора нужной функции из списка используйте клавишу Enter. Для перехода к следующему аргументу в списке аргументов выбранной функции используйте клавишу Tab.

      Описание функций переменных.

Глобальная переменная добавлена. К ней можно обращаться из правил корреляции, добавляя перед названием переменной символ $. Переменных может быть несколько. Добавленные переменные можно изменить или удалить с помощью значка X..

Добавление правила корреляции

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

Если вы добавили в коррелятор глобальные переменные, все добавленные правила корреляции могут к ним обращаться.

Чтобы добавить правило корреляции:

  1. В разделе Корреляция нажмите на кнопку Добавить.
  2. Укажите параметры для правила корреляции. Набор доступных параметров зависит от выбранного типа правила корреляции:

Правило корреляции создано и привязано к набору ресурсов для коррелятора. Оно отображается в таблице правил корреляции, а также в списке ресурсов в разделе Ресурсы → Правила корреляции.

С помощью поля Поиск можно искать правила корреляции. Добавленные правила корреляции можно убрать из набора ресурсов, выбрав нужные правила и нажав Удалить.

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

С помощью кнопок Поднять и Опустить можно изменять положение выбранных правил корреляции в таблице правил корреляции, что отражается на последовательности их выполнения при обработке событий. С помощью кнопки Поднять operational-правила можно переместить правила корреляции типа operational в начало списка правил корреляции.

Обогащение событий (необязательный этап)

Вы можете выбрать или создать правила обогащения с указанием, какими данными и из каких источников следует дополнить создаваемые коррелятором корреляционные события. Правил обогащения может быть несколько. Их можно добавить с помощью кнопки Добавить обогащение или удалить с помощью кнопки X..

Чтобы добавить правило обогащения:

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

    Если вы выбрали правило обогащения из списка, то в разделе Обогащение отобразятся параметры выбранного правила.

  3. В поле Название укажите уникальное название для правила обогащения.
  4. В раскрывающемся списке Тип источника данных выберите, откуда будут поступать данные для обогащения, и заполните относящиеся к нему параметры:

    шаблон

    таблица

    константа

    словарь

    событие

    dns

    cybertrace

    cybertrace-http

    часовой пояс

    геоданные

    проверка DLL Hijacking

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

    Создание фильтра в ресурсах

В набор ресурсов для коррелятора добавлено новое правило обогащения.

Добавление правила реагирования (необязательный этап)

Вы можете выбрать или создать правила реагирования с указанием, какие действия требуется выполнить при срабатывании правил корреляции. Правил реагирования может быть несколько. Их можно добавить с помощью кнопки Добавить правило реагирования или удалить с помощью кнопки X..

Чтобы добавить правило реагирования:

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

    Если вы выбрали правило реагирования из списка, то в разделе Реагирование отобразятся параметры выбранного правила.

  3. В раскрывающемся списке Тип выберите тип правила реагирования и заполните относящиеся к нему параметры:
    • Реагирование через 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.

      Параметры реагирования

  4. В поле Обработчики укажите количество обработчиков, которые коррелятор может запускать одновременно для параллельной обработки событий. Укажите целое положительное число от 0 до 999. Если указано 0, то используется число логических ядер CPU.

    Поле не обязательно для заполнения.

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

    Создание фильтра в ресурсах

В набор ресурсов для коррелятора добавлено новое правило реагирования.

Добавление точки назначения (необязательный этап)

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

Чтобы добавить точку назначения:

  1. В разделе Маршрутизация нажмите на кнопку Добавить.
  2. В открывшемся окне в поле Точка назначения выберите тип точки назначения, которую вы хотите добавить, или создайте новую, нажав Создать и настроив следующие параметры:
    1. На вкладке Основные параметры в поле Название введите уникальное имя точки назначения. Название должно содержать от 1 до 128 символов в кодировке Unicode.
    2. С помощью переключателя Состояние вы можете при необходимости включить или выключить сервис.
    3. В раскрывающемся списке Тип выберите тип точки назначения. Доступны следующие значения:
    4. На вкладке Дополнительные параметры укажите значения для параметров настройки. Набор параметров для настройки зависит от типа точки назначения, выбранного на вкладке Основные параметры. Более подробная информация о параметрах и значениях доступна по ссылке для каждого типа точки назначения в пункте c. этой инструкции.

В набор ресурсов для коррелятора добавлена новая точка назначения.

Проверка параметров коррелятора

На этом этапе в KUMA создается набор ресурсов для сервиса и на основе этого набора автоматически создаются сервисы:

  • Набор ресурсов для коррелятора отображается в разделе Ресурсы → Корреляторы. Его можно использовать для создания новых сервисов коррелятора. При изменении этого набора ресурсов все сервисы, которые работают на его основе, будут использовать новые параметры, если сервисы перезапустить: для этого можно использовать кнопки Сохранить и перезапустить сервисы и Сохранить и обновить параметры сервисов.

    Набор ресурсов можно изменять, копировать, переносить из папки в папку, удалять, импортировать и экспортировать, как другие ресурсы.

  • Сервисы отображаются в разделе Ресурсы → Активные сервисы. Созданные с помощью мастера установки сервисы выполняют функции внутри решения KUMA – для связи с внешними частями сетевой инфраструктуры необходимо установить аналогичные внешние сервисы на предназначенных для них серверах и устройствах. Например, внешний сервис коррелятора следует установить на сервере, предназначенном для обработки событий; внешние сервисы хранилища – на серверах с развернутой службой ClickHouse; внешние сервисы агентов – на тех устройствах Windows, где требуется получать и откуда необходимо пересылать события Windows.

Чтобы проверить параметры коррелятора:

  1. Нажмите Сохранить и создать сервис.

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

    Пример

    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 и при необходимости открыть используемые ее компонентами порты.

  2. Закройте окно создания коррелятора, нажав Создать.

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

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