Импорт информации об активах из MaxPatrol

Вы можете импортировать в XDR сведения об активах из системы MaxPatrol VM. Импортированные активы отображаются в группе Активы. При необходимости вы можете редактировать параметры активов.

Импорт информации об активах из MaxPatrol VM

Дистрибутив OSMP включает утилиту kuma-ptvm, которая состоит из исполняемого файла и конфигурационного файла. Утилита поддерживает операционные системы Windows и Linux. Утилита позволяет подключаться к API MaxPatrol VM для получения данных об устройствах и их атрибутах, включая уязвимости, а также позволяет изменять данные активов и импортировать данные с использованием API Kaspersky Symphony XDR. Импорт данных поддерживается для MaxPatrol VM версий 1.1–2.7 включительно.

Настройка импорта информации об активе из MaxPatrol VM в Ядро KUMA включает следующие этапы:

1. Подготовка Kaspersky Symphony XDR и MaxPatrol VM.

   Вам нужно создать учетные записи пользователей и токен Kaspersky Symphony XDR для операций API.

2. Создание конфигурационного файла с параметрами экспорта и импорта данных.
3. Импорт данных активов в Ядро KUMA с использованием утилиты kuma-ptvm:
   1. Данные экспортируются из MaxPatrol VM и сохраняются в директории утилиты. Информация по каждому тенанту сохраняется в отдельный файл в формате JSON.

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

   2. Информация из файлов импортируется в Ядро KUMA.

При повторном импорте существующих активов, активы, которые уже существуют в Ядре KUMA, перезаписываются. Таким образом закрытые уязвимости будут удалены.

Известные ограничения:

• Если один и тот же IP-адрес указан для двух активов с разными FQDN, Ядро KUMA импортирует такие активы как два разных актива. Эти активы не объединяются.
• Если на активе установлено два приложения с одинаковыми данными в полях названия, версии и поставщика, Ядро KUMA импортирует эти данные как одно приложение, несмотря на разные пути установки приложения на активе.
• Если FQDN актива содержит пробел или подчеркивание (_), данные таких активов не импортируются в Ядро KUMA. В журнале событий будет указано, что активы были пропущены при импорте.
• Если во время импорта происходит ошибка, сведения об ошибке регистрируются и импорт останавливается.

Подготовительные действия:

1. Создайте отдельную учетную запись в Kaspersky Symphony XDR и в MaxPatrol VM с минимально необходимым набором разрешений для использования API запросов.
2. Создайте учетные записи пользователей, для которых вы позже сгенерируете токен API.

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

   • Главный администратор, Администратор тенанта, Аналитик 2-го уровня или Аналитик 1-го уровня.
   • Доступ к тенанту, в который будут импортированы активы.
   • В учетной записи пользователя, в разделе прав доступа к API, установлен флажок для POST /xdr/api/v2.1/kuma/assets/import.
3. Сгенерировать токен для доступа к XDR REST API.
4. Скопируйте утилиту kuma-ptvm на сервер с Ядром KUMA и сделайте файл утилиты исполняемым с помощью команды:

   chmod +x <путь до файла kuma-ptvm на сервере с Ядром KUMA>

Чтобы создать конфигурационный файл:

1. Перейдите в папку утилит KUMA:

   cd /opt/kaspersky/kuma/utils/

2. Скопируйте шаблон kuma-ptvm-config-template.yaml, чтобы создать конфигурационный файл с именем kuma-ptvm-config.yaml.

   cp kuma-ptvm-config-template.yaml kuma-ptvm-config.yaml

3. Измените параметры в конфигурационном файле kuma-ptvm-config.yaml.
4. Сохраните изменения в файле.

Конфигурационный файл будет создан.

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

1. Если вы хотите импортировать информацию об активе из MaxPatrol VM в Ядро KUMA без промежуточной проверки экспортированных данных, запустите утилиту kuma-ptvm со следующими параметрами:

   kuma-ptvm --config <path to the kuma-ptvm-config.yaml file> --download --upload

2. Если вы хотите проверить правильность данных, экспортированных из MaxPatrol VM, перед их импортом в Ядро KUMA:
   1. Запустите утилиту kuma-ptvm со следующими параметрами:

      kuma-ptvm --config <path to the kuma-ptvm-config.yaml file> --download

      Для каждого тенанта, указанного в конфигурационном файле, будет создан отдельный файл с именем в формате<tenant ID>.JSON. Также во время экспорта создается файл "tenants", содержащий список файлов JSON для загрузки в Ядро KUMA. Все файлы сохраняются в директории утилиты.

   2. Просмотрите экспортированные файлы активов и при необходимости внесите следующие изменения:
      • Назначьте активы соответствующим тенантам.
      • Вручную перенесите данные активов из файла тенанта "default" в файлы соответствующих тенантов.
      • В файле "tenants" измените список тенантов, активы которых вы хотите импортировать в Ядро KUMA.
   3. Импортируйте информацию об активе в Ядро KUMA:

      kuma-ptvm --config <path to the kuma-ptvm-config.yaml file> --upload

      Чтобы просмотреть информацию о доступных командах утилиты, выполните команду --help.

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

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

При запуске утилиты kuma-ptvm может вернуться ошибка tls: failed to verify certificate: x509: certificate is valid for localhost.

Чтобы решить проблему:

• Выпустите сертификат в соответствии с документацией MaxPatrol. Это рекомендованный способ решить эту ошибку.
• Выключите проверку сертификата.

  Чтобы выключить проверку сертификата, добавьте следующую строку в конфигурационный файл в разделе Параметры MaxPatrol:

  ignore_server_cert: true

В результате утилита запускается без ошибок.