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

Секция General settings

log_level

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

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

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

• trace
• info
• warning
• error

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

strict_import

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

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

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

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

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

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

Секция KUMA settings

endpoint

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

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

–

token

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

Токен KUMA API.

–

Секция MaxPatrol settings

endpoint

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

URL сервера MaxPatrol API.

–

token

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

Токен MaxPatrol API.

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

Секция 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.

Секция Tenant map

id

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

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

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

–

fqdn

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

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

–

networks

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

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

–

default_tenant

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

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

–