Предварительная настройка

Чтобы выполнить предварительную настройку для интеграции с MDR:

1. Откройте доступ к Консоли MDR.

   Убедитесь, что на сервере, на котором будет настроена интеграция с KUMA, есть сетевой доступ к веб-адресу https://mdr.kaspersky.com по порту TCP/443.

2. В KUMA создайте пользователя с ролью Младший аналитик.

   Убедитесь, что у этого пользователя есть доступ к API и возможность выполнять следующие запросы:

   • POST /events
   • POST /incidents/create
   • POST /incidents/comment
   • POST /incidents/close
3. В Консоли MDR сгенерируйте API-токен, выполнив следующие действия:
   1. В окне Консоли MDR выберите пункт меню Параметры.
   2. Перейдите на вкладку API.
   3. В верхней части окна нажмите на кнопку Добавить.
   4. Укажите Имя соединения. Это имя будет отображаться как имя пользователя при создании инцидентов, комментариев и вложений, поскольку токен доступа не привязан к конкретному пользователю.

      Имя соединения может содержать латинские буквы, цифры и специальные символы.

   5. В раскрывающемся списке Роль пользователя выберите роль Администратор MDR.
   6. В раскрывающемся Тенант выберите тенант, инциденты которого необходимо импортировать в KUMA.

      При необходимости выберите одного или несколько тенантов.

      Если для создаваемых в Консоли MDR инцидентов в раскрывающемся списке Тенант отсутствует значение, укажите значение Корневой тенант, чтобы при соединении скрипт обнаружил эти инциденты.

   7. Нажмите на кнопку Создать.

      Решение отобразит значения следующих параметров:

      • Токен JWT (refresh token) – первичный токен, который используется для получения пары refresh token / access token.
      • ClientID (client id) – идентификатор клиента, который необходимо передавать при запросах к API MDR.

      Сохраните значения этих параметров, они потребуются на этапе инициализации интеграции.

4. Скачайте содержимое репозитория MDR-integrations в GitHub.

   Для получения этих данных ты также можете клонировать репозиторий напрямую на сервер KUMA, выполнив следующую команду:

   git clone https://github.com/klsecservices/MDR-integrations.git

5. Загрузите цепочку сертификатов для MDR в формате PEM, выполнив следующие действия:
   1. В браузере откройте ссылку https://mdr.kaspersky.com.
   2. Нажмите на значок замка в адресной строке рядом с веб-адресом сайта.
   3. Выберите пункт Безопасное подключение и нажмите Действительный сертификат.
   4. Перейдите на вкладку Подробнее.
   5. Для каждого элемента в иерархии сертификатов (начиная с нижнего *.mdr.kaspersky.com и заканчивая корневым DigiCert Global Root G2) нажмите на кнопку Экспорт.
   6. Добавьте сохраненные сертификаты в файл с расширением .PEM (mdr.pem) с помощью следующей команды:

      cat "DigiCert Global G2 TLS RSA SHA256 2020 CA1.crt" "DigiCert Global Root G2.crt" "_.mdr.kaspersky.crt" > mdr.pem

      Полученный файл mdr.pem потребуется на этапе инициализации интеграции.