Информация, приведённая на данной странице, является разработкой команды pre-sales и/или community KUMA и **НЕ** является официальной рекомендацией вендора.
# Интеграция с Kaspersky MDR ## Описание интеграции Интеграция с Kaspersky Managed Detection and Response позволяет автоматически импортировать инциденты из консоли MDR в KUMA. Скрипт периодически опрашивает API MDR, получает новые инциденты и создаёт соответствующие инциденты в KUMA через API. --- ## Предварительные требования ### 1. Сетевой доступ На пограничном межсетевом экране создайте правило, разрешающее доступ к **mdr.kaspersky.com** по порту **TCP/443**. ### 2. Настройка пользователя и токена в KUMA В KUMA добавьте пользователя с ролью **Младший аналитик**, сгенерируйте токен для взаимодействия по API и разрешите доступ к следующим методам API: - `POST /events` - `POST /incidents/create` - `POST /incidents/comment` - `POST /incidents/close` ### 3. Генерация токена в консоли MDR 1. Перейдите в **Параметры → API**. 2. Нажмите **Добавить** и укажите **Имя соединения**.Это имя будет отображаться как имя пользователя при создании инцидентов, комментариев и вложений, поскольку токен доступа не привязан к конкретному пользователю.
4. В поле **Роль пользователя** выберите роль **Администратор MDR**. 5. В поле **Тенант** выберите тенант, инциденты которого необходимо импортировать в KUMA.Если для инцидентов, создаваемых в консоли MDR, в поле Тенант отсутствует значение — укажите в поле Тенант значение «Корневой тенант», иначе скрипт не обнаружит эти инциденты.
6. Нажмите **Создать**. В результате вы получите: - **JWT Token** (он же `refresh_token`) — это первичный токен со сроком действия 24 часа. Данный токен требуется активировать, чтобы получить новую пару `refresh_token` / `access_token`. - **ClientID** — идентификатор клиента, который необходимо указывать при каждом запросе к API MDR. Сохраните оба значения — они потребуются на этапе настройки. [](https://kb.kuma-community.ru/uploads/images/gallery/2026-03/image-1774360741536.png)
tenant_id можно получить из события аудита KUMA.
Закомментируйте всю секцию thehive
-
Для тестирования укажите время, незадолго до появления последнего инцидента в MDR.
### Шаг 5. Обновление сертификата Замените файл сертификата по умолчанию на актуальный, подготовленный в разделе **Предварительные требования**: ```bash cp /path/to/mdr.pem /opt/mdr_integration/conf/mdr.pem ``` ### Шаг 6. Редактирование скрипта main.py Закомментируйте следующие строки в скрипте main.py: ```bash #from src.integration_thehive import TheHive ``` ```bash #the_hive = TheHive(config) ``` ```bash #process_the_hive = multiprocessing.Process(target = the_hive.run, args=(logging_queue, process_logging_configurer)) ``` ```bash #process_the_hive.start() ``` ### Шаг 7. Проверка работоспособности Перейдите в папку со скриптом и запустите его: ```bash cd /opt/mdr_integration python3 ./main.py ``` Если при запуске скрипта в консоли отсутствую ошибки (кроме предупреждений о невалидном сертификате), значит интеграция работает корректно. Лог работы скрипта записывается в: ``` /opt/mdr_integration/log/app.log ``` Убедитесь, что инциденты из консоли MDR, созданные начиная с момента, указанного в `.last_check`, появились в KUMA. [](https://kb.kuma-community.ru/uploads/images/gallery/2026-03/image-1774367517939.png) [](https://kb.kuma-community.ru/uploads/images/gallery/2026-03/image-1774367489591.png) После проверки остановите скрипт (`Ctrl+C`). ### Шаг 7. Запуск в фоновом режиме Запустите скрипт в фоне: ```bash nohup python3 /opt/mdr_integration/main.py & ``` В качестве альтернативы Вы можете запустить скрипт для интеграции с MDR, как [сервис](https://github.com/KUMA-Community/MDR-integrations#run-util-as-a-service). В таком случае шаг 8 можно пропустить. ### Шаг 8. Автозапуск после перезагрузки Настройте автоматический запуск скрипта через cron: ```bash sudo crontab -e ``` Добавьте строку: ``` @reboot sleep 300 && python3 /opt/mdr_integration/main.py & ```Задержка sleep 300 (5 минут) необходима, чтобы сервис kuma-core успел запуститься до начала работы скрипта.