Центр знаний
Центр знаний по приложениям для бизнеса
Kaspersky Endpoint Detection and Response Expert (on-premise)
Работа с Open Single Management Platform
Управление активами
Добавление активов
Импорт информации об активах из MaxPatrol
Kaspersky Endpoint Detection and Response Expert (on-premises)
Онлайн-справка
FAQ Форум Запрос в поддержку Утилиты для лечения

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

13 октября 2026

ID 264885

Скачать PDF

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

Вы можете импортировать информацию об активе из отчета MaxPatrol или из MaxPatrol VM.

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

Импорт происходит через API с помощью утилиты maxpatrol-tool на сервере, где установлено Ядро KUMA.

Утилита входит в комплект поставки KUMA и расположена в архиве установщика в директории /kuma-ansible-installer/roles/kuma/files.

Импорт поддерживается из MaxPatrol 8.

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

  1. Сформируйте в MaxPatrol отчет сканирования сетевых активов в формате XML file и скопируйте файл отчета на сервер Ядра KUMA. Подробнее о задачах на сканирование и форматах выходных файлов см. в документации MaxPatrol.

    Импорт данных из отчетов в формате SIEM integration file не поддерживается. Требуется выбрать формат XML file.

  2. Создайте файл с токеном для доступа к KUMA REST API. Для удобства рекомендуется разместить его в папке отчета MaxPatrol. Файл не должен содержать ничего, кроме токена.

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

    • Роль Администратора или Аналитика.
    • Доступ к тенанту, в который будут импортированы активы.
    • Настроены права на использование API-запросов GET /users/whoami и POST /api/v1/assets/import.

      Мы рекомендуем для импорта активов из MaxPatrol создать отдельного пользователя с минимально необходимым набором прав на использование API-запросов.

  3. Скопируйте утилиту maxpatrol-tool на сервер с Ядром KUMA и сделайте файл утилиты исполняемым с помощью команды:

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

  4. Запустите утилиту maxpatrol-tool:

    ./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 example.xml --cert /opt/kaspersky/kuma/core/certificates/ca.cert

Вы можете использовать дополнительные флаги и команды для импорта. Например, команду для отображения полного отчета о полученных активах --verbose, -v. Подробное описание доступных флагов и команд приведено в таблице Флаги и команды утилиты maxpatrol-tool. Также для просмотра информации о доступных флагах и командах вы можете использовать команду --help.

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

Поведение утилиты при импорте активов:

  • KUMA перезаписывает данные импортированных через API активов и удаляет сведения об их устраненных уязвимостях.
  • KUMA пропускает активы с недействительными данными. Сведения об ошибках отображаются при использовании флага --verbose.
  • Если в одном отчете MaxPatrol есть активы с одинаковыми IP-адресами и полными именами домена (FQDN), эти активы объединяются. Сведения об их уязвимостях и программном обеспечении также объединяются в одном активе.

    При загрузке активов из MaxPatrol активы с аналогичными IP-адресами и полными именами доменов (FQDN), ранее импортированные из Kaspersky Security Center, перезаписываются.

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

    --ignore <диапазоны IP-адресов> или -i <диапазоны IP-адресов>

    Активы, соответствующие условиям фильтрации, не загружаются. Описание команды вы можете просмотреть в таблице Флаги и команды утилиты maxpatrol-tool.

    Флаги и команды утилиты maxpatrol-tool

Примеры:

  • ./maxpatrol-tool --kuma-rest example.kuma.com:7223 --token token.txt --tenant Main example.xml --cert /example-directory/ca.cert – импорт активов в KUMA из отчета MaxPatrol example.xml.
  • ./maxpatrol-tool help – получение справки об утилите.

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

Импорт информации об активах из 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-токен:

  3. Сгенерировать токен для доступа к XDR REST API.

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

  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

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

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