# KSC MariaDB

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

### Настройка MariaDB

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

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

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

<p class="callout warning">Для обеспечения корректной работы MariaDB с Kaspersky Security Center рекомендуется использовать версии MariaDB начиная с 10.5.17 или более новые.</p>

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

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

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

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

- Подключитесь к серверу базы данных ```
    mariadb -h localhost -u admin -p
    ```
    
    где, вместо `admin` задайте логин своего пользователя MariaDB
- Запустите интерактивный терминал MariaDB и выведите список баз данных сервера ```mysql
    SHOW  DATABASES;
    ```
    
    ![image.png](https://kb.kuma-community.ru/uploads/images/gallery/2024-11/scaled-1680-/Sosimage.png)

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

- <div>Подключитесь к серверу базы данных</div>```
    mariadb -h localhost -u admin -p
    ```
- Создайте роль пользователя для сбора событий, в данном примере - `kuma_siem````mysql
    CREATE USER kuma_siem IDENTIFIED  by 'password';
    ```
- Предоставьте права роли KUMA к публичным представлениям: ```mysql
    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`@`%` 
    ```
    
    Права предоставляются в виде:
    
    ```mysql
    GRANT SELECT ON `название базы данных`.`таблица` TO `имя пользователя БД`@`хост с которого идет подключение`;
    # % - все хосты  
    ```
- Проверьте права пользователя ```mysql
    SHOW GRANTS FOR 'kuma_siem'@'%';
    ```
    
    ![image.png](https://kb.kuma-community.ru/uploads/images/gallery/2024-11/scaled-1680-/sm4image.png)

<p class="callout info">При необходимости разрешите входящие соединения на порт БД MariaDB (по умолчанию, TCP/3306) в параметрах локального FW, а также в настройках конфигурационного файла my.cnf</p>

---

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

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

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

- URL (формат URL можно взять из **Описания** к секрету). В поле URL укажите: 
    - Имя ранее созданной роли (в нашем примере это **kuma\_siem**) и ее пароль;
    - Протокол подключения
    - IP-адрес или FQDN сервера БД ;
    - Порт подключения (по умолчанию `3306`)
    - Наименование БД KSC (по умолчанию `KAV`. См. **Проверка имени БД KSC**).

```bash
mysql://<имя пользователя БД>:<Пароль>@<протокол подключения>(<IP-адрес или FQDN сервера БД>:<порт>)/<имя Базы данных>
```

Например: `mysql://kuma_siem:password@tcp(10.10.10.10:3306)/KAV`

<p class="callout info">Если в пароле используются спецсимволы необходимо перевести данные спецсимволы в URL формат в соответствии с таблицей ниже.</p>

<details id="bkmrk-%D0%9F%D1%80%D0%B8%D0%BC%D0%B5%D1%80%D1%8B-mysql%3A%2F%2Fkuma"><summary>Примеры</summary>

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

</details><table border="1" id="bkmrk-%21-%23-%24-%25-%26-%27-%28-%29-%2A-%2B-" style="border-collapse: collapse; width: 100%; height: 118.807px;"><colgroup><col style="width: 10.0108%;"></col><col style="width: 10.0108%;"></col><col style="width: 10.0108%;"></col><col style="width: 10.0108%;"></col><col style="width: 10.0108%;"></col><col style="width: 10.0108%;"></col><col style="width: 10.0108%;"></col><col style="width: 10.0108%;"></col><col style="width: 10.0108%;"></col><col style="width: 10.0108%;"></col></colgroup><tbody><tr style="height: 29.7017px;"><td style="height: 29.7017px;">!</td><td style="height: 29.7017px;">\#</td><td style="height: 29.7017px;">$</td><td style="height: 29.7017px;">%</td><td style="height: 29.7017px;">&amp;</td><td style="height: 29.7017px;">'</td><td style="height: 29.7017px;">(</td><td style="height: 29.7017px;">)</td><td style="height: 29.7017px;">\*</td><td style="height: 29.7017px;">+</td></tr><tr style="height: 29.7017px;"><td style="height: 29.7017px;">%21</td><td style="height: 29.7017px;">%23</td><td style="height: 29.7017px;">%24</td><td style="height: 29.7017px;">%25</td><td style="height: 29.7017px;">%26</td><td style="height: 29.7017px;">%27</td><td style="height: 29.7017px;">%28</td><td style="height: 29.7017px;">%29</td><td style="height: 29.7017px;">%2A</td><td style="height: 29.7017px;">%2B</td></tr><tr style="height: 29.7017px;"><td style="height: 29.7017px;">,</td><td style="height: 29.7017px;">/</td><td style="height: 29.7017px;">:</td><td style="height: 29.7017px;">;</td><td style="height: 29.7017px;">=</td><td style="height: 29.7017px;">?</td><td style="height: 29.7017px;">@</td><td style="height: 29.7017px;">\[</td><td style="height: 29.7017px;">\]</td><td style="height: 29.7017px;">\\</td></tr><tr style="height: 29.7017px;"><td>%2C</td><td>%2F</td><td>%3A</td><td>%3B</td><td>%3D</td><td>%3F</td><td>%40</td><td>%5B</td><td>%5D</td><td>%5C</td></tr></tbody></table>

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

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

<p class="callout warning">Обратите внимание, после сохранения секрета поле URL будет пустым во избежание утечки чувствительной информации.</p>

---

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

1\. В веб-интерфейсе KUMA перейдите в раздел **Ресурсы** → **Коннекторы**

2\. В списке коннекторов найдите коннектор **\[OOTB\] KSC MySQL**, отметьте его галочкой и нажмите **Дублировать**

3\. В появившемся окне задайте:

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

<p class="callout warning">Обратите внимание, что в коннекторе используется несколько запросов! URL подключения необходимо заменить для **ВСЕХ** запросов.</p>

4\. В запросе смените название БД (`ksc_srv`) на имя БД KSC, в нашем случае `KAV` (по умолчанию)

![image.png](https://kb.kuma-community.ru/uploads/images/gallery/2024-11/scaled-1680-/dvuimage.png)

![image.png](https://kb.kuma-community.ru/uploads/images/gallery/2024-11/scaled-1680-/4iVimage.png)

<p class="callout warning">Обратите внимание, что в коннекторе используется несколько запросов! Название БД необходимо заменить для **ВСЕХ** запросов.</p>

---

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

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

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

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

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

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

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

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

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

---

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

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

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

### ![image.png](https://kb.kuma-community.ru/uploads/images/gallery/2024-11/scaled-1680-/QY7image.png)

---

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

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

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