Параметры конфигурационного файла 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, как предпочтительный способ устранения ошибки.

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

–