Параметры конфигурационного файла kuma–ptvm–config.yaml

Секция General settings

log_level

Необязательный параметр.

Уровень журналирования.

Доступные значения:

• trace
• info
• warning
• error

Значение по умолчанию: info.

period

Необязательный параметр.

Из MaxPatrol будут экспортированы данные об активах, которые изменялись за указанный срок.

Ограничения отсутствуют.

Значение по умолчанию: 30d.

strict_import

Необязательный параметр.

При экспорте активов из MaxPatrol проверять, заполнены ли обязательные для KUMA поля. Не экспортировать из MaxPatrol активы, не прошедшие проверку.

Доступные значения:

• true – проверять наличие обязательных для KUMA полей.
• false – не проверять наличие обязательных для KUMA полей.

Значение по умолчанию: false.

Мы рекомендуем указывать значение true при экспорте активов из MaxPatrol, это позволит выявить возможные ошибки в файлах JSON и исправить ошибки перед тем, как вы импортируете активы в KUMA.

parallel_downloading

Необязательный параметр.

Определяет режим загрузки при импорте данных из MaxPatrol.

Доступные значения:

• true – загружать CSV-файлы параллельно.
• false – загружать CSV-файлы последовательно, чтобы снизить нагрузку на MaxPatrol.

Значение по умолчанию: true.

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

Секция KUMA settings

endpoint

Обязательный параметр.

URL сервера KUMA API. Например: kuma.example.com:7223

–

token

Обязательный параметр.

Токен KUMA API.

–

ignore_server_cert

Необязательный параметр.

Проверка сертификата KUMA.

Доступные значения:

• true – отключить проверку сертификата KUMA.
• false – выполнить проверку сертификата KUMA.

Параметр не включен в шаблон конфигурационного файла. Вы можете указать параметр со значением true вручную, тогда при запуске утилита kuma–ptvm не будет проверять сертификат.

Секция MaxPatrol settings

endpoint

Обязательный параметр.

URL сервера MaxPatrol API.

–

user

Необязательный параметр.

Имя пользователя MaxPatrol API.

–

password

Необязательный параметр.

Пароль пользователя MaxPatrol API.

–

secret

Необязательный параметр.

Секрет MaxPatrol API.

–

token

Необязательный параметр.

Токен MaxPatrol API.

Для доступа к серверу MaxPatrol через API вам нужно указать либо значения параметров user, password и secret, либо значение параметра token.

ignore_server_cert

Необязательный параметр.

Проверка сертификата MaxPatrol.

Доступные значения:

• true – отключить проверку сертификата MaxPatrol.
• false – выполнить проверку сертификата MaxPatrol.

Параметр не включен в шаблон конфигурационного файла. Вы можете указать параметр со значением true вручную, в случае возникновения ошибки tls: failed to verify certificate: x509: certificate is valid for localhost. В таком случае при запуске утилита kuma–ptvm не будет проверять сертификат.

Мы рекомендуем выписать сертификат в соответствии с документацией MaxPatrol, как предпочтительный способ устранения ошибки.

Секция Vulnerable Assets API Parameters

Ограничения: параметры from и to доступны в действующем контракте Swagger, но их поддержка зависит от развернутой у вас версии PTVM.

groups

Необязательный параметр.

Список идентификаторов групп активов, которые используются для фильтрации. В импорт будут включены только активы, относящиеся к указанным группам.

Пример:

4b7d711f-ae35-4c94-8625-4cfabf5fb99e

statuses

Необязательный параметр.

Статус уязвимостей активов для фильтрации.

Доступные значения:

• new — новая уязвимость.
• inProgress — устранение уязвимости выполняется.
• awaitingFix — ожидается устранение уязвимости.
• excluded — уязвимость исключена из обработки.
• fixed — уязвимость устранена.
• overdue — срок устранения уязвимости истек.
• stale — устаревшая уязвимость.

severities

Необязательный параметр.

Степень критичности уязвимостей активов для фильтрации.

Доступные значения:

• none — степень критичности не определена.
• low — низкая.
• medium — средняя.
• high — высокая.
• critical — критическая.

from

Необязательный параметр.

Начальная дата и время периода фильтрации по дате последнего аудита актива включительно. Указывается в формате UTC.

Пример:

2026-02-10T00:58:00.123Z

to

Необязательный параметр.

Конечная дата и время периода фильтрации по дате последнего аудита актива включительно. Указывается в формате UTC.

Пример:

2026-02-11T00:58:00.123Z

Секция Vulnerability filter

only_exploitable

Необязательный параметр.

Экспортировать из MaxPatrol только активы с уязвимостями, для которых известны эксплойты.

Доступные значения:

• true – экспортировать только активы с уязвимостями, для которых известны эксплойты.
• false – экспортировать все активы.

Значение по умолчанию: false.

min_severity

Необязательный параметр.

Импортировать только уязвимости указанного уровня и выше.

Доступные значения:

• low
• medium
• high
• critical

Значение по умолчанию: low.

Секция Tenant map

id

Обязательный параметр.

Идентификатор тенанта в KUMA.

Активы распределяются по тенантам в том порядке, в каком тенанты указаны в конфигурационном файле: чем выше тенант в списке, тем выше у него приоритет. Таким образом вы можете указывать и перекрывающиеся подсети.

–

fqdn

Необязательный параметр.

Регулярное выражение для поиска FQDN актива.

–

networks

Необязательный параметр.

Одна или несколько подсетей.

–

default_tenant

Необязательный параметр.

Идентификатор тенанта KUMA по умолчанию, куда будут поступать данные об активах, которые не удалось распределить по тенантам, заданным в секции параметров Tenants.

–