Создание правила обогащения
Чтобы создать правило обогащения событий:
- В веб-интерфейсе откройте один из следующих разделов:
- Ресурсы → Правила обогащения.
- Ресурсы → Список.
- В панели инструментов или в меню
нажмите на кнопку Создать. - В открывшейся боковой панели в поле Название введите уникальное имя правила обогащения. Название должно содержать от 1 до 128 символов в кодировке Unicode.
- В раскрывающемся списке Тенант выберите, к какому тенанту относится это правило обогащения.
- В раскрывающемся списке Тип источника данных выберите тип правила обогащения и настройте параметры, специфичные для выбранного типа источника данных:
Этот тип обогащения используется, если в поле события необходимо добавить константу. Параметры этого типа обогащения описаны в таблице ниже.
Параметры типа обогащения "константа"
Параметр
Описание
Константа
Значение, которое требуется добавить в поле события. Максимальная длина значения – до 255 символов в кодировке Unicode.
Если оставить поле пустым, существующее значение поля события будет удалено.
Целевое поле
Поле события, в которое требуется поместить данные.
Если вы используете функции обогащения событий для полей расширенной схемы с типом
Строка,ЧислоилиЧисло с плавающей точкойс помощью константы, в поле будет добавлена константа.Если вы используете функции обогащения событий для полей расширенной схемы с типом
Массив строк,Массив чиселилиМассив чисел с плавающей точкойс помощью константы, константа будет добавлена к элементам массива.Этот тип обогащения используется, если в поле события необходимо добавить значение из словаря типа Словарь. Параметры этого типа обогащения описаны в таблице ниже.
Параметры типа обогащения "словарь"
Параметр
Описание
Название словаря
Словарь, из которого будут браться значения.
Ключевые поля
Поля событий, значения которых будут использоваться для выбора записи словаря.
Для добавления поля события нажмите на кнопку Добавить поле. Вы можете добавить несколько полей событий.
Если вы используете обогащение событий, у которого в качестве параметра Тип источника данных выбрано значение словарь, а в параметре Ключевые поля обогащения указано поле-массив, при передаче массива в качестве ключа словаря массив будет сериализован в строку в соответствии с правилами сериализации одного значения в формате TSV.
Пример. В параметре Ключевые поля обогащения используется поле расширенной схемы
SA.StringArrayOne. В поле расширенной схемыSA.StringArrayOneнаходятся значения"a","b","c". В качестве ключа в словарь будут переданы значения['a','b','c'].Если в параметре Ключевые поля обогащения используется поле-массив расширенной схемы и обычное поле схемы событий, значения полей при обращении в словарь будут разделены символом
|.Пример. В параметре Ключевые поля обогащения используется поле расширенной схемы
SA.StringArrayOneи строковое полеCode. В поле расширенной схемыSA.StringArrayOneнаходятся значения"a","b","c", а строковое полеCodeсодержит последовательность символовmyCode. В качестве ключа в словарь будут переданы значения['a','b','c']|myCode.Этот тип обогащения используется, если в поле события необходимо записать значение другого поля события. Параметры типа обогащения описаны в таблице ниже.
Параметры типа обогащения "событие"
Параметр
Описание
Целевое поле
Поле события, в которое следует поместить данные.
Исходное поле
Поле события, значение которого будет записано в целевое поле.
Преобразование
Блок параметров, в котором можно создать правила изменения исходных данных перед тем, как они будут записаны в поля событий. Тип преобразования можно выбрать в раскрывающемся списке. С помощью кнопок Добавить преобразование и Удалить можно добавить или удалить преобразование. Порядок преобразований имеет значение.
Возможность использовать преобразования зависит от типа используемого поля расширенной схемы событий:
- Для дополнительного поля с типом
Строкадоступны все типы преобразования. - Для полей с типами
ЧислоиЧисло с плавающей точкойдоступны типы преобразования regexp, substring, replace, trim, append, prepend, replaceWithRegexp, decodeHexString, decodeBase64String и decodeBase64URLString. - Для полей с типами
Массив строк,Массив чиселиМассив чисел с плавающей точкойдоступны типы преобразования append и prepend.
Посмотреть доступные преобразования
Преобразования – это изменения, которые применяются к значению перед записью в поле события.
Вы можете выбрать в раскрывающемся списке один из следующих типов преобразования:
- entropy – используется для преобразования значения исходного поля с помощью функции вычисления информационной энтропии и помещения результата преобразования в целевое поле типа
float. Результатом преобразования будет число. Показатель вычисления информационной энтропии позволяет выявлять DNS-туннели и компрометацию паролей, например, когда пользователь ввел пароль вместо логина и пароль записывается в журнал в открытом виде. - lower – используется для перевода всех символов значения в нижний регистр.
- upper – используется для перевода всех символов значения в верхний регистр.
- regexp – используется для преобразования значения с помощью указанного регулярного выражения RE2. При выборе этого типа преобразования отображается поле, в котором вам нужно указать регулярное выражение RE2.
- substring – используется для извлечения символов в указанном диапазоне позиций. При выборе этого типа преобразования отображаются поля Начало и Конец, в которых вам нужно указать диапазон позиций.
- replace – используется для замены указанной последовательности символов на другую последовательность символов. При выборе этого типа преобразования отображаются следующие поля:
- Символы на замену – последовательность символов, которую требуется заменить.
- Чем заменить – последовательность символов, которую требуется использовать вместо заменяемой последовательности символов.
- trim – используется для удаления указанных символов одновременно с начала и с конца значения поля события. При выборе этого типа преобразования отображается поле Символы, в котором вам нужно указать символы. Например, если для значения
Microsoft-Windows-Sysmonтребуется выполнить преобразование trim со значениемMicromon, новым значением будетsoft-Windows-Sys. - append – используется для добавления указанных символов в конец значения поля события. При выборе этого типа преобразования отображается поле Константа, в котором вам нужно указать символы.
- prepend – используется для добавления указанных символов к началу значения поля события. При выборе этого типа преобразования отображается поле Константа, в котором вам нужно указать символы.
- replace with regexp – используется для замены результатов регулярного выражения RE2 на указанную последовательность символов. При выборе этого типа преобразования отображаются следующие поля:
- Выражение – регулярное выражение RE2, результаты которого требуется заменить.
- Чем заменить – последовательность символов, которую требуется использовать вместо заменяемой последовательности символов.
- Конвертация закодированных строк в текст:
- decodeHexString – используется для конвертации HEX-строки в текст.
- decodeBase64String – используется для конвертации Base64-строки в текст.
- decodeBase64URLString – используется для конвертации Base64url-строки в текст.
- unicodeUnescape – используется для конвертации Unicode-строки в текст.
При конвертации поврежденной строки или при ошибках конвертации в поле события могут быть записаны поврежденные данные.
При обогащении событий, если длина закодированной строки превышает размер поля нормализованного события, строка будет обрезана и не будет раскодирована.
Если длина раскодированной строки превышает размер поля события, в которое должно быть помещено раскодированное значение, строка будет обрезана до размера этого поля события.
Мы не рекомендуем использовать несколько дополнительных нормализаторов для последовательного преобразования одного и того же поля. Результат одного преобразования, выполненного дополнительным нормализатором, не используется как входные данные для следующего. В итоговое событие записывается значение, полученное в допонительном нормализаторе, который первым выполнил обогащение этого поля.
- Преобразование формата IP-адреса в IPv4:
- ipDecimalToDotted – используется для преобразования IP-адреса в формате десятичного числа в IP-адрес в формате IPv4, в котором октеты разделены точками.
- ipHexToDotted – используется для преобразования IP-адреса в формате шестнадцатиричного числа в IP-адрес в формате IPv4, в котором октеты разделены точками.
- hexToDecimal – используется для преобразования числового значения, представленного в шестнадцатеричной системе счисления, в десятичный формат. Преобразование применяется к строковым или числовым полям, содержащим HEX-значения (включая префикс 0x, если он присутствует), и результат записывается в целевое поле события KUMA в виде целого числа.
Результатом преобразования является число в десятичной системе, например исходное значение – 0x00FF, после преобразования – 255.
Этот тип обогащения используется, если в поле события нужно записать значение, полученное при обработке шаблонов Go. Мы рекомендуем сопоставлять значение и размер поля. Параметры этого типа обогащения описаны в таблице ниже.
Параметры типа обогащения "шаблон"
Параметр
Описание
Шаблон
Шаблон Go. Имена полей событий передаются в формате
{{.EventField}}, гдеEventField– это название поля события, значение которого должно быть передано в скрипт, напримерАтака на {{.DestinationAddress}} со стороны {{.SourceAddress}}.Целевое поле
Поле события, в которое требуется поместить данные.
Если вы используете обогащение событий, у которого в качестве параметра Тип источника данных выбрано значение шаблон, целевым полем является поле с типом
Строка, а исходным полем является поле расширенной схемы событий, содержащее массив строк, то в шаблоне может быть использован один из следующих примеров:{{.SA.StringArrayOne}}{{- range $index, $element := . SA.StringArrayOne -}}{{- if $index}}, {{end}}"{{$element}}"{{- end -}}
Для преобразования в шаблоне данных поля массива в формат TSV требуется использовать функцию
toString, например:template {{toString .SA.StringArray}}Этот тип обогащения используется, если в поле события необходимо добавить значение из словаря типа Таблица. Параметры этого типа обогащения описаны в таблице ниже.
Параметры типа обогащения "таблица"
Параметр
Описание
Название словаря
Словарь, из которого будут браться значения.
Ключевые поля
Поля событий, значения которых будут использоваться для выбора записи словаря.
Для добавления поля события нажмите на кнопку Добавить поле. Вы можете добавить несколько полей событий.
Сопоставление
Поля событий для передачи данных:
- Поле словаря – поля словаря, из которых будут передаваться данные. Доступные поля зависят от выбранного ресурса словаря.
- Поле KUMA – поля событий, в которые будут передаваться данные. Для выбранных полей (
*custom*и*flex*) в столбце Подпись вы можете задать название для помещаемых данных.
Первое поле в таблице (Поле словаря) считается ключом, с которым будут сопоставляться поля, выбранные из события в качестве ключевых (Поле KUMA). В качестве ключа в Поле словаря вам нужно выбрать индикатор компрометации, по которому будет осуществляться обогащение, например IP-адрес, URL-адрес или хеш. В правиле необходимо выбрать поле события, соответствующее выбранному индикатору в поле словаря.
Если вы хотите выбрать несколько ключевых полей, вы можете указать их через разделитель
|(при указании через веб-интерфейс или импорте через CSV-файл), например<IP-адрес>|<имя пользователя>.Вы можете добавлять новые строки таблицы и удалять строки таблицы. Для добавления новой строки таблицы нажмите на кнопку Добавить элемент. Для удаления строки таблицы нажмите на крестик
.Этот тип обогащения используется, когда необходимо добавить обогащение событий активами на определенных коллекторах.
Для обогащения событий активами в блоке Сопоставление требуется заполнить таблицу сопоставления полей события KUMA и полей для записи значениий из хеш-таблицы.
Чтобы заполнить таблицу сопоставления полей:
- В блоке Сопоставление нажмите на кнопку Добавить.
- В раскрывающемся списке Поле KUMA выберите одно или несколько полей события, значение которого будет сопоставляться со значением из хеш-таблицы и записываться в соответствующее поле в таблице данных актива.
- В раскрывающемся списке Поле для записи данных выберите поле, в которое при соответствии поля события (Поле KUMA) и значения из хеш-таблицы будет записано значение идентификатора актива.
Возможные значения параметров в таблице сопоставления полей
Поле KUMA
Поле для записи данных
DestinationAddress
DestinationHostName
DeviceAddress
DeviceHostName
SourceAddress
SourceHostName
DestinationMacAddress
DeviceMacAddress
SourceMacAddress
DeviceCustomString1
DeviceCustomString2
DeviceCustomString3
DeviceCustomString4
DeviceCustomString5
DeviceCustomString6
SourceAssetID
DeviceAssetID
DestinationAssetID
Если вы указываете несколько полей, к значениям полей применяется условие И. Если вы добавляете несколько строк в столбце Поле KUMA, к значениям полей применяется условие ИЛИ. Проверка начинается с первого поля в списке. Если значение поля совпадает со значением атрибута, проверка прекращается.
Например, в событие поступают следующие данные:
SourceAddress=192.168.х.ххSourceHostName=kuma.example.comВ KUMA есть два актива:
company.example.com(IP-адрес:192.168.х.хх; FQDN:company.example.com) иkuma.example.com(IP-адрес:192.168.y.yyy; FQDN:kuma.example.com). Сопоставление для них осуществляется следующим образом:- Если вы указали отдельно
sourceAddress→sourceAssetID, а затемsourceHostname→sourceAssetID, то актив будет соответствовать первому условию (company.example.com). - Если вам важнее получить значение параметра
sourceHostname(kuma.example.com), то первым указываетсяsourceHostname→sourceAssetID, а затемsourceAddress→sourceAssetID. - Если вы указали
sourceAddress+sourceHostname→sourceAssetID, обогащение не произойдет.
В таблице сопоставления полей требуется указать хотя бы одно условие сопоставления.
- Если вы указали отдельно
- Если вы хотите применить для параметров Поле KUMA и Поле для записи данных значения по умолчанию, нажмите на кнопку. Применить сопоставление по умолчанию, расположенную над таблицей.
Значения параметров по умолчанию
Поле KUMA
Поле для записи данных
DestinationAddress
DestinationAssetID
DestinationHostName
DestinationAssetID
DeviceAddress
DeviceAssetID
DeviceHostName
DeviceAssetID
SourceAddress
SourceAssetID
SourceHostName
SourceAssetID
Этот тип обогащения используется для отправки запросов на DNS-сервер частной сети для преобразования IP-адресов в доменные имена или наоборот. Преобразование IP-адресов в DNS-имена происходит только для частных адресов: 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16, 100.64.0.0/10, fd00::/8.
Параметры этого типа обогащения описаны в таблице ниже.
Параметры типа обогащения "dns"
Параметр
Описание
URL
URL DNS-сервера, которому вы хотите отправлять запросы.
С помощью кнопки Добавить URL можно указать несколько URL.
Если параметр URL не указан, то KUMA возьмет список DNS-серверов из файла
/etc/resolv.conf, расположенного на локальном хосте. В этом случае вам нужно включить параметр Требуется рекурсия. В противном случае обогащение происходить не будет.Запросов в секунду
Максимальное количество запросов к DNS-серверу в секунду. Значение по умолчанию: количество vCPU сервера, на котором установлено Ядро KUMA.
Обработчики
Количество обработчиков, которые сервис может запускать одновременно для параллельной обработки событий. Укажите целое положительное число от 0 до 999. Если указано 0, то используется число логических ядер CPU. Значение по умолчанию:
1.Максимальное число событий в очереди обогащения
Максимальное число событий, сохраняемое в очереди для повторной отправки. Значение по умолчанию:
1 000 000.Время ожидания
Время ожидания ответа от DNS-сервера (в секундах). Значение по умолчанию:
5.Переопределение режима DNS
Используемый метод преобразования:
- Только прямое разрешение DNS – доменное имя преобразуется в IP-адрес.
- Только обратное разрешение DNS – IP-адрес преобразуется в доменное имя.
- Прямое и обратное DNS-разрешение – доменное имя может преобразовываться в IP-адрес и наоборот.
Срок жизни кеша
Время жизни значений (в секундах), хранящихся в кеше. Значение по умолчанию:
60(сек).Кеш отключен
Параметр, позволяющий включить или выключить кеширование. По умолчанию кеширование включено.
Обновление кэша отключено
Если обновление кеша включено, то по истечении срока жизни кеша коллектор отправляет повторные запросы на DNS-сервер для обновления хранящихся в кеше данных. Этот параметр доступен только при включенном кеше. По умолчанию обновление кеша включено.
Требуется рекурсия
Параметр позволяет включить отправку коллектором рекурсивных запросов к авторитативным DNS-серверам для выполнения обогащения. Значение по умолчанию: Выключено.
Для систем с большой нагрузкой на коллектор или коррелятор рекомендуется использовать тип обогащения cybertrace-http. Этот тип обогащения возвращает структурированный ответ в формате JSON и корректно различает строки и массивы пользовательских атрибутов, исключая ошибки парсинга.
При обогащении с помощью типа cybertrace коллектор получает неструктурированный ответ. Если значение пользовательского атрибута в Kaspersky CyberTrace содержит квадратные скобки, например [str1, str2], Kaspersky SIEM обрабатывает его как массив, а не как строку.Этот тип обогащения используется для добавления в поля события сведений из потоков данных Kaspersky CyberTrace. Параметры этого типа обогащения описаны в таблице ниже.
Параметры типа обогащения "cybertrace"
Параметр
Описание
URL
URL сервера Kaspersky CyberTrace, которому вы хотите отправлять запросы. Порт Kaspersky CyberTrace по умолчанию: 9999.
Обязательный параметр.
Количество подключений
Максимальное количество подключений к серверу Kaspersky CyberTrace, которые может одновременно установить Kaspersky SIEM.
Значение по умолчанию равно количеству vCPU сервера, на котором установлено Ядро KUMA.
Запросов в секунду
Максимальное количество запросов к серверу в секунду. Значение по умолчанию:
1000.Время ожидания
Время ожидания отклика от сервера Kaspersky CyberTrace в секундах. Значение по умолчанию:
30.Максимальное кол-во событий в очереди обогащения
Максимальное количество событий, сохраняемое в очереди для переотправки. Значение по умолчанию:
1 000 000.Сопоставление
Таблица сопоставления полей событий с типами индикаторов Kaspersky CyberTrace.
В столбце Поле KUMA указаны названия полей событий, а в столбце Индикатор CyberTrace указаны типы индикаторов Kaspersky CyberTrace.
Доступные типы индикаторов Kaspersky CyberTrace:
- ip
- url
- hash
В таблице сопоставления требуется указать как минимум одну строку. Вы можете добавлять новые строки таблицы и удалять строки таблицы. Для добавления новой строки таблицы нажмите на кнопку Добавить строку. Для удаления строки таблицы нажмите на крестик
.Этот тип потокового обогащения событий в Kaspersky CyberTrace, который позволяет отправлять большое количество событий одним запросом на API-интерфейс CyberTrace. Мы рекомендуем применять тип обогащения cybertrace-http в системах с большим потоком событий. Производительность cybertrace-http превосходит показатели типа обогащения cybertrace.
Ограничения:
- Тип обогащения cybertrace-http невозможно использовать для ретроспективного сканирования в KUMA.
- В случае использования типа обогащения cybertrace-http обнаружения киберугроз не сохраняются в истории Kaspersky CyberTrace в окне Обнаружения.
Параметры этого типа обогащения описаны в таблице ниже.
Параметры типа обогащения "cybertrace-http"
Параметр
Описание
Тенант
Тенант, в рамках которого вы планируете работать с Kaspersky CyberTrace.
Обязательный параметр.
URL
URL сервера Kaspersky CyberTrace, которому вы хотите отправлять запросы и порт, который использует API CyberTrace. Порт по умолчанию 443.
Обязательный параметр.
Секрет
Раскрывающийся список для выбора секрета, в котором хранятся учетные данные для подключения.
Обязательный параметр.
Время ожидания
Время ожидания отклика от сервера Kaspersky CyberTrace в секундах. Значение по умолчанию:
30.Ключевые поля
Список полей событий, используемых для обогащения событий данными из Kaspersky CyberTrace.
Обязательный параметр.
Максимальное кол-во событий в очереди обогащения
Максимальное количество событий, сохраняемое в очереди для переотправки. Значение по умолчанию:
1 000 000.По достижении 1 млн получаемых событий от сервера Kaspersky CyberTrace события перестают обогащаться, пока число получаемых событий не станет меньше 500 тыс.
Основная версия CyberTrace
Версия Kaspersky CyberTrace. Доступные значения:
- <5 – запросы будут выполняться в тенанте General в Kaspersky CyberTrace и будут использовать новую версию API, соответствующую Kaspersky CyberTrace 5.0 и выше.
- ≥ 5.0 – запросы будут использовать версию API, соответствующую Kaspersky CyberTrace 4.x.
Значение по умолчанию: <5.
Отладка
Параметр, включающий логирование ресурса. По умолчанию переключатель выключен.
Теги
Теги для поиска ресурса.
Этот тип обогащения используется в коллекторах и корреляторах, чтобы присвоить событию определенный часовой пояс. Сведения о часовом поясе могут понадобиться при поиске событий, случившихся в нетипичное время, например ночью.
При выборе этого типа обогащения в раскрывающемся списке Часовой пояс нужно указать временную зону.
Убедитесь, что выбираемый часовой пояс установлен на сервере сервиса, использующего обогащение. Например, это можно сделать с помощью команды
timedatectl list-timezones, которая показывает все установленные на сервере часовые пояса. Подробнее об установке часовых поясов смотрите в документации используемой вами операционной системы.При обогащении события в поле события DeviceTimeZone записывается смещение времени выбранного часового пояса относительно всемирного координированного времени (UTC) в формате
+-чч:мм. Например, если выбрать временную зону Asia/Yekaterinburg в полеDeviceTimeZoneбудет записано значение+05:00. Если в обогащаемом событии есть значение поляDeviceTimeZone, оно будет перезаписано.По умолчанию, если в обрабатываемом событии не указан часовой пояс и не настроены правила обогащения по часовому поясу, событию присваивается часовой пояс сервера, на котором установлен сервис (коллектор или коррелятор), обрабатывающий событие. При изменении времени сервера сервис требуется перезапустить.
Допустимые форматы времени при обогащении поля DeviceTimeZone
При обработке в коллекторе поступающих сырых событий следующие форматы времени могут быть автоматически приведены к формату
+-чч:мм(см. таблицу ниже):Формат времени в обрабатываемом событии
Пример
+-чч:мм
-07:00
+-ччмм
-0700
+-чч
-07
Если формат даты в поле
DeviceTimeZoneотличается от указанных в таблице, при обогащении события сведениями о часовом поясе в поле записывается часовой пояс серверного времени коллектора. Вы можете создать правила нормализации для нестандартных форматов времени.Этот тип обогащения используется для добавления в поля событий сведений о географическом расположении IP-адресов.
При выборе этого типа в блоке параметров Сопоставление геоданных с полями события укажите, из какого поля события будет считан IP-адрес, а также выберите атрибуты геоданных и определите поля событий, в которые геоданные будут записаны:
- В раскрывающемся списке Поле события с IP-адресом выберите поле события, из которого считывается IP-адрес. По этому IP-адресу будет произведен поиск соответствий по загруженным в KUMA геоданным.
При выборе полей события
SourceAddress,DestinationAddressиDeviceAddressстановится доступна кнопка Применить сопоставление по умолчанию. С ее помощью можно добавить преднастроенные пары соответствий атрибутов геоданных и полей события. - Для каждого поля события, откуда требуется считать IP-адрес, выберите тип геоданных и поле события, в которое следует записать геоданные.
- В поле Атрибут геоданных выберите, какие географические сведения, соответствующие считанному IP-адресу, необходимо записать в событие. Доступные атрибуты геоданных: Страна, Регион, Город, Долгота, Широта.
- В поле Поле события для записи выберите поле события, в которое необходимо записать выбранный атрибут геоданных.
С помощью кнопки Добавить атрибут геоданных вы можете добавить пары полей Атрибут геоданных – Поле события для записи. Так вы можете настроить запись разных типов геоданных одного IP-адреса в разные поля события.
- Для добавления каждого последующего сопоставления используйте кнопку Добавить сопоставление и повторяйте предыдущие два пункта инструкции.
Вы можете записать одинаковые атрибуты геоданных в разные поля событий. Если вы настроите запись нескольких атрибутов геоданных в одно поле события, событие будет обогащено последним по очереди сопоставлением.
DLL Hijacking – это техника атаки, которая заключается в том, что на целевую систему доставляется уязвимое легитимное программное обеспечение вместе с вредоносной динамической библиотекой (DLL). Для обнаружения таких атак Kaspersky SIEM использует модуль AI. Модуль AI анализирует параметры запуска и исполнения программ и определяет подозрительные случаи запуска легитимного программного обеспечения с вредоносными библиотеками.
Для получения заключения Kaspersky SIEM отправляет запрос с информацией из полей события в <KSN>. В ответ на запрос KSN присылает результат анализа.
Вы можете настроить обнаружение атак DLL Hijacking в коллекторе или корреляторе.
Для использования обогащения типа Проверка DLL Hijacking ваша лицензия должна включать в себя модуль AI. Главному администратору также требуется принять дополнительное Положение о KSN в блоке Kaspersky Security Network (Параметры → Интеграции → AI-сервисы → Обнаружение атак DLL Hijacking).
Параметры этого типа обогащения описаны в таблице ниже.
Параметры типа обогащения "DLL Hijacking"
Параметр
Описание
Обработчики
Количество обработчиков, которые сервис может запускать одновременно для параллельной обработки событий. Укажите целое положительное число от 0 до 999. Если указано 0, то используется число логических ядер CPU.
Максимальный размер кеша
Максимальный размер кеша для ответов, получаемых из KSN, в мегабайтах. Значение по умолчанию:
128 МБ.Каждый ответ из KSN имеет свое время жизни, в течение которого он хранится в кеше. Если Kaspersky SIEM отправляет повторный запрос по файлу DLL, для которого KSN уже выдал ответ, и время жизни этого ответа еще не истекло, то запрос не отправляется в KSN, а ответ берется из кеша.
Максимальное количество событий в очереди обогащения
При превышении указанного значения, новые события обрабатываться не будут. Значение по умолчанию:
1 000 000. Значение0означает, что при возникновении очереди события перестают обогащаться.Выполнять повторный запрос
В ответе KSN может выдать заключение В обработке. Этот заключение означает, что KSN принял запрос и в данный момент обрабатывает его, но заключения пока нет. Обработка может занять длительное время, поэтому требуется повторная отправка запроса.
Если этот параметр включен, настройте дополнительные параметры:
- Создавать дубликаты событий – если этот параметр включен, KUMA создает дубликат события и использует его для повторных запросов к KSN. Основное событие при этом отправляется дальше по потоку. Дубликат события будет записан в базу данных, когда выполнится одно из следующих условий:
- Из KSN получено заключение, отличное от В обработке.
- Переполнен дисковый буфер, размер которого указан в параметре Размер буфера.
- Превышено значение, указанное в параметре Количество запросов.
Если этот параметр выключен, KUMA продолжит отправлять запросы с использованием основного события. Событие будет записано в базу данных, когда выполнится одно из следующих условий:
- Из KSN получено заключение, отличное от В обработке.
- Переполнен дисковый буфер, размер которого указан в параметре Размер буфера.
- Превышено значение, указанное в параметре Количество запросов.
- Количество запросов – максимальное количество запросов в KSN. Если за указанное количество запросов так и не будет получено заключение, отличное от В обработке, событие будет записано в базу данных с заключением В обработке. Значение по умолчанию:
10. - Интервал запросов – интервал между запросами, в минутах. Значение по умолчанию:
1 минута. Минимальное значение:1 минута. - Размер буфера – размер дискового буфера, который используется для хранения событий, ожидающих повторного запроса, в мегабайтах. Значение по умолчанию:
10240 МБ. Минимальное значение:10 МБ.
Прокси-сервер
Параметры прокси-сервера, если он требуется для подключения к серверу KSN. Можно выбрать один из доступных или создать новый прокси-сервер. По умолчанию прокси-сервер не используется.
Сопоставление
Таблица параметров, которые нужно отправить в запросе в KSN для получения заключения, и соответствующих полей событий KUMA:
- Хеш файла DLL (md5) – рекомендованное поле для сопоставления:
OldFileHash. - Путь до файла DLL – полный путь, включающий имя файла. Рекомендованное поле для сопоставления:
OldFilePath. Так как путь может содержать персональные данные, Kaspersky SIEM передает этот параметр в KSN в обезличенном виде. Например:Путь до обезличивания:
C:\Windows\Device\HarddiskVolume1\Users\Alex\malware.dllТот же путь в обезличенном виде:
device\harddiskvolume1\users\username - Хеш процесса (md5) – рекомендованное поле для сопоставления:
FileHash. - Путь до процесса – полный путь, включающий имя файла. Так как путь может содержать персональные данные, Kaspersky SIEM передает этот параметр в KSN в обезличенном виде. Например:
Путь до обезличивания:
C:\Windows\Device\HarddiskVolume1\Users\Alex\malware.dllТот же путь в обезличенном виде:
device\harddiskvolume1\users\username - Имя файла DLL – рекомендованное поле для сопоставления:
OldFileName. - Имя процесса – рекомендованное поле для сопоставления:
FileName. - Подпись процесса – поле, в котором указывается поле KUMA, которое передает
OrganizationизSubjectподписи. Если этих значений нет, подпись стоит оставить пустой. Чтобы добавить этот параметр, нажмите на кнопку Добавить, затем в столбце Поле DLL Hijacking в выпадающем списке выберите подпись процесса.необязательный параметр. Hекомендованное поле для сопоставления: FileID. - Размер файла DLL – необязательный параметр; рекомендованное поле для сопоставления: OldFileSize. Чтобы добавить этот параметр, нажмите на кнопку Добавить, затем в столбце Поле DLL Hijacking в выпадающем списке выберите размер файла DLL.
Для каждого параметра укажите в таблице соответствующее ему поле события KUMA.
- Для дополнительного поля с типом
- Если требуется включить логирование операций сервиса, включите переключатель Отладка.
- При необходимости в раскрывающемся списке Теги выберите теги для правила обогащения.
- При необходимости в поле Описание добавьте описание правила обогащения. Описание правила может содержать до 4000 символов в кодировке Unicode.
- Если вы хотите задать условия определения событий, которые будут обрабатываться с применением правила обогащения, в блоке Параметры фильтра в раскрывающемся списке Фильтр выберите или создайте фильтр.
Все поля события KUMA имеют значение по умолчанию. Для всех числовых полей это значение равно
0. Для всех строковых полей значение по умолчанию – пустая строка. Если событие не имеет какого-то поля, это значит, что полю присвоено значение по умолчанию. Поэтому фильтр может сработать на событие, даже если у этого события нет указанного в фильтре поля. Например, если вы в фильтре указали условиеDestinationPort <= 1024, но событие не содержит поляDestinationPort, фильтр сработает, так как по умолчаниюDestinationPort = 0.Чтобы создать фильтр:
- В раскрывающемся списке Фильтр выберите Создать.
- Если вы хотите сохранить фильтр и использовать его в качестве фильтра для других ресурсов, установите флажок Сохранить фильтр. По умолчанию флажок снят.
- Если вы установили флажок Сохранить фильтр, в поле Название введите название нового фильтра. Максимальная длина названия: до 128 символов в кодировке Unicode.
- Выберите режим создания фильтра: Конструктор или Код.
При формировании условий фильтрации вы можете переключаться между режимами. При переключении между режимами сформированные условия фильтров сохраняются. Если после привязки созданного фильтра к ресурсу на вкладке Код не отображается код фильтра, выберите вкладку Конструктор, после чего снова выберите вкладку Код для отображения кода фильтра.
- Если вы выбрали вариант Конструктор, выполните следующие действия:
- В раскрывающемся списке выберите логический оператор:
- И – отбирает события, которые соответствуют всем указанным условиям.
- ИЛИ – отбирает события, которые соответствуют одному из указанных условий.
- НЕ – отбирает события, которые не соответствуют всем указанным условиям.
- Нажмите на кнопку Добавить условие.
- Если вы хотите добавить отрицательное условие, в раскрывающемся списке Если выберите Если не.
- В последовательно отображающихся раскрывающихся списках выберите операнды и операторы фильтра.
- Поля событий – поле события, которое требуется использовать как операнд фильтра.
- Активные листы – активный лист или поле активного листа, которое требуется использовать как операнд фильтра. При выборе активного листа укажите одно или несколько полей событий, которые используются для создания записи активного листа и выступают ключом записи активного листа. Для завершения указания полей событий нажмите комбинацию клавиш 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.
- Если вы хотите добавить группу условий для фильтра, нажмите на кнопку Добавить группу.
Вы можете добавить несколько групп условий.
- В раскрывающемся списке выберите логический оператор:
- Если вы выбрали вариант Код, укажите текстовую команду фильтра.
В правой части конструктора отображается навигатор для перемещения по коду фильтра. Перенос строк выполняется автоматически по логическим операторам И, ИЛИ, НЕ или запятым, являющимися разделителем элементов списка значений.
- Если вы хотите изменить порядок условий фильтрации, используйте значки изменения порядка
. Если вы хотите удалить условие, нажмите на значок удаления
. - Нажмите Сохранить.
- Нажмите на кнопку Создать.
Правило обогащения будет создано и отобразится в таблице.