# Активы

Добавление активов в KUMA различными способами

# Интеграция KUMA с KSC

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

<p class="callout info">Официальная документация по данному разделу приведена в Онлайн-справке на продукт: [https://support.kaspersky.com/KUMA/2.1/ru-RU/217923.htm](https://support.kaspersky.com/KUMA/2.1/ru-RU/217923.htm) </p>

<iframe allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen="allowfullscreen" class=" align-center" frameborder="0" height="315" src="https://www.youtube.com/embed/u6v3qbDmu2Q?si=8K7B8BzkDDmL7KnX" title="YouTube video player" width="560"></iframe>

Интеграция KUMA с KSC позволяет получить активы и данные по ним, которыми управляет KSC, возможность запуска задач реагирования, перемещение активов между группами KSC, закрытие уязвимостей (при наличии лицензии от Kaspersky Endpoint Security для бизнеса Расширенный и выше) из интерфейса KUMA.

Для интеграции необходимо заранее создать учетную запись (внутреннего пользователя) в KSC:

[![image.png](https://kb.kuma-community.ru/uploads/images/gallery/2023-08/scaled-1680-/aY3image.png)](https://kb.kuma-community.ru/uploads/images/gallery/2023-08/aY3image.png)

<p class="callout info">Допускается также использовать доменную учетную запись пользователя для интеграции KUMA с KSC. Учетная запись пользователя в секрете KUMA указывается в формате: username@domain</p>

Если на KSC включено MFA, то нужно сделать исключение для учетки KUMA. Согласно этой инструкции: [https://support.kaspersky.com/help/KSC/14.2/ru-RU/211462.htm](https://support.kaspersky.com/help/KSC/14.2/ru-RU/211462.htm)

В дополнение к исключению MFA для интеграционной УЗ KUMA можно настроить список адресов, с которых разрешено подключение к KSC: [https://support.kaspersky.com/KSC/14.2/ru-RU/231374.htm](https://support.kaspersky.com/KSC/14.2/ru-RU/231374.htm)

Созданной учетной записи необходимо назначить определенный набор прав доступа к функциям Kaspersky Security Center. Это можно сделать одним из следующих способов:

- настроить права для учетной записи индивидуально;
- создать роль пользователя с настроенным набором прав и присвоить данную роль учетной записи, которая будет использоваться для интеграции.

Перечень минимальных прав представлен на рисунке ниже. Данный набор прав позволяет:

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

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

<p class="callout info">Права пользователю нужно выдавать не только в свойствах KSC, но и в свойствах групп управляемых устройств, убедитесь, что не отключено наследование, чтобы права корректно распространялись на подгруппы</p>

На стороне KUMA необходимо указать адрес и порт 13299 (этот порт используется по умолчанию), а также УЗ, о которой говорилось выше.

[![image.png](https://kb.kuma-community.ru/uploads/images/gallery/2023-08/scaled-1680-/Mezimage.png)](https://kb.kuma-community.ru/uploads/images/gallery/2023-08/Mezimage.png)

При нажатии в KUMA на кнопку "Сохранить", не должно всплавать сообщений об ошибке.

<p class="callout warning">Если при выгрузке, отсутствует какая-либо группа или возникает ошибка - убедитесь, что включено наследование параметров сервера в каталогах и отсутсвуют "мертвые души" в иерархии</p>

# Импорт активов из KATA/NDR

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

<p class="callout warning">Данная инструкция предназначена строго для версии KATA/NDR **7.0**.</p>

<p class="callout warning">Данная инструкция предназначена для импорта информации об активах, полученной KATA/NDR в KUMA.</p>

### Настройка KATA/NDR

Для настройки пересылки событий из KATA/NDR в SIEM KUMA необходимо выполнить следующие действия:

1\. Перейти в веб-консоль KATA/NDR из-под учетной записи Администратора

2\. Перейти в раздел **Параметры** – **Коннекторы** и нажать на кнопку **Добавить коннектор**

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

3\. В открывшемся окне настроить параметры интеграции с KUMA:  
 **Тип коннектора**: KUMA;  
**Имя коннектора**: произвольное название, например, *KUMA;* **Пароль доступа к сертификату коннектора**: задайте пароль для файла свертки;  
**Пароль (повторно)**: повторите введенный ранее пароль;  
**Адрес сервера**: Адрес CN KATA/NDR;  
**Узел размещения коннектора**: Адрес сервера в кластере KATA/NDR для размещения коллектора (в случае Single node будет совпадать с предыдущем пунктом);  
**Пользователь программы**: выбрать нужного из выпадающего списка.

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

3\. По завершении заполнения необходимых полей нажать кнопку **Сохранить**.

В результате будет загружен архив, а также в интерфейсе KATA/NDR созданный коннектор перейдет в состояние **Работает**.

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

---

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

Перейдите в веб-интерфейс KUMA на вкладку Параметры - KICS/KATA и задайте параметры интеграции:

**Выключено**: галочка должна быть снята для работы интеграции;  
**Тенант**: выберите необходимый тенант из выпадающего списка*;* **Включить реагирование**: требуется для изменения статуса устройств;  
**Файл свертки:** загрузите архив, полученный при настройке на стороне KATA/NDR; **Пароль файла свертки**: укажите пароль от архива, заданный при настройке на стороне KATA/NDR;

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

По окончании настройки нажмите кнопку **Сохранить**.

---

# Nessus и OWASP ZAP

В KUMA можно импортировать сведения об активах из отчетов о результатах сканирования устройств с помощью Nessus, OWASPZAP, системы контроля защищенности и соответствия стандартам. Импорт происходит через API с помощью утилиты `import_asset_Nessus_OWASP.py` (скрипт находится в Community-Pack в папке Assets \[ссылка доступна из [Дисклеймера](https://kb.kuma-community.ru/)\]). Импортированные активы отображаются в веб-интерфейсе KUMA в разделе Активы. При необходимости вы можете редактировать параметры активов.

### Предварительные настройки в KUMA

Создайте пользователя с ролью **главный администратор** со следующими **правами доступа для API**:

- GET /tenants
- GET /users/whoami
- POST /assets/import

[![image.png](https://kb.kuma-community.ru/uploads/images/gallery/2023-12/scaled-1680-/FBZimage.png)](https://kb.kuma-community.ru/uploads/images/gallery/2023-12/FBZimage.png)

Сохраните настройки, **сгенерируйте токен** и отдельно сохраните его, например, в каком-либо текстовом редакторе. Нажмите **Сохранить**.

Добавьте **дополнительнео поле** с названием «Description» в разделе **Параметры - Активы - Пользовательские атрибуты**.

[![image.png](https://kb.kuma-community.ru/uploads/images/gallery/2023-12/scaled-1680-/J5cimage.png)](https://kb.kuma-community.ru/uploads/images/gallery/2023-12/J5cimage.png)

**Сохраните** изменения.

### Импорт отчета от Nessus

Пример отчета от Nessus в формате CSV:

```
Plugin ID,CVE,CVSS v2.0 Base Score,Risk,Host,Protocol,Port,Name,Synopsis,Description,Solution,See Also,Plugin Output,STIG Severity,CVSS v3.0 Base Score,CVSS v2.0 Temporal Score,CVSS v3.0 Temporal Score,VPR Score,Risk Factor,BID,XREF,MSKB,Plugin Publication Date,Plugin Modification Date,Metasploit,Core Impact,CANVAS
"70658","CVE-2008-5161","2.6","Low","1.2.3.9","tcp","22","SSH Server CBC Mode Ciphers Enabled","The SSH server is configured to use Cipher Block Chaining.","The SSH server is configured to support Cipher Block Chaining (CBC)encryption.  This may allow an attacker to recover the plaintext messagefrom the ciphertext.Note that this plugin only checks for the options of the SSH server anddoes not check for vulnerable software versions.","Contact the vendor or consult product documentation to disable CBC modecipher encryption, and enable CTR or GCM cipher mode encryption.","","The following client-to-server Cipher Block Chaining (CBC) algorithmsare supported:3des-cbcaes128-cbcaes192-cbcaes256-cbcblowfish-cbccast128-cbcThe following server-to-client Cipher Block Chaining (CBC) algorithmsare supported:3des-cbcaes128-cbcaes192-cbcaes256-cbcblowfish-cbccast128-cbc","","","1.9","","2.5","Low","32319","CERT:958563;CWE:200","","2013/10/28","2018/07/30","","",""
```

Далее необходимо хапустить скрипт `import_asset_Nessus_OWASP.py` по этому отчету указав необходимые параметры для его корректного запуска. Возможные опции скрипта:

```python
# python import_asset.py --help
usage: import_asset.py [-h] --kuma KUMA --token TOKEN --tenant TENANT --vendor {Nessus,OWASPZAP} --filepath FILEPATH

options:
  -h, --help                  show this help message and exit
  --kuma KUMA                 IP адрес сервера KUMA
  --token TOKEN               Токен API
  --tenant TENANT             Имя Тенанта
  --vendor {Nessus,OWASPZAP}  Наименование вендора
  --filepath FILEPATH         Путь до отчета
```

Пример запуска по отчету Nessus:

```python
python3 import_asset_Nessus_OWASP.py --kuma 10.68.85.126 --token 98417b064c2a5cdfdf6bd011126c6453 --tenant  Main --vendor Nessus --filepath C:\Users\ose\Downloads\nessus.csv
```

В KUMA актив будет выглядит следующим образом:

[![image.png](https://kb.kuma-community.ru/uploads/images/gallery/2023-12/scaled-1680-/kmzimage.png)](https://kb.kuma-community.ru/uploads/images/gallery/2023-12/kmzimage.png)

### Импорт отчета от OWASP ZAP

Пример отчета от Nessus в формате CSV:

```json
{
    "@programName": "OWASP ZAP",
    "@version": "2.13.0",
    "@generated": "Mon, 25 Sep 2023 11:43:20",
    "site": [
        {
            "@name": "https://demo.lab",
            "@host": "demo.lab",
            "@port": "443",
            "@ssl": "true",
            "alerts": [
                {
                    "pluginid": "10035",
                    "alertRef": "10035",
                    "alert": "Strict-Transport-Security Header Not Set",
                    "name": "Strict-Transport-Security Header Not Set",
                    "riskcode": "1",
                    "confidence": "3",
                    "riskdesc": "Low (High)",
					"reference": "https://ya.ru",
                    "desc": "<p>HTTP Strict Transport Security (HSTS)"
                }
            ]
        }
    ]
}
```

Далее необходимо хапустить скрипт `import_asset_Nessus_OWASP.py` по этому отчету указав необходимые параметры для его корректного запуска. Возможные опции скрипта:

```python
# python import_asset.py --help
usage: import_asset.py [-h] --kuma KUMA --token TOKEN --tenant TENANT --vendor {Nessus,OWASPZAP} --filepath FILEPATH

options:
  -h, --help                  show this help message and exit
  --kuma KUMA                 IP адрес сервера KUMA
  --token TOKEN               Токен API
  --tenant TENANT             Имя Тенанта
  --vendor {Nessus,OWASPZAP}  Наименование вендора
  --filepath FILEPATH         Путь до отчета
```

Пример запуска по отчету OWASP ZAP:

```python
python3 import_asset_Nessus_OWASP.py --kuma 10.68.85.126 --token 98417b064c2a5cdfdf6bd011126c6453 --tenant  Main --vendor OWASPZAP --filepath C:\Users\ose\Downloads\owasp.json
```

В KUMA актив будет выглядит следующим образом:

[![image.png](https://kb.kuma-community.ru/uploads/images/gallery/2023-12/scaled-1680-/lfnimage.png)](https://kb.kuma-community.ru/uploads/images/gallery/2023-12/lfnimage.png)

# Импорт информации об активах RedCheck

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

### Импорт информации об активах RedCheck

В KUMA можно импортировать сведения об активах из отчетов о результатах сканирования сетевых устройств с помощью RedCheck, системы контроля защищенности и соответствия стандартам. Импорт происходит через API с помощью утилиты `redcheck-tool.py`. Импортированные активы отображаются в веб-интерфейсе KUMA в разделе Активы. При необходимости вы можете редактировать параметры активов.

<p class="callout info">Импорт поддерживается из RedCheck 2.6.8 и выше</p>

<p class="callout info">Поддерживается импорт информации о хостах только под управлением ОС Windows</p>

<p class="callout warning">Для работы утилиты требуется python верси 3.6 или выше, а также библиотеки: csv, re, json, requests, argparse, sys  
</p>

Чтобы импортировать данные об активах из отчета RedCheck:

1\. Сформируйте в RedCheck отчет сканирования сетевых активов в формате CSV и скопируйте файл отчета на сервер со скриптом. Подробнее о задачах на сканирование и форматах выходных файлов см. в документации RedCheck.

<p class="callout warning">Импорт доступен из "Простых" отчетов "**Уязвимости**" и "**Инвентаризация**" сгруппированных по хостам в формате CSV. Подробнее на сайте RedCheck: [https://docs.redcheck.ru/articles/#!redcheck-user-269/reports](https://docs.redcheck.ru/articles/#!redcheck-user-269/reports) </p>

2\. Создайте токен для доступа к KUMA REST API.

Требования к учетным записям, для которых генерируется API-токен:

- Роль Администратора или Аналитика.
- Доступ к тенанту, в который будут импортированы активы.
- Настроены права на использование API-запросов GET /assets, GET /tenants, POST /assets/import

3\. Скопируйте утилиту redcheck-tool.py на сервер ядра KUMA и сделайте файл утилиты исполняемым с помощью команды:

```bash
chmod +x <путь до файла redcheck-tool.py>
```

4\. Запустите утилиту redcheck-tool.py:

```bash
python3 redcheck-tool.py --kuma-rest <адрес и порт сервера KUMA REST API> --token <API-токен> --tenant <название тенанта, куда будут помещены активы> --vuln-report <Полный путь к файлу отчета "Уязвимости"> --inventory-report <Полный путь к файлу с отчета "Инвентаризация">
```

Пример:

```bash
python3 --kuma-rest example.kuma.com:7223 --token 949fc03d97bad5d04b6e231c68be54fb --tenant Main --vuln-report /home/user/vuln.csv --inventory-report /home/user/inventory.csv
```

Вы можете использовать дополнительные флаги и команды для импорта. Например, команду для отображения расширенного отчета о полученных активах `-v`. Подробное описание доступных флагов и команд приведено в таблице Флаги и команды утилиты redcheck-tool.py. Также для просмотра информации о доступных флагах и командах вы можете использовать команду `--help`.

Информация об активах будет импортирована из отчета RedCheck в KUMA. В консоли отображаются сведения о количестве новых и обновленных активов.

Пример:

```
inventory has been imported for 2 host(s)
software has been imported for 5 host(s)
vulnerabilities has been imported for 4 host(s)
```

Пример расширенного вывода информации об импорте:

```
[inventory import]           Host: localhost        Code: 200  Response: {'insertedIDs': {'0': '52ca11c6-a0e6-4dfd-8ef9-bf58189340f8'}, 'updatedCount': 0, 'errors': []}
[inventory import]           Host: 10.0.0.2         Code: 200  Response: {'insertedIDs': {'0': '1583e552-5137-4164-92e0-01e60fb6edb0'}, 'updatedCount': 0, 'errors': []}
[software import][error]     Host: localhost        Skipped asset with FQDN localhost or IP 127.0.0.1
[software import]            Host: 10.0.0.2         Code: 200  Response: {'insertedIDs': {}, 'updatedCount': 1, 'errors': []}
[vulnerabilities import]     Host: 10.0.0.2         Code: 200  Response: {'insertedIDs': {}, 'updatedCount': 1, 'errors': []}
[vulnerabilities import]     Host: 10.0.0.1         Code: 200  Response: {'insertedIDs': {'0': '0628f683-c20c-4107-abf3-d837b3dbbf01'}, 'updatedCount': 0, 'errors': []}
[vulnerabilities import]     Host: localhost        Code: 200  Response: {'insertedIDs': {}, 'updatedCount': 1, 'errors': []}
[vulnerabilities import]     Host: 10.0.0.3         Code: 200  Response: {'insertedIDs': {'0': 'ed01e0a8-dcb0-4609-ab2b-91e50092555d'}, 'updatedCount': 0, 'errors': []}
inventory has been imported for 2 host(s)
software has been imported for 1 host(s)
vulnerabilities has been imported for 4 host(s)
```

Поведение утилиты при импорте активов:

- Данные импортированных в KUMA через API активов перезаписываются, а сведения об их устраненных уязвимостях удаляются.
- Активы с недействительными данными пропускаются.

#### Флаги и команды утилиты redcheck-tool.py

<table border="1" id="bkmrk-%D0%A4%D0%BB%D0%B0%D0%B3%D0%B8-%D0%B8-%D0%BA%D0%BE%D0%BC%D0%B0%D0%BD%D0%B4%D1%8B-%D0%9E%D0%B1%D1%8F%D0%B7" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 44.7355%;"></col><col style="width: 15.6959%;"></col><col style="width: 39.5439%;"></col></colgroup><tbody><tr><td class="align-center">**Флаги и команды**</td><td>**Обязательный**</td><td class="align-center">**Описание**</td></tr><tr><td>--kuma-rest &lt;адрес и порт сервера ядра KUMA&gt;</td><td style="text-align: justify;">Да</td><td style="text-align: justify;">По умолчанию для обращения по API используется порт 7223. При необходимости его можно изменить.</td></tr><tr><td>--token &lt;токен&gt;</td><td style="text-align: justify;">Да</td><td style="text-align: justify;">Значение в параметре должно содержать только токен. Учетной записи, для которой генерируется API-токен, должна быть присвоена роль Администратора или Аналитика.</td></tr><tr><td>--tenant &lt;название тенанта&gt;</td><td>Да</td><td>Название тенанта KUMA, в который будут импортированы активы из отчета RedCheck</td></tr><tr><td>--vuln-report &lt;полный путь к файлу отчета "Уязвимости"&gt;</td><td>Да</td><td>Файл должен содержать отчет "Уязвимости" в формате CSV</td></tr><tr><td>--inventory-report &lt;полный путь к файлу отчета "Инвентаризация"&gt;</td><td>Нет</td><td>Файл должен содержать отчет "Инвентаризация" в формате CSV</td></tr><tr><td>-v </td><td>Нет</td><td>Выведение расширенной информации об импорте активов</td></tr></tbody></table>

#### Возможные ошибки

<table border="1" id="bkmrk-%D0%A1%D0%BE%D0%BE%D0%B1%D1%89%D0%B5%D0%BD%D0%B8%D0%B5-%D0%BE%D0%B1-%D0%BE%D1%88%D0%B8%D0%B1%D0%BA%D0%B5-" style="border-collapse: collapse; width: 100%; height: 207.2px;"><colgroup><col style="width: 50.0494%;"></col><col style="width: 50.0494%;"></col></colgroup><tbody><tr style="height: 29.6px;"><td class="align-center" style="height: 29.6px;">**Сообщение об ошибке**</td><td class="align-center" style="height: 29.6px;">**Описание**</td></tr><tr style="height: 29.6px;"><td style="height: 29.6px;">Tenant %w not found</td><td style="height: 29.6px;">Имя тенанта не найдено</td></tr><tr style="height: 29.6px;"><td style="height: 29.6px;">Tenant search error: Unexpected status Code: %d</td><td style="height: 29.6px;">При поиске тенанта был получен неожиданный код ответа HTTP</td></tr><tr style="height: 29.6px;"><td style="height: 29.6px;">Asset search error: Unexpected status Code: %d</td><td style="height: 29.6px;">При поиске актива был получен неожиданный код ответа HTTP</td></tr><tr style="height: 29.6px;"><td style="height: 29.6px;">\[%w import\]\[error\] Host: %w Skipped asset with FQDN localhost or IP 127.0.0.1</td><td style="height: 29.6px;">При импорте информации инвентаризации/уязвимостей был пропущен хост с fqdn=localhost или ip=127.0.0.1</td></tr></tbody></table>

# Импорт данных из отчетов MaxPatrol в KUMA 3.2

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

<p class="callout success">Ссылка на документацию [https://support.kaspersky.com/help/KUMA/3.2/ru-RU/265426.htm](https://support.kaspersky.com/help/KUMA/3.2/ru-RU/265426.htm) </p>

#### Импорт

Утилита для импорта находится в следующей директории **kuma-ansible-installer/roles/kuma/files/maxpatrol-tool**

Для импорта необходимо выполнить следующие шаги:

1. Сформировать отчет **сканирования сетевых активов в формате <span class="boldcharacter">XML file  
    </span>**
2. <span class="boldcharacter">Поместить отчет и скрипт в одной директории (можно выполнить на ядре KUMA)</span>
3. <span class="boldcharacter">Подготовить API права для утилиты:</span>
    1. <span class="boldcharacter">В KUMA создать пользователя kuma-mp</span>
    2. <span class="boldcharacter">Дать права на **GET /users/whoami** и **POST /assets/import**</span>
    3. Сгенерировать токен (его сохранить в файл на сервере, где будет выполнятся команда
4. Далее в веб-консоли KUMA нужно будет скачать REST API CA [![image.png](https://kb.kuma-community.ru/uploads/images/gallery/2024-07/scaled-1680-/9lZimage.png)](https://kb.kuma-community.ru/uploads/images/gallery/2024-07/9lZimage.png)
5. Этот сертификат нужно перенести на сервер, где будет выполнятся скрипт
6. Выполнить команду: ```
    ./maxpatrol-tool --kuma-rest <адрес и порт сервера KUMA REST API> --token <путь и имя файла с API-токеном> --tenant <название тенанта, куда будут помещены активы> <путь и имя файла с отчетом MaxPatrol> --cert <путь к файлу сертификата Ядра KUMA>
    ```
    
    Пример:
    
    ```
    ./maxpatrol-tool --kuma-rest example.kuma.com:7223 --token token.txt --tenant Main mp.xml --cert core-external-ca.cert
    ```
7. Для автоматизации добавления активов из папки по отчетам - можно воспользоваться **[скриптом](https://github.com/KUMA-Community/kuma_vuln_report_auto).**

# Импорт данных об активах из MaxPatrol VM

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

<p class="callout warning">Данная статья является дополнением к основной статье официальной документации [https://support.kaspersky.com/help/KUMA/3.2/ru-RU/265427.htm](https://support.kaspersky.com/help/KUMA/3.2/ru-RU/265427.htm) </p>

<p class="callout info">Протестирована работоспособность c MaxPatrol VM 2.1 и 2.9  
</p>

### Подготовительные действия в MP VM

Созданной учетной записи в MaxPatrol VM присвойте роль "Оператор".

### Создание конфигурационного файла

В конфигурационном файле **kuma-ptvm-config.yaml**:

- в секции **MaxPatrol** для параметра **endpoint** укажите MP API endpoint URL без указания cхемы (https://) и порта (по умолчанию, MP VM использует порт 443 для API-запросов)
- в секции **MaxPatrol** для параметра **password** укажите пароль, при этом учитывайте, что если пароль содержит спецсимволы (":", "-", "$", "\*" и др.), в таком случае пароль необходимо "обернуть" в одинарные или двойные кавычки
- в секции **tenants** для параметра **fqdn** укажите регулярное выражение ".\*", если не требуется искать активы, fqdn которых соответствует заданному регулярному выражению
- в секции **tenants** можно не указывать значения подсетей для параметра **networks**, если необходимо импортировать все активы, доступные в MP VM

### Поиск импортированных активов

Для поиска импортированных активов MP VM перейдите в **Активы** -&gt; Выберите **Поиск с условиями** и задайте условие согласно скриншоту ниже.

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

Нажмите **Поиск**.

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

<p class="callout info">Если актив уже ранее был импортирован из KSC и аналогичный актив импортируется из MP VM, в таком случае карточка актива дополнится информацией об уязвимостях, обнаруженных MP VM.</p>

<p class="callout info">Если актив изначально был импортирован из MP VM и далее аналогичный актив (с аналогичным IP и FQDN) будет импортирован из KSC, в таком случае актив "переподчинится" на управляемый из KSC.</p>

Для поиска активов, которые ранее уже были импортированы из KSC и информация в карточке таких активов была дополнена данными MP VM, выберите **Поиск с условиями** и задайте условия согласно скриншоту ниже.

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

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

Нажмите **Поиск**.

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

<span style="color: rgb(0, 0, 0);">Карточка актива с информацией об уязвимостях, полученной из KSC и из MP VM выглядит согласно скриншоту ниже.</span>

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

# Автоматическое добавление активов

### <span data-slate-node="text"><span data-slate-leaf="true"><span data-slate-string="true">Описание</span></span></span>

<span data-slate-node="text"><span data-slate-leaf="true"><span data-slate-string="true">Данный скрипт и набор ресурсов позволяют автоматически на основании информации из событий (ip-адреса, доменные имена) создавать активы в KUMA</span></span></span>

<p class="callout warning"><span data-slate-node="text"><span data-slate-leaf="true"><span data-slate-string="true">Данный скрипт рекомендуется использовать только в тестовой или демонстрационной инсталляции</span></span></span></p>

---

### <span data-slate-node="text"><span data-slate-leaf="true"><span data-slate-string="true">Требования</span></span></span>

<span data-slate-node="text"><span data-slate-leaf="true"><span data-slate-string="true">python 3.6+</span></span></span>

- <span data-slate-node="text"><span data-slate-leaf="true"><span data-slate-string="true">urllib</span></span></span>
- <span data-slate-node="text"><span data-slate-leaf="true"><span data-slate-string="true">argparse</span></span></span>
- <span data-slate-node="text"><span data-slate-leaf="true"><span data-slate-string="true">json</span></span></span>
- <span data-slate-node="text"><span data-slate-leaf="true"><span data-slate-string="true">requests</span></span></span>
- <span data-slate-node="text"><span data-slate-leaf="true"><span data-slate-string="true">os</span></span></span>

<span data-slate-node="text"><span data-slate-leaf="true"><span data-slate-string="true">KUMA 3.0.2</span></span></span>

---

### <span data-slate-node="text"><span data-slate-leaf="true"><span data-slate-string="true">Подготовка скрипта</span></span></span>

<span data-slate-node="text"><span data-slate-leaf="true"><span data-slate-string="true">1. Поместите файлы </span></span></span><span data-slate-node="text"><span data-slate-leaf="true">`<span data-slate-string="true">asset-import.py</span>`</span></span><span data-slate-node="text"><span data-slate-leaf="true"><span data-slate-string="true">, </span></span></span><span data-slate-node="text"><span data-slate-leaf="true">`<span data-slate-string="true">kumaPublicApiV1.py</span>`</span></span><span data-slate-node="text"><span data-slate-leaf="true"><span data-slate-string="true">, </span></span></span><span data-slate-node="text"><span data-slate-leaf="true">`<span data-slate-string="true">params.json</span>`</span></span><span data-slate-node="text"><span data-slate-leaf="true"><span data-slate-string="true"> на сервер коррелятора в папку scripts: /opt/kaspersky/kuma/correlator/</span></span></span><span data-slate-node="text"><span data-slate-leaf="true">`<span data-slate-string="true">id</span>`</span></span><span data-slate-node="text"><span data-slate-leaf="true"><span data-slate-string="true">/scripts</span></span></span>

<span data-slate-node="text"><span data-slate-leaf="true">`<span data-slate-string="true">id</span>`</span></span><span data-slate-node="text"><span data-slate-leaf="true"><span data-slate-string="true"> коррелятора можно получить из веб-интерфейса KUMA: Ресурсы -&gt; Активные сервисы -&gt; Выбрать галочкой коррелятор и в верхнем меню </span></span></span><span data-slate-node="text"><span data-slate-leaf="true">`<span data-slate-string="true">Копировать идентификатор сервиса</span>`</span></span><span data-slate-node="text"><span data-slate-leaf="true"><span data-slate-string="true">. Идентификатор будет скопирован в буфер обмена.</span></span></span>

<span data-slate-node="text"><span data-slate-leaf="true"><span data-slate-string="true">2. Внесите изменения в файл </span></span></span><span data-slate-node="text"><span data-slate-leaf="true">`<span data-slate-string="true">params.json</span>`</span></span><span data-slate-node="text"><span data-slate-leaf="true"><span data-slate-string="true">:</span></span></span>

- <span data-slate-node="text"><span data-slate-leaf="true"><span data-slate-string="true">kumaAddress - укажите ip-адрес сервера ядра KUMA</span></span></span>
- <span data-slate-node="text"><span data-slate-leaf="true"><span data-slate-string="true">kumaAPIPort - укажите API-порт ядра KUMA (значение по умолчанию </span></span></span><span data-slate-node="text"><span data-slate-leaf="true">`<span data-slate-string="true">7223</span>`</span></span><span data-slate-node="text"><span data-slate-leaf="true"><span data-slate-string="true">, если сомневаетесь - оставьте без изменений)</span></span></span>
- <span data-slate-node="text"><span data-slate-leaf="true"><span data-slate-string="true">kumaToken - токен для работы с API с правами </span></span></span><span data-slate-node="text"><span data-slate-leaf="true">`<span data-slate-string="true">POST /assets/import</span>`</span></span>

<span data-slate-node="text"><span data-slate-leaf="true"><span data-slate-string="true">3. Измените владельца файлов на kuma:</span></span></span>

```
chown kuma:kuma asset-import.py kumaPublicApiV1.py params.json
```

<span data-slate-node="text"><span data-slate-leaf="true"><span data-slate-string="true">4. Разрешите запуск файла </span></span></span><span data-slate-node="text"><span data-slate-leaf="true">`<span data-slate-string="true">asset-import.py</span>`</span></span><span data-slate-node="text"><span data-slate-leaf="true"><span data-slate-string="true">:</span></span></span>

```
chmod +x asset-import.py
```

---

### <span data-slate-node="text"><span data-slate-leaf="true"><span data-slate-string="true">Подготовка KUMA</span></span></span>

1. <span data-slate-node="text"><span data-slate-leaf="true"><span data-slate-string="true">Импортируйте все ресурсы из файла </span></span></span><span data-slate-node="text"><span data-slate-leaf="true">`<span data-slate-string="true">auto_asset_add</span>`</span></span><span data-slate-node="text"><span data-slate-leaf="true"><span data-slate-string="true"> (Пароль импорта: Qwerty123!)</span></span></span>
2. <span data-slate-node="text"><span data-slate-leaf="true"><span data-slate-string="true">Если нужно, внесите изменения в фильтры </span></span></span><span data-slate-node="text"><span data-slate-leaf="true">`<span data-slate-string="true">org address filter</span>`</span></span><span data-slate-node="text"><span data-slate-leaf="true"><span data-slate-string="true"> и </span></span></span><span data-slate-node="text"><span data-slate-leaf="true">`<span data-slate-string="true">org hostname filter</span>`</span></span><span data-slate-node="text"><span data-slate-leaf="true"><span data-slate-string="true">, указав домены и подсети вашей организации, по ним отбираются активы из событий для импорта.</span></span></span>
3. <span data-slate-node="text"><span data-slate-leaf="true"><span data-slate-string="true">Привяжите все правила корреляции </span></span></span><span data-slate-node="text"><span data-slate-leaf="true">`<span data-slate-string="true">Auto import asset info (src/dst/dvc)</span>`</span></span><span data-slate-node="text"><span data-slate-leaf="true"><span data-slate-string="true"> к коррелятору</span></span></span>
4. <span data-slate-node="text"><span data-slate-leaf="true"><span data-slate-string="true">Привяжите правило реагирования </span></span></span><span data-slate-node="text"><span data-slate-leaf="true">`<span data-slate-string="true">Auto asset import</span>`</span></span>
5. <span data-slate-node="text"><span data-slate-leaf="true"><span data-slate-string="true">Обновите параметры сервиса коррелятора</span></span></span>

---

### <span data-slate-node="text"><span data-slate-leaf="true"><span data-slate-string="true">Результат</span></span></span>

<span data-slate-node="text"><span data-slate-leaf="true"><span data-slate-string="true">В результате проделанных манипуляций в KUMA будут создаваться активы на основании информации, получаемой из событий.</span></span></span>

---

### <span data-slate-node="text"><span data-slate-leaf="true"><span data-slate-string="true">Файлы</span></span></span>

<span data-slate-node="text"><span data-slate-leaf="true"><span data-slate-string="true">Все ресурсы доступны по ссылке: [https://box.kaspersky.com/d/1eb25f174a3e44e2a1be/](https://box.kaspersky.com/d/1eb25f174a3e44e2a1be/)</span></span></span>