Skip to main content

KSC MariaDB

Информация, приведенная на данной странице, является разработкой команды pre-sales и/или community KUMA и НЕ является официальной рекомендацией вендора.

Настройка MariaDB

В MariaDB настройки на сервере базы данных можно выполнять несколькими способами: через консоль (SSH, терминал ОС) или с помощью графических интерфейсов, таких как phpMyAdmin или MySQL Workbench

В данной статье сервер БД PostgreSQL работает под управлением ОС Ubuntu 22.04.5, а все настройки выполняются в консоли.

Для удобства в базе данных MariaDB Kaspersky Security Center предусмотрен набор публичных представлений. Таким образом можно создавать запросы непосредственно к публичным представлениям и извлекать из них данные о событиях. "Коробочный" коннектор KUMA [OOTB] KSC MySQL содержит уже готовые запросы к публичным представлениям v_akpub_ev_event и v_akpub_host.

Для обеспечения корректной работы MariaDB с Kaspersky Security Center рекомендуется использовать версии MariaDB начиная с 10.5.17 или более новые.

Проверка имени БД KSC

Чтобы проверить имя базы данных KSC можно воспользоваться следующей статьей:

Просмор имени базы данных Kaspersky Security Center Linux - (KSC Linux) - https://support.kaspersky.ru/ksc-linux/15.1/228689

Альтернативным вариантом является проверка имени БД в консоли сервера, на котором установлена БД KSC:

  • Подключитесь к серверу базы данных 
    mariadb -h localhost -u admin -p
  • Запустите интерактивный терминал MariaDB и выведите список баз данных сервера 
    SHOW  DATABASES;

    image.png

Создание роли БД и предоставление прав

Подключитесь к серверу базы данных

  • Подключитесь к серверу базы данных
    mariadb -h localhost -u admin -p
  • Создайте роль пользователя kuma
    CREATE USER username IDENTIFIED  by 'password';
  • Предоставьте права роли KUMA к таблицам созданной БД:
    GRANT SELECT ON `название базы данных`.`таблица` TO `имя пользователя БД`@`хост с которого идет подключение`;
    GRANT SELECT ON `KAV`.`v_akpub_hst_prdstate` TO `kuma_siem`@`%`; # % - все хосты                                 
    GRANT SELECT ON `KAV`.`v_akpub_ev_event` TO `kuma_siem`@`%`;                                            
    GRANT SELECT ON `KAV`.`v_akpub_host_status` TO `kuma_siem`@`%`;                                           
    GRANT SELECT ON `KAV`.`v_akpub_virus_activity` TO `kuma_siem`@`%`;                                        
    GRANT SELECT ON `KAV`.`v_akpub_host` TO `kuma_siem`@`%` 
  • Проверьте права пользователя 
    SHOW GRANTS FOR 'kuma_siem'@'%';

    image.png

При необходимости разрешите входящие соединения на порт БД MariaDB (по умолчанию, TCP/3306) в параметрах локального FW.

Создание секрета KUMA

  1. В веб-интерфейсе KUMA перейдите на вкладку Ресурсы → Секреты → Добавить

image.png

2. Создайте секрет MariaDB, В появившемсе окне задайте  

  • URL (формат URL можно взять из Описания к секрету). В поле URL укажите:
    • Имя ранее созданной роли (в нашем примере это kuma_siem) и ее пароль;
    • протокол подключения
    • IP-адрес или FQDN сервера БД ;
    • порт подключения
    • Наименование БД KSC (по умолчанию KAV. См. Проверка имени БД KSC).
mysql://<имя пользователя БД>:<Пароль>@<протокол подключения>(<IP-адрес или FQDN сервера БД>)/<имя Базы данных>

image.png

Если в пароле используются спецсимволы необходимо перевести данные спецсимволы в URL формат в соответствии с таблицей ниже.

Примеры

mysql://kuma:p%40ssword123%2@tcp(ip:port)/KAV

! # $ % & ' ( ) * +
%21 %23 %24 %25 %26 %27 %28 %29 %2A %2B
, / : ; = ? @ [ ] \
%2C %2F %3A %3B %3D %3F %40 %5B %5D %5C

Можно использовать следующий ресурс для преобразования https://www.urlencoder.org/

Пример:

image.png

3. Нажмите Сохранить

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

Настройка коннектора

  1.  В веб-интерфейсе KUMA перейдите в раздел Ресурсы → Коннекторы
  2.  В списке коннекторов справа найдите коннектор [OOTB] KSC MySQL и нажмите Дублировать


    image.png

     

    1.  В появившемся окне задайте:   
      • название коннектора
      • На вкладке Основные параметры в разделе Соединение в выпадающих списках URL выберите секрет, созданный ранее для подключения к БД MariaDB KSC


image.png

image.png


В запросе смените название БД на заданную ранее, в нашем случае KAV

image.png

image.png



Настройка коллектора

1. В веб-интерфейсе KUMA перейдите в раздел Ресурсы и нажмите Подключить источник

2. В появившемся окне задайте Название коллектора и Тенант

3. На шаге Транспорт выберите ранее созданный коннектор

4. На шаге Парсинг событий выберите нормализатор [OOTB] KSC from SQL.

5. На шаге Маршрутизация задайте следующие точки назначения:

  • Хранилище. Для отправки обработанных событий в хранилище.
  • Коррелятор. Для отправки обработанных событий в коррелятор.

6. На шаге Проверка параметров нажмите Сохранить и создать сервис.

7. Скопируйте появившуюся команду и выполните установку сервиса коллектора.

Проверка поступления событий  KSC в KUMA 

Для проверки, что экспорт событий из БД KSC успешно настроен, перейдите в Ресурсы -> Активные сервисы -> выберите ранее созданный коллектор KSC PostgreSQL и нажмите Перейти к событиям

image.png

В открывшемся окне События убедитесь, что присутствуют события KSC.

image.png

Полезные ссылки 

Настройка сервера MariaDB x64 для работы с Kaspersky Security Center Linux - https://support.kaspersky.ru/ksc-linux/15/210277

Коннекторы типа sql в kuma - https://support.kaspersky.ru/kuma/3.2/220746