Искать
Искать

Конфигурация агента

Дата публикации

17 сентября 2025 г.

Евгения Житникова

Технический редактор

Назначение конфигурационного файла агента

Конфигурационный файл агента отвечает за его корректную работу и связь с системой Vulns.io Enterprise VM. Он содержит идентификаторы, сетевые параметры и настройки, необходимые для:

  • идентификации актива в системе;
  • аутентификации агента с помощью уникального API-ключа;
  • установления соединения с сервером Vulns.io и выполнения задач (аудита, инвентаризации, обновлений и др.).

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

Файл конфигурации Агента, установленного на Linux-активе, хранится в директории: /opt/vulns.io/agent-linux/config.ini

Файл конфигурации Агента, установленного на Windows-активе, хранится в директории: C:\Program Files (x86)\Vulns.io Windows Agent\config.ini

Параметры конфигурационного файла

Параметр

Описание

[credentials]


asset_id

Идентификатор Актива в Системе

agent_id

Идентификатор Агента в Системе

api_key

API ключ для подключения к Системе

[network]


api_url

IP или доменное имя, по которому осуществляется доступ к Системе

websocket_url

Адрес подключения к Системе по вебсокету

request_timeout

Время ожидания ответа в секундах. Значение по умолчанию: 5

certificate_verify

Включение или отключение проверки сертификатов в сетевых запросах.
Возможные варианты значения поля:
False: не проверять сертификаты,
True: использовать сертификаты из локального хранилища Актива
: Для использования самоподписанного сертификата необходимо выгрузить
всю цепочку сертификатов в файл .crt и указать в значении поля путь к файлу.
Значение по умолчанию: False

[proxy]

Если прокси не используется, необходимо оставить значения пустыми

url

IP прокси

login

Пользователь прокси

password

Пароль пользователя прокси

[schedulers]


audit_schedule

Расписание задачи аудита, которая инициируется самим агентом, в формате cron-строки.
Значение по умолчанию: пустое - отключает данную возможность.

[logging]


level

Уровень логирования, возможные варианты значения поля:
critical, error, warning, info, debug. Значение по умолчанию: info

log_path

Путь к файлам логов. В папке содержатся файлы Vulns.io.Agent.log и error.log.
Ротация файлов осуществляется при достижении файлом размера 5Мб,
максимальное количество файлов - 3.
По умолчанию путь в Linux: /var/log/vulns.io/agent-linux;
в Windows: C:\Program Files (x86)\Vulns.io Windows Agent\Vulns.io logs\agent

log_to_eventmanager

Включение или отключение дублирования логов в Event Manager (Просмотр событий) в Windows.
Логи можно посмотреть в разделе Журналы Windows -> Приложение,
название источника Vulns.io.Agent. Значение по умолчанию: False

[version]


version

Текущая версия агента

[settings]


auto_audit_after_package_update

Автоматический запуск аудита после выполнения задач Обновление пакетов(Linux)
и Установка KB(Windows). Значение не изменяется, всегда True

partial_output_send_period

Объем данных (консольный вывод команд и логи), который Агент отправляет в Систему
в процессе выполнения задач. Возможные варианты значений:
xxxb (в байтах), xxxkb (в килобайтах), xxxmb (в мегабайтах),
где xxx - это любое целое число. Значение по умолчанию: 512b

reboot_allowed

Разрешение/запрет перезагрузки актива при выполнении задач обновления ПО с указанием
параметра "Перезагружать после установки". Параметр, указанный в
конфигурационном файле, имеет приоритетное значение.
Значение по умолчанию: True

min_available_disk_space_for_update

Минимальный объем свободного места на диске, требуемого для загрузки файлов обновлений
при выполнении задач Обновление ПО и Установка KB (Windows).
Возможные варианты значений: xxxb (в байтах), xxxkb (в килобайтах), xxxmb (в мегабайтах),
где xxx - это любое целое число. Значение по умолчанию: 20mb

[software_management]
(только в Windows)


storage_path

Путь для сохранения файлов установки стороннего ПО. Значение по умолчанию:
C:\Program Files (x86)\Vulns.io Windows Agent\software_management\

command_timeout

Время ожидания ответа от команды обновления в секундах. Значение по умолчанию: 1800

[core]

Системные параметры, изменять не рекомендуется.

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

Применение изменений конфигурационного файла

Для разных типов ОС используются разные варианты перезапуска службы агента:

Linux:

systemctl restart vulns.io-agent-linux

Windows:

1. Остановка агента:

Процессы --> находишь процесс агента --> пкм --> снять задачу

2. Запуск:

Службы --> находишь службу агента --> пкм --> запустить


Пример содержимого конфигурационного файла:

Заключение

Конфигурационный файл агента - это ключевой элемент безопасности и управляемости системы Vulns.io.

Он обеспечивает:

  • идентификацию актива в инфраструктуре,
  • аутентификацию агента при соединении с сервером,
  • настройку параметров выполнения аудита и логирования.

Знание структуры и принципов работы этого файла позволят администратору:

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

Хотите узнать больше?

Оставьте заявку, мы свяжемся с вами и бесплатно предоставим дистрибутив для тестирования в вашей инфраструктуре

Азат Хасанов

Пресейл-менеджер

Отправить заявку