Информация, приведенная на данной странице, является разработкой команды pre-sales и/или community KUMA и **НЕ** является официальной рекомендацией вендора.
Официальная документация по данному разделу приведена в онлайн-справке на продукт: [https://support.kaspersky.com/KUMA/4.0/ru-RU/217923.htm](https://support.kaspersky.com/KUMA/4.0/ru-RU/217923.htm)
Видео «Работа с событиями»: [https://rutube.ru/video/c3012fb60209d69c7adedfefaaf93535/?playlist=540937](https://rutube.ru/video/c3012fb60209d69c7adedfefaaf93535/?playlist=540937)
При наличии интеграции KUMA с сервером Kaspersky Security Center появляется возможность импортировать информацию об активах, защищаемых данной программой, перемещать активы между группами администрирования, закрывать уязвимости (при наличии лицензии от Kaspersky Endpoint Security для бизнеса Расширенный и выше) и выполнять действия по реагированию на активах c установленным Kaspersky Endpoint Security из веб-интерфейса KUMA.Предварительно убедитесь, что на требуемом сервере Kaspersky Security Center разрешено входящее соединение для сервера с KUMA.
Настройка интеграции KUMA с Kaspersky Security Center включает следующие этапы: - Создание в Консоли администрирования Kaspersky Security Center учетной записи пользователя. - Создание секрета в KUMA с типом credentials для соединения с Kaspersky Security Center. - Создание подключения к серверу Kaspersky Security Center. ### Создание учетной записи пользователя #### Kaspersky Security Center Web Console Чтобы создать учетную запись пользователя: - Перейдите в раздел **Пользователи и роли** → **Пользователи и группы** и выберите вкладку **Пользователи**. - Нажмите на кнопку **Добавить**. - В появившемся окне **Добавить пользователя** укажите параметры нового пользователя: - **Имя** - **Пароль** [](https://kb.kuma-community.ru/uploads/images/gallery/2026-07/image260.png) - Нажмите **Сохранить** для завершения создания учетной записи пользователя. Учетная запись пользователей добавлена в список пользователей. Далее создайте роль пользователя с набором прав и разрешений в KSC: - Перейдите в раздел **Пользователи и роли** → **Роли.** - Нажмите на кнопку **Добавить**. - В появившемся окне **Имя новой роли** укажите название новой роли. [](https://kb.kuma-community.ru/uploads/images/gallery/2026-07/image261.png) - Нажмите **ОК.** - В появившемся окне параметров роли перейдите во вкладку **Права доступа** и предоставьте права согласно скриншотам ниже (в данном примере права предоставляются к приложению Kaspersky Endpoint Security для Windows 12.8.0) [](https://kb.kuma-community.ru/uploads/images/gallery/2026-07/image262.png) [](https://kb.kuma-community.ru/uploads/images/gallery/2026-07/image263.png) - Нажмите **Сохранить**. Назначьте созданную роль ранее созданной учетной записи пользователя: - Перейдите в раздел **Пользователи и роли** → **Пользователи и группы** и выберите вкладку **Пользователи**. - Нажмите на кнопку [](https://kb.kuma-community.ru/uploads/images/gallery/2026-07/image264.png) и введите имя ранее созданной учетной записи пользователя. - Выберите созданную учетную запись пользователя и нажмите **Назначить роль**. [](https://kb.kuma-community.ru/uploads/images/gallery/2026-07/image265.png) - В появившемся окне **Назначение ролей** нажмите справа на **Фильтр** и укажите название ранее созданной роли. - Выберите созданную роль и нажмите **Далее**. [](https://kb.kuma-community.ru/uploads/images/gallery/2026-07/HVaimage266.png) - В следующем окне укажите область применения роли. Выберите **«Сервер администрирования»**. [](https://kb.kuma-community.ru/uploads/images/gallery/2026-07/image267.png) - Нажмите **Готово**. - Повторите процедуру и выберите в качестве области применения роли также **Управляемые устройства**. [](https://kb.kuma-community.ru/uploads/images/gallery/2026-07/image268.png)Если в KSC используется MFA необходимо настроить исключение для учетной записи KUMA согласно этой инструкции: [https://support.kaspersky.com/help/KSC/15.1/ru-RU/211462.htm](https://support.kaspersky.com/help/KSC/15.1/ru-RU/211462.htm)
#### Консоль администрирования Kaspersky Security Center - В дереве консоли Kaspersky Security Center выберите узел с именем Сервера администрирования. - В рабочей области выбранного Сервера администрирования перейдите нажмите **Свойства Сервера**. [](https://kb.kuma-community.ru/uploads/images/gallery/2026-07/image269.png) - Перейдите в раздел **Безопасность**. - Создайте учетную запись внутреннего пользователя, нажав **Внутренний пользователь** и далее **Добавить пользователя**. [](https://kb.kuma-community.ru/uploads/images/gallery/2026-07/image270.png) - В появившемся окне **Новый пользователь** укажите параметры нового пользователя: - **Имя** - **Пароль** [](https://kb.kuma-community.ru/uploads/images/gallery/2026-07/image271.png) - Нажмите **ОК** для завершения создания учетной записи пользователя. Учетная запись пользователей добавлена в список пользователей. Далее назначьте соответствующие права новой учетной записи пользователя в KSC: - Перейдите в раздел **Безопасность.** - Нажмите **Внутренний пользователь** и в появившемся окне **Выбор пользователя** в поле **Поиск** укажите созданную учетную запись пользователя. - Выберите созданную учетную запись пользователя и нажмите **ОК**. [](https://kb.kuma-community.ru/uploads/images/gallery/2026-07/image272.png) - Выберите учетную запись в списке и в секции **Разрешения для <имя учетной записи>** на вкладке **Права** назначьте права согласно скриншоту ниже (в данном примере права предоставляются к приложению Kaspersky Endpoint Security для Windows 12.8.0). [](https://kb.kuma-community.ru/uploads/images/gallery/2026-07/image273.png) [](https://kb.kuma-community.ru/uploads/images/gallery/2026-07/image274.png) - Нажмите **Применить** и далее **ОК**. - Убедитесь, что в Группах устройств KSC, активы из которых необходимо импортировать включен параметр **Наследовать параметры Сервера администрирования или родительской группы,** или добавлена ранее созданная учетная запись с правами, как на скриншоте выше. [](https://kb.kuma-community.ru/uploads/images/gallery/2026-07/image275.png)Если в KSC используется MFA необходимо настроить исключение для учетной записи KUMA согласно этой инструкции: [https://support.kaspersky.com/help/KSC/15.1/ru-RU/211812.htm](https://support.kaspersky.com/help/KSC/15.1/ru-RU/211812.htm)
--- ### Создание секрета в KUMA После создания учетной записи в KSC требуется добавить секрет в веб-интерфейсе KUMA. Этот ресурс будет хранить учетные данные для подключения к KSC. Чтобы создать секрет в KUMA выполните следующие действия: - Откройте раздел веб-интерфейса KUMA **Ресурсы** → **Секреты**. Отобразится список доступных секретов. - Нажмите на кнопку **Добавить**, чтобы создать новый секрет. - В появившемся окне **Создание секрета** введите данные секрета: - В поле **Название** укажите имя для добавляемого секрета. - В раскрывающемся списке **Тенант** выберите тенант, которому будет принадлежать создаваемый ресурс. - В раскрывающемся списке **Тип** выберите **credentials**. - В поле **Пользователь** укажите имя созданной учетной записи в KSC (для доменной учетной записи используйте формат: **пользователь@домен**). - В поле **Пароль** укажите пароль учетной записи - Нажмите **Создать**. [](https://kb.kuma-community.ru/uploads/images/gallery/2026-07/image276.png)Из соображений безопасности после сохранения секрета строки, указанные в полях **Пользователь** и **Пароль**, скрываются
--- ### Создание подключения к Kaspersky Security Center Чтобы создать подключение к Kaspersky Security Center: - Откройте веб-интерфейс KUMA и выберите раздел **Параметры → Интеграции → Kaspersky Security Center**. - В появившемся окне **Интеграция с Kaspersky Security Center по тенантам** нажмите **Добавить параметры для нового тенанта.** - В появившемся окне **Kaspersky Security Center**: - Выберите тенант, для которого вы хотите создать подключение к Kaspersky Security Center, по умолчанию, **Main**. - В секции **KSC активы, информация об оборудовании** укажите **Интервал обновления данных** (час.), по умолчанию 1 час. - В секции **Атрибуты активов KSC (уязвимости, программное обеспечение, владельцы)** укажите **Интервал обновления данных** (час.), по умолчанию 12 часов. - В секции **Подключения** нажмите **Создать** и в появившемся окне **Создать подключение** укажите: - **Название** – имя подключения. - **URL** – URL сервера Kaspersky Security Center в формате hostname:port или IPv4:port. - В раскрывающемся списке **Секрет** выберите ранее созданный секрет с учетными данными Kaspersky Security Center. - Нажмите **Создать**. [](https://kb.kuma-community.ru/uploads/images/gallery/2026-07/Fvwimage.png) - - После возвращения в окно **Kaspersky Security Center **нажмите **Добавить.** [](https://kb.kuma-community.ru/uploads/images/gallery/2026-07/ZsTimage.png) Подключение к серверу **Kaspersky Security Center **создано. Его можно использовать для импорта информации об активах из Kaspersky Security Center в KUMA и для создания задач, связанных с активами, в Kaspersky Security Center прямо из веб-интерфейса KUMA. --- ### Импорт активов из Kaspersky Security Center **Активы в KUMA —** это рабочие станции, серверы и сетевое оборудование вашей организации. Вы можете импортировать активы в KUMA для получения дополнительной информации об устройствах при анализе событий и расследовании инцидентов: IP-адрес, владельца, ОС, данные о ПО и «железе», а также сведения об уязвимостях. Активы в KUMA можно добавить следующими способами: - Импортировать активы: - Из отчетов сканеров уязвимостей: - MP8 Scanner; - MaxPatrol VM; - RedCheck; - Nessus; - OWASP ZAP. - По расписанию: из Kaspersky Security Center и KICS for Networks. - Создать активы вручную через веб-интерфейс или с помощью API. Пользователь KUMA может: - Просматривать информацию об активах. - Искать активы. - Добавлять активы, редактировать их и удалять. - Экспортировать данные об активах в CSV-файл. Ниже рассмотрен процесс импорта активов из Kaspersky Security Center. Чтобы выполнить импорт информации об активах из Kaspersky Security Center: - Откройте веб-интерфейс KUMA и перейдите в раздел **Параметры → Интеграции → Kaspersky Security Center**. - Выберите тенант, в котором ранее было создано подключение к Kaspersky Security Center. - В окне **Kaspersky Security Center нажмите на созданное подключение к KSC и в появившемся окне **Изменить подключение** нажмите **Загрузить** для загрузки иерархии групп активов KSC. - Отобразится иерархия групп активов KSC. Выберите группы, устройства из которых необходимо импортировать. - Дополнительно активируйте параметр **Импортировать активы из новых групп.** Это позволит при добавлении новых групп в KSC автоматически импортировать из них активы. - Нажмите на кнопку **Импортировать активы KSC**. Будет создана задача по импорту активов. - Нажмите на кнопку **Импортировать атрибуты активов KSC**. Будет создана задача по импорту атрибутов активов. - Нажмите **Сохранить**. [](https://kb.kuma-community.ru/uploads/images/gallery/2026-07/DBOimage.png) - В окне **Kaspersky Security Center** также нажмите **Сохранить**. - Перейдите в раздел **Диспетчер задач**. - Нажмите на задачу **Импорт активов KSC** со статусом **Завершено**. В окне справа **Информация о задаче** будет указано количество активов, информация о которых была импортирована в KUMA. [](https://kb.kuma-community.ru/uploads/images/gallery/2026-07/jVrimage.png) [](https://kb.kuma-community.ru/uploads/images/gallery/2026-07/xJVimage.png) - Нажмите на задачу **Импорт атрибутов активов KSC** со статусом **Завершено**. В окне справа **Информация о задаче** будет указано количество активов, для которых была импортирована информация об атрибутах. [](https://kb.kuma-community.ru/uploads/images/gallery/2026-07/HgQimage.png)Информация об активах и их атрибутах успешно импортирована. Чтобы просмотреть информацию об импортированных активах: - Перейдите в раздел **Активы** → выберите один из активов в списке. - В окне справа отобразится информация об активе. [](https://kb.kuma-community.ru/uploads/images/gallery/2026-07/1CGimage.png) [](https://kb.kuma-community.ru/uploads/images/gallery/2026-07/KEOimage.png) --- ### Настройка обогащения событий информацией об активахНачиная с версии 4.0 KUMA обогащение активами настраивается вручную. Возможность ручной настройки правила обогащения типа "Обогащение активами" позволяет самостоятельно выбрать поля, в которых содержится информация об активе для сопоставления с базой импортированных активов, помимо стандартных SourceAddress/DestinationAddress, SourceHostName/DestinationHostName и других.
#### Создание правила обогащения в KUMA Чтобы настроить обогащение событий информацией об активах создайте правило обогащения: - В веб-интерфейсе KUMA перейдите в раздел **Ресурсы** → **Правила обогащения**. - Нажмите на кнопку **Создать**. - В появившемся окне **Создание правила обогащения**: - В поле **Название** введите уникальное имя правила. - В раскрывающемся списке **Тенант** выберите, к какому тенанту относится этот ресурс. - В раскрывающемся списке **Тип источника данных** выберите **обогащение активами**. - Опционально добавьте **Описание**. - В секции **Сопоставление** нажмите **Применить сопоставление по умолчанию.** - Нажмите **Создать**. [](https://kb.kuma-community.ru/uploads/images/gallery/2026-07/bM7image.png) Далее созданное правило обогащения необходимо применить в Коллекторах, в событиях которых есть поля, указанные в секции **Сопоставление** (см. выше). Примеры источников для которых можно настроить данный тип обогащения: Windows (WEC/WMI, сбор событий Windows с помощью KES), Linux, KSC/KES, NGFW, Netflow.Данный перечень источников не является исчерпывающим. Вы также можете настраивать собственное сопоставление полей KUMA и полей для записи данных.
#### Применение правила обогащения в коллекторе На примере коллектора для приема событий Windows, пересылаемых KES. Чтобы добавить созданное правило обогащения в Коллекторе: - Перейдите в раздел **Ресурсы** → **Активные сервисы.** - Выберите **Коллектор**, который используется для приема и обработки событий Windows, пересылаемых KES. [](https://kb.kuma-community.ru/uploads/images/gallery/2026-07/ouqimage.png) - В окне **Редактирование коллектора** перейдите на шаг **Обогащение событий** и нажмите **Добавить обогащение**. - В поле **Правило обогащения** выберите ранее созданное правило обогащения. [](https://kb.kuma-community.ru/uploads/images/gallery/2026-07/8pWimage.png) - Перейдите на шаг **Проверка параметров** и нажмите **Сохранить и обновить параметры сервисов**. - Нажмите **Сохранить**. #### Проверка обогащения событий информацией об активах Чтобы проверить, что обогащение событий информацией об активах успешно выполняется: - Перейдите в раздел **Ресурсы** → **Активные сервисы.** - Выберите **Коллектор**, который используется для приема и обработки событий Windows, пересылаемых KES. - Нажмите ПКМ на Коллектор и выберите **Перейти к событиям.** [](https://kb.kuma-community.ru/uploads/images/gallery/2026-07/mcWimage.png) - В разделе **События** дополните условие поискового запроса и приведите его к следующем виду для поиска событий, обогащенных информацией об активах: ```sql SELECT * FROM `events` WHERE (DeviceAssetID != '' OR SourceAssetID !='' OR DestinationAssetID !='') AND ServiceID = 'Информация, приведенная на данной странице, является разработкой команды pre-sales и/или community KUMA и **НЕ** является официальной рекомендацией вендора.
Данная инструкция предназначена строго для версии KATA/NDR **7.0**.
Данная инструкция предназначена для импорта информации об активах, полученной KATA/NDR в KUMA.
### Настройка KATA/NDR Для настройки пересылки событий из KATA/NDR в SIEM KUMA необходимо выполнить следующие действия: 1\. Перейти в веб-консоль KATA/NDR из-под учетной записи Администратора 2\. Перейти в раздел **Параметры** – **Коннекторы** и нажать на кнопку **Добавить коннектор**  3\. В открывшемся окне настроить параметры интеграции с KUMA: **Тип коннектора**: KUMA; **Имя коннектора**: произвольное название, например, *KUMA;* **Пароль доступа к сертификату коннектора**: задайте пароль для файла свертки; **Пароль (повторно)**: повторите введенный ранее пароль; **Адрес сервера**: Адрес CN KATA/NDR; **Узел размещения коннектора**: Адрес сервера в кластере KATA/NDR для размещения коллектора (в случае Single node будет совпадать с предыдущем пунктом); **Пользователь программы**: выбрать нужного из выпадающего списка.  3\. По завершении заполнения необходимых полей нажать кнопку **Сохранить**. В результате будет загружен архив, а также в интерфейсе KATA/NDR созданный коннектор перейдет в состояние **Работает**.  --- ### Настройка KUMA Перейдите в веб-интерфейс KUMA на вкладку Параметры - KICS/KATA и задайте параметры интеграции: **Выключено**: галочка должна быть снята для работы интеграции; **Тенант**: выберите необходимый тенант из выпадающего списка*;* **Включить реагирование**: требуется для изменения статуса устройств; **Файл свертки:** загрузите архив, полученный при настройке на стороне KATA/NDR; **Пароль файла свертки**: укажите пароль от архива, заданный при настройке на стороне KATA/NDR;  По окончании настройки нажмите кнопку **Сохранить**. --- # 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 [](https://kb.kuma-community.ru/uploads/images/gallery/2023-12/FBZimage.png) Сохраните настройки, **сгенерируйте токен** и отдельно сохраните его, например, в каком-либо текстовом редакторе. Нажмите **Сохранить**. Добавьте **дополнительнео поле** с названием «Description» в разделе **Параметры - Активы - Пользовательские атрибуты**. [](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 актив будет выглядит следующим образом: [](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": "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 актив будет выглядит следующим образом: [](https://kb.kuma-community.ru/uploads/images/gallery/2023-12/lfnimage.png) # Импорт информации об активах RedCheck
Информация, приведенная на данной странице, является разработкой команды pre-sales и/или community KUMA и **НЕ** является официальной рекомендацией вендора.
### Импорт информации об активах RedCheck В KUMA можно импортировать сведения об активах из отчетов о результатах сканирования сетевых устройств с помощью RedCheck, системы контроля защищенности и соответствия стандартам. Импорт происходит через API с помощью утилиты `redcheck-tool.py`. Импортированные активы отображаются в веб-интерфейсе KUMA в разделе Активы. При необходимости вы можете редактировать параметры активов.Импорт поддерживается из RedCheck 2.6.8 и выше
Поддерживается импорт информации о хостах только под управлением ОС Windows
Для работы утилиты требуется python верси 3.6 или выше, а также библиотеки: csv, re, json, requests, argparse, sys
Чтобы импортировать данные об активах из отчета RedCheck: 1\. Сформируйте в RedCheck отчет сканирования сетевых активов в формате CSV и скопируйте файл отчета на сервер со скриптом. Подробнее о задачах на сканирование и форматах выходных файлов см. в документации RedCheck.Импорт доступен из "Простых" отчетов "**Уязвимости**" и "**Инвентаризация**" сгруппированных по хостам в формате CSV. Подробнее на сайте RedCheck: [https://docs.redcheck.ru/articles/#!redcheck-user-269/reports](https://docs.redcheck.ru/articles/#!redcheck-user-269/reports)
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| **Флаги и команды** | **Обязательный** | **Описание** |
| --kuma-rest <адрес и порт сервера ядра KUMA> | Да | По умолчанию для обращения по API используется порт 7223. При необходимости его можно изменить. |
| --token <токен> | Да | Значение в параметре должно содержать только токен. Учетной записи, для которой генерируется API-токен, должна быть присвоена роль Администратора или Аналитика. |
| --tenant <название тенанта> | Да | Название тенанта KUMA, в который будут импортированы активы из отчета RedCheck |
| --vuln-report <полный путь к файлу отчета "Уязвимости"> | Да | Файл должен содержать отчет "Уязвимости" в формате CSV |
| --inventory-report <полный путь к файлу отчета "Инвентаризация"> | Нет | Файл должен содержать отчет "Инвентаризация" в формате CSV |
| -v | Нет | Выведение расширенной информации об импорте активов |
| **Сообщение об ошибке** | **Описание** |
| Tenant %w not found | Имя тенанта не найдено |
| Tenant search error: Unexpected status Code: %d | При поиске тенанта был получен неожиданный код ответа HTTP |
| Asset search error: Unexpected status Code: %d | При поиске актива был получен неожиданный код ответа HTTP |
| \[%w import\]\[error\] Host: %w Skipped asset with FQDN localhost or IP 127.0.0.1 | При импорте информации инвентаризации/уязвимостей был пропущен хост с fqdn=localhost или ip=127.0.0.1 |
Информация, приведенная на данной странице, является разработкой команды pre-sales и/или community KUMA и **НЕ** является официальной рекомендацией вендора.
Ссылка на документацию [https://support.kaspersky.com/help/KUMA/3.2/ru-RU/265426.htm](https://support.kaspersky.com/help/KUMA/3.2/ru-RU/265426.htm)
#### Импорт Утилита для импорта находится в следующей директории **kuma-ansible-installer/roles/kuma/files/maxpatrol-tool** Для импорта необходимо выполнить следующие шаги: 1. Сформировать отчет **сканирования сетевых активов в формате XML file ** 2. Поместить отчет и скрипт в одной директории (можно выполнить на ядре KUMA) 3. Подготовить API права для утилиты: 1. В KUMA создать пользователя kuma-mp 2. Дать права на **GET /users/whoami** и **POST /assets/import** 3. Сгенерировать токен (его сохранить в файл на сервере, где будет выполнятся команда 4. Далее в веб-консоли KUMA нужно будет скачать REST API CA [](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Информация, приведенная на данной странице, является разработкой команды pre-sales и/или community KUMA и **НЕ** является официальной рекомендацией вендора.
Данная статья является дополнением к основной статье официальной документации [https://support.kaspersky.com/help/KUMA/3.2/ru-RU/265427.htm](https://support.kaspersky.com/help/KUMA/3.2/ru-RU/265427.htm)
Протестирована работоспособность c MaxPatrol VM 2.1 и 2.9
### Подготовительные действия в 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 перейдите в **Активы** -> Выберите **Поиск с условиями** и задайте условие согласно скриншоту ниже. [](https://kb.kuma-community.ru/uploads/images/gallery/2024-10/steimage.png) Нажмите **Поиск**. [](https://kb.kuma-community.ru/uploads/images/gallery/2024-10/Yfvimage.png)Если актив уже ранее был импортирован из KSC и аналогичный актив импортируется из MP VM, в таком случае карточка актива дополнится информацией об уязвимостях, обнаруженных MP VM.
Если актив изначально был импортирован из MP VM и далее аналогичный актив (с аналогичным IP и FQDN) будет импортирован из KSC, в таком случае актив "переподчинится" на управляемый из KSC.
Для поиска активов, которые ранее уже были импортированы из KSC и информация в карточке таких активов была дополнена данными MP VM, выберите **Поиск с условиями** и задайте условия согласно скриншоту ниже. [](https://kb.kuma-community.ru/uploads/images/gallery/2024-10/2XRimage.png) [](https://kb.kuma-community.ru/uploads/images/gallery/2024-10/Fnpimage.png) Нажмите **Поиск**. [](https://kb.kuma-community.ru/uploads/images/gallery/2024-10/QSHimage.png) Карточка актива с информацией об уязвимостях, полученной из KSC и из MP VM выглядит согласно скриншоту ниже. [](https://kb.kuma-community.ru/uploads/images/gallery/2024-10/0Hhimage.png) # Автоматическое добавление активов ### Описание Данный скрипт и набор ресурсов позволяют автоматически на основании информации из событий (ip-адреса, доменные имена) создавать активы в KUMAДанный скрипт рекомендуется использовать только в тестовой или демонстрационной инсталляции
--- ### Требования python 3.6+ - urllib - argparse - json - requests - os KUMA 3.0.2 --- ### Подготовка скрипта 1. Поместите файлы `asset-import.py`, `kumaPublicApiV1.py`, `params.json` на сервер коррелятора в папку scripts: /opt/kaspersky/kuma/correlator/`id`/scripts `id` коррелятора можно получить из веб-интерфейса KUMA: Ресурсы -> Активные сервисы -> Выбрать галочкой коррелятор и в верхнем меню `Копировать идентификатор сервиса`. Идентификатор будет скопирован в буфер обмена. 2. Внесите изменения в файл `params.json`: - kumaAddress - укажите ip-адрес сервера ядра KUMA - kumaAPIPort - укажите API-порт ядра KUMA (значение по умолчанию `7223`, если сомневаетесь - оставьте без изменений) - kumaToken - токен для работы с API с правами `POST /assets/import` 3. Измените владельца файлов на kuma: ``` chown kuma:kuma asset-import.py kumaPublicApiV1.py params.json ``` 4. Разрешите запуск файла `asset-import.py`: ``` chmod +x asset-import.py ``` --- ### Подготовка KUMA 1. Импортируйте все ресурсы из файла `auto_asset_add` (Пароль импорта: Qwerty123!) 2. Если нужно, внесите изменения в фильтры `org address filter` и `org hostname filter`, указав домены и подсети вашей организации, по ним отбираются активы из событий для импорта. 3. Привяжите все правила корреляции `Auto import asset info (src/dst/dvc)` к коррелятору 4. Привяжите правило реагирования `Auto asset import` 5. Обновите параметры сервиса коррелятора --- ### Результат В результате проделанных манипуляций в KUMA будут создаваться активы на основании информации, получаемой из событий. --- ### Файлы Все ресурсы доступны по ссылке: [https://box.kaspersky.com/d/1eb25f174a3e44e2a1be/](https://box.kaspersky.com/d/1eb25f174a3e44e2a1be/)