Словари
Описание параметров
Словари – это ресурсы, в которых хранятся данные, которые могут использоваться другими ресурсами и сервисами KUMA. Словари могут использоваться в следующих сервисах и функциях KUMA:
Доступные параметры словаря описаны в таблице ниже.
Доступные параметры словаря
Параметр | Описание |
|---|---|
Название | Уникальное имя для этого типа ресурса. Максимальная длина имени: до 128 символов в кодировке Unicode. Обязательный параметр. |
Тенант | Название тенанта, которому принадлежит ресурс. Обязательный параметр. |
Описание | Описание ресурса. Максимальная длина описания: до 4000 символов в кодировке Unicode. |
Тип | Тип словаря. От выбранного типа словаря зависит формат данных, которые может содержать словарь:
Обязательный параметр. |
Значения | Таблица с данными словаря.
Если словарь содержит больше 5000 записей, они не отображаются в веб-интерфейсе KUMA. Для просмотра содержимого таких словарей содержимое необходимо экспортировать в формат CSV. Если CSV-файл отредактировать и снова импортировать в KUMA, словарь будет обновлен. |
Импорт и экспорт словарей
Данные словарей можно импортировать или экспортировать в формате CSV (в кодировке UTF-8) с помощью кнопок Импортировать CSV и Экспортировать CSV.
Формат CSV-файла зависит от типа словаря:
- Тип Словарь:
{КЛЮЧ},{ЗНАЧЕНИЕ}\n - Тип Таблица:
{Заголовок столбца 1},{Заголовок столбца N},{Заголовок столбца N+1}\n{Ключ1},{ЗначениеN},{ЗначениеN+1}\n{Ключ2},{ЗначениеN},{ЗначениеN+1}\nКлючи должны быть уникальными как для CSV-файла, так и для словаря. В таблицах ключи указываются в первом столбце. Ключ должен содержать от 1 до 128 символов в кодировке Unicode.
Значения должны содержать от нуля до 256 символов в кодировке Unicode.
При импорте содержимое словаря перезаписывается загружаемым файлом. При импорте в словарь также изменяется название ресурса, чтобы отразить имя импортированного файла.
При экспорте, если ключ или значение содержат символы запятой или кавычек (, и "), они заключаются в кавычки ("). Кроме того, символ кавычки (") экранируется дополнительной кавычкой (").
Если в импортируемом файле обнаружены некорректные строки (например, неверные разделители), то при импорте в словарь такие строки будут проигнорированы, а при импорте в таблицу процесс импорта будет прерван.
Взаимодействие со словарями через API
С помощью REST API можно считывать содержимое словарей типа Таблица, а также изменять его, даже если эти ресурсы используются активными сервисами. Это позволяет, например, настроить обогащение событий данными из динамически изменяемых таблиц, выгружаемых из сторонних приложений.
Предустановленные словари
В поставку KUMA включены перечисленные в таблице ниже словари.
Предустановленные словари
Название словаря | Тип | Описание |
[OOTB] Ahnlab. Severity | dictionary | Содержит таблицу соответствия между идентификатором приоритета и его названием. |
[OOTB] Ahnlab. SeverityOperational | dictionary | Содержит значения параметра SeverityOperational и соответствующее ему описание. |
[OOTB] Ahnlab. VendorAction | dictionary | Содержит таблицу соответствия между идентификатором выполняемой операции и ее названием. |
[OOTB] Cisco ISE Message Codes | dictionary | Содержит коды событий Cisco ISE и соответствующие им имена. |
[OOTB] DNS. Opcodes | dictionary | Содержит таблицу соответствия между десятичными кодами операций DNS и их описаниями, зарегистрированными IANA. |
[OOTB] IANAProtocolNumbers | dictionary | Содержит номера портов транспортных протоколов (TCP, UDP) и соответствующие им имена сервисов, зарегистрированные IANA. |
[OOTB] Juniper - JUNOS | dictionary | Содержит идентификаторы событий JUNOS и соответствующие им описания. |
[OOTB] KEDR. AccountType | dictionary | Содержит идентификатор типа учетной записи и соответствующее ему наименование типа. |
[OOTB] KEDR. FileAttributes | dictionary | Содержит идентификаторы атрибутов файлов, хранимые файловой системой, и соответствующие им описания. |
[OOTB] KEDR. FileOperationType | dictionary | Содержит идентификаторы операций с файлами из API KATA и соответствующие им названия операции. |
[OOTB] KEDR. FileType | dictionary | Содержит идентификаторы измененного файла из API KATA и соответствующие им описания типов файлов. |
[OOTB] KEDR. IntegrityLevel | dictionary | Содержит SID параметра INTEGRITY LEVEL операционной системы Microsoft Windows и соответствующие им описания. |
[OOTB] KEDR. RegistryOperationType | dictionary | Содержит идентификаторы операций с реестром из API KATA и соответствующие им значения. |
[OOTB] Linux. Sycall types | dictionary | Содержит идентификаторы системных вызовов ОС Linux и соответствующие им названия. |
[OOTB] MariaDB Error Codes | dictionary | Словарь содержит коды ошибок СУБД MariaDB и используется нормализатором [OOTB] MariaDB Audit Plugin syslog для обогащения событий. |
[OOTB] Microsoft SQL Server codes | dictionary | Содержит идентификаторы ошибок MS SQL Server и соответствующие им описания. |
[OOTB] MS DHCP Event IDs Description | dictionary | Содержит идентификаторы событий DHCP сервера Microsoft Windows и соответствующие им описания. |
[OOTB] S-Terra. Dictionary MSG ID to Name | dictionary | Содержит идентификаторы событий устройств S-Terra и соответствующие им имена событий. |
[OOTB] S-Terra. MSG_ID to Severity | dictionary | Содержит идентификаторы событий устройств S-Terra и соответствующие им значения Severity. |
[OOTB] Syslog Priority To Facility and Severity | table | Таблица содержит значения Priority и соответствующие ему значения полей Facility and Severity. |
[OOTB] VipNet Coordinator Syslog Direction | dictionary | Содержит идентификаторы направления (последовательность специальных символов), используемые в ViPNet Coordinator для обозначения направления, и соответствующие им значения. |
[OOTB] Wallix EventClassId - DeviceAction | dictionary | Cодержит идентификаторы событий Wallix AdminBastion и соответствующие им описания. |
[OOTB] Windows.Codes (4738) | dictionary | Содержит коды операции, присутствующие в событии аудита MS Windows с идентификатором 4738, и соответствующие им имена. |
[OOTB] Windows.Codes (4719) | dictionary | Содержит коды операции, присутствующие в событии аудита MS Windows с идентификатором 4719, и соответствующие им имена. |
[OOTB] Windows.Codes (4663) | dictionary | Содержит коды операции, присутствующие в событии аудита MS Windows с идентификатором 4663, и соответствующие им имена. |
[OOTB] Windows.Codes (4662) | dictionary | Содержит коды операции, присутствующие в событии аудита MS Windows с идентификатором 4662, и соответствующие им имена. |
[OOTB] Windows. EventIDs and Event Names mapping | dictionary | Содержит идентификаторы событий ОС Windows и соответствующие имена событий. |
[OOTB] Windows. FailureCodes (4625) | dictionary | Содержит идентификаторы из полей Failure Information\Status и Failure Information\Sub Status события 4625 Microsoft Windows и соответствующие им описания. |
[OOTB] Windows. ImpersonationLevels (4624) | dictionary | Содержит идентификаторы из поля Impersonation level событий с идентификатором 4624 Microsoft Windows и соответствующие им описания. |
[OOTB] Windows. KRB ResultCodes | dictionary | Содержит коды ошибок Kerberos v5 и соответствующие им описания. |
[OOTB] Windows. LogonTypes (Windows all events) | dictionary | Содержит идентификаторы типов входов пользователя и соответствующие им наименования. |
[OOTB] Windows_Terminal Server. EventIDs and Event Names mapping | dictionary | Содержит идентификаторы событий Microsoft Terminal Server и соответствующие им имена. |
[OOTB] Windows. Validate Cred. Error Codes | dictionary | Содержит идентификаторы типов входов пользователя и соответствующие им наименования. |
[OOTB] ViPNet Coordinator Syslog Direction | dictionary | Содержит идентификаторы направления (последовательность специальных символов), используемые в ViPNet Coordinator для обозначения направления и соответствующие им значения. |
[OOTB] Syslog Priority To Facility and Severity | table | Cодержит значения Priority и соответствующие ему значения полей Facility and Severity. |
[OOTB] Continent 3.9. Server Access Log Event Type | dictionary | Словарь содержит идентификаторы событий Server Access Log и соответствующие им описания. |
[OOTB] Event Categorization table | table | Таблица, содержащая данные для категоризации событий. |
[OOTB] FTP. Commands descriptions | dictionary | Словарь содержит команды FTP сервера и соответствующие им описания. |
[OOTB] FTP. Server codes | dictionary | Словарь содержит коды FTP сервера и соответствующие им описания. |
[OOTB] Gardatech Garda Monitor application protocol | table | Таблица содержит идентификаторы протоколов и соответствующие им имена. |
[OOTB] Gardatech Garda Monitor transport protocol | table | Таблица содержит идентификаторы протоколов и соответствующие им имена. |
[OOTB] Gardatech Perimeter | table | Таблица содержит значения eventclassid и соответствующие ему значения полей Name. |
[OOTB] H3C module names | dictionary | Словарь содержит значения кодов модулей маршрутизаторов H3C и соответствующие им описания модулей. |
[OOTB] HTTP. Status codes | table | Таблица содержит коды состояния HTTP и соответствующие им имена. |
[OOTB] InfoWatch Person Monitor. Operations names | table | Таблица содержит идентификаторы событий InfoWatch Person Monitor и соответствующие им имена. |
[OOTB] Linux. Auditd record types | table | Словарь содержит идентификаторы событий ОС Linux и соответствующие им названия. |
[OOTB] Microsoft DNS Server. EventIDs and Event Names | dictionary | Словарь содержит идентификаторы событий Microsoft DNS Server (из журнала Microsoft - Windows - DNS-Server – Audit) и соответствующие имена событий. |
[OOTB] Microsoft Office 365. Event names | dictionary | Словарь содержит имена событий Microsoft Office 365. |
[OOTB] Microsoft Office 365. User Type | dictionary | Словарь содержит сопоставления номеров типов пользователей с их текстовыми значениями Microsoft Office 365. |
[OOTB] OrionSoft Termit event descriptions | table | Таблица содержит имена событий OrionSoft Termit и соответствующие им описания. |
[OOTB] VK WorkSpace. Mail Event descriptions | table | Таблица содержит идентификаторы типов событий VK WorkSpace. Mail и соответствующие им описания. |
[OOTB] Veeam Backup. EventIDs and Event Names | dictionary | Словарь содержит идентификаторы событий Veeam Backup и соответствующие имена событий. |
[OOTB] Windows Hyper-V EventID-Name | dictionary | Словарь содержит идентификаторы событий Microsoft Hyper-V и соответствующие им имена событий. |
[OOTB] Windows. FailureCodes (4625) | dictionary | Словарь содержит идентификаторы из полей "Failure Information\Status", "Failure Information\Sub Status" события 4625 Microsoft Windows и соответствующие им описания. |
[OOTB] Windows. GroupPolicy EventIDs and Event Names mapping | table | Таблица содержит идентификаторы событий аудита групповых политик ОС Windows и соответствующие им имена событий. |
[OOTB] Windows. Task category codes | dictionary | Словарь содержит идентификаторы параметра Task Category событий аудита ОС Windows и соответствующие им имена. |
[OOTB] Windows_Sysmon. EventIDs and Event Names mapping | dictionary | Словарь содержит идентификаторы событий Sysmon и соответствующие имена событий. |
[OOTB] Yandex Cloud | table | Таблица содержит идентификаторы сервисов Yandex Cloud и соответствующие им имена. |
[OOTB] Zabbix. ResourceType | table | Словарь содержит идентификаторы ресурсов Zabbix и соответствующие им наименования. |
[OOTB] NPO Fractel SSPT-4. Event names | table | Данная таблица содержит идентификаторы событий системы НПО Фрактел ССПТ-4A1 и соответствующие им имена событий. |
. Для удаления строки из таблицы наведите курсор мыши на строку таблицы и нажмите на отобразившуюся кнопку
.