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

Параметр

Описание

Значения

Группа Общие

log_level

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

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

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

• trace
• info
• warning
• error

Параметр по умолчанию: info.

period

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

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

Без ограничений.

Параметр по умолчанию: 30d.

strict_import

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

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

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

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

Параметр по умолчанию: false.

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

Группа KUMA settings

endpoint

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

URL сервера API XDR. Например, api.<XDR FQDN>/xdr/.

-

token

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

Токен API XDR.

-

ignore_server_cert

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

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

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

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

false – включать проверку сертификата.

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

Группа Параметры MaxPatrol

endpoint

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

URL сервера API MaxPatrol.

-

user

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

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

-

password

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

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

-

secret

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

Секрет API MaxPatrol.

-

token

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

Токен API MaxPatrol.

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

Группа Фильтр уязвимостей

only_exploitable

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

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

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

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

false – экспортировать все активы.

Параметр по умолчанию: false.

min_severity

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

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

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

• low
• medium
• high
• critical

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

Группа Карта тенанта

id

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

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

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

-

fqdn

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

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

-

networks

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

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

-

default_tenant

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

Тенант XDR по умолчанию, получающий данные об активах, которые не были распределены между тенантами, указанными в группе параметров "Тенанты".

-