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

19 октября 2026

ID 265427

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

Настройка импорта информации об активах из MaxPatrol VM в OSMP состоит из следующих шагов:

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

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

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

Если для двух активов с разными FQDN указан один IP-адрес, OSMP импортирует такие активы как два разных актива, активы не будут объединены.

Если у актива два ПО с одинаковыми данными в полях name, version, vendor, OSMP импортирует эти данные как одно ПО, несмотря на разные пути установки ПО в активе.

Если в конфигурационном файле kuma-ptvm-config.yaml вы укажете параметр strict_import со значением false, то из MaxPatrol будут импортированы данные по всем активам, в том числе без обязательных для OSMP полей и с недопустимыми для OSMP значениями полей. Если FQDN актива содержит пробел или "_", данные по таким активам не будут импортированы в OSMP, в журнале будет указано, что такие активы пропущены при импорте.

Если при импорте происходит ошибка, информация об ошибке регистрируется в журнале и выполнение импорта прекращается.

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

Создайте отдельную учетную запись пользователя в OSMP и в MaxPatrol VM с минимально необходимым набором прав на использование API-запросов.
Создайте учетные записи, для которых впоследствии сгенерируете API-токен.
Требования к учетным записям, для которых генерируется API-токен:
- Роль Главного администратора, Администратора тенанта, Аналитика второго уровня и Аналитика первого уровня.
- Доступ к тенанту, в который будут импортированы активы.
- В учетной записи пользователя в группе параметров Права доступа через API установлен флажок для POST /api/v3/assets/import.
Сгенерируйте токен для доступа к OSMP REST API.

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

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

Перейдите в директорию хоста, указанного в файле инвентаря KUMA в секции utils, выполнив следующую команду:
cd /opt/kaspersky/kuma/utils
Распакуйте архив kuma-ptvm.tar.gz, выполнив следующую команду:
tar -xvf kuma-ptvm.tar.gz
Создайте конфигурационный файл в зависимости от необходимого способа импорта активов:
- Чтобы импортировать все активы, скопируйте шаблон kuma-ptvm-config-template.yaml и создайте конфигурационный файл с именем kuma-ptvm-config.yaml:
  cp kuma-ptvm-config-template.yaml kuma-ptvm-config.yaml
- Чтобы импортировать только активы, соответствующие заданным параметрам фильтрации, скопируйте шаблон kuma-ptvm-vulnerable-assets-config-template.yaml и создайте конфигурационный файл с именем kuma-ptvm-vulnerable-assets-config.yaml:
  cp kuma-ptvm-vulnerable-assets-config-template.yaml kuma-ptvm-vulnerable-assets-config.yaml
В зависимости от необходимого способа импорта активов отредактируйте параметры конфигурационного файла kuma-ptvm-config.yaml или параметры конфигурационного файла kuma-ptvm-vulnerable-assets-config-template.yaml.
Сохраните изменения в файле.

Конфигурационный файл будет создан. Теперь вы можете переходить к шагу Импорт информации об активах.

Импорт данных об активах

Чтобы импортировать информацию об активах из MaxPatrol VM в OSMP, используйте утилиту kuma-ptvm с конфигурационным файлом, созданным на предыдущем этапе.

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

Если вы хотите импортировать информацию об активах из MaxPatrol VM в OSMP без промежуточной проверки экспортированных данных, запустите утилиту kuma-ptvm со следующими параметрами в зависимости от необходимого способа импорта активов:
- Для импорта всех активов:
  ./kuma-ptvm --config <path> --download --upload
  
  где:
  
  <path> — полный путь к конфигурационному файлу kuma-ptvm-config.yaml.
- Для импорта активов, отфильтрованных по параметрам, заданным в конфигурационном файле:
  kuma-ptvm vulnerable-assets-api --config <path> --download --upload
  
  где:
  
  <path> — полный путь к конфигурационному файлу kuma-ptvm-vulnerable-assets-config.yaml.
Если вы хотите проверить правильность экспортированных из MaxPatrol VM данных перед импортом в OSMP, выполните одну из команд в зависимости от необходимого способа импорта активов:
- Для импорта всех активов запустите утилиту kuma-ptvm со следующими параметрами:
  ./kuma-ptvm --config <path> --download
- Для импорта активов, отфильтрованных по параметрам, заданным в конфигурационном файле:
  kuma-ptvm vulnerable-assets-api --config <path> --download
где:

<path> — полный путь к соответствующему конфигурационному файлу: kuma-ptvm-config.yaml или kuma-ptvm-vulnerable-assets-config.yaml.

При необходимости вы можете использовать параметр --cvss-version <номер CVSS версии>, чтобы указать, для какой версии CVSS нужно загрузить значения уязвимостей активов. Доступные значения:
- 2 – загружаются только значения CVSS версии 2.
- 3 – загружаются только значения CVSS версии 3. Если уязвимость описана только по версии 2, поле CVSS будет пустым.
- latest – загружаются значения последней доступной версии CVSS (значение по умолчанию). Если уязвимость не имеет значения CVSS версии 3, используется значение версии 2.
Примеры:

./kuma-ptvm vulnerable-assets-api --config <path> --cvss-version 2 --download

./kuma-ptvm vulnerable-assets-api --config <path> --cvss-version 3 --download

./kuma-ptvm vulnerable-assets-api --config <path> --cvss-version latest --download

где:

<path> — полный путь к соответствующему конфигурационному файлу: kuma-ptvm-config.yaml или kuma-ptvm-vulnerable-assets-config.yaml.

Для каждого тенанта, указанного в конфигурационном файле, создается отдельный файл с именем вида <идентификатор_тенанта_OSMP>.json. Кроме того, создается файл tenants, содержащий список JSON-файлов для загрузки в OSMP. Все файлы сохраняются в директории утилиты.
1. Проверьте экспортированные файлы активов и при необходимости внесите изменения:
  - Распределите активы по соответствующим тенантам.
  - Из файла тенанта по умолчанию default вручную перенесите данные активов в файлы нужных тенантов.
  - В файле tenants отредактируйте список тенантов, активы которых будут импортированы в OSMP.
2. Импортируйте информацию об активах в OSMP с помощью одной из следующих команд:
  - Для импорта всех активов:
    ./kuma-ptvm --config <path> --upload
  - Для импорта активов, отфильтрованных по параметрам, заданным в конфигурационном файле:
    kuma-ptvm vulnerable-assets-api --config <path> --upload
  где:
  
  <path> — полный путь к соответствующему конфигурационному файлу: kuma-ptvm-config.yaml или kuma-ptvm-vulnerable-assets-config.yaml.
Чтобы просмотреть информацию о доступных командах утилиты, выполните команду --help.

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

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

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

Решение:

Выписать сертификат в соответствии с документацией MaxPatrol. Рекомендуется использовать этот способ устранения ошибки, как предпочтительный.
Отключить проверку сертификата.
Чтобы отключить проверку сертификата, добавьте в конфигурационный файл в разделе MaxPatrol settings следующую строку:

ignore_server_cert: true

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

Вам помогла эта статья?

Что нам нужно улучшить?

Спасибо за ваш отзыв, вы помогаете нам становиться лучше!