Конфигурация агента
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 |
Включение или отключение проверки сертификатов в сетевых запросах. |
|
[proxy] |
Если прокси не используется, необходимо оставить значения пустыми |
|
url |
IP прокси |
|
login |
Пользователь прокси |
|
password |
Пароль пользователя прокси |
|
[schedulers] |
|
|
audit_schedule |
Расписание задачи аудита, которая инициируется самим агентом, в формате cron-строки. |
|
[logging] |
|
|
level |
Уровень логирования, возможные варианты значения поля: |
|
log_path |
Путь к файлам логов. В папке содержатся файлы Vulns.io.Agent.log и error.log. |
|
log_to_eventmanager |
Включение или отключение дублирования логов в Event Manager (Просмотр событий) в Windows. |
|
[version] |
|
|
version |
Текущая версия агента |
|
[settings] |
|
|
auto_audit_after_package_update |
Автоматический запуск аудита после выполнения задач Обновление пакетов(Linux) |
|
partial_output_send_period |
Объем данных (консольный вывод команд и логи), который Агент отправляет в Систему |
|
reboot_allowed |
Разрешение/запрет перезагрузки актива при выполнении задач обновления ПО с указанием |
|
min_available_disk_space_for_update |
Минимальный объем свободного места на диске, требуемого для загрузки файлов обновлений |
|
[software_management] |
|
|
storage_path |
Путь для сохранения файлов установки стороннего ПО. Значение по умолчанию: |
|
command_timeout |
Время ожидания ответа от команды обновления в секундах. Значение по умолчанию: 1800 |
|
[core] |
Системные параметры, изменять не рекомендуется. |
Если в файле отсутствуют необходимые параметры, Агент самостоятельно изменит конфигурационный файл, указав таким параметрам значения по умолчанию.
Применение изменений конфигурационного файла
Для разных типов ОС используются разные варианты перезапуска службы агента:
Linux:
systemctl restart vulns.io-agent-linux
Windows:
1. Остановка агента:
Процессы --> находишь процесс агента --> пкм --> снять задачу
2. Запуск:
Службы --> находишь службу агента --> пкм --> запустить
Пример содержимого конфигурационного файла:
Заключение
Конфигурационный файл агента - это ключевой элемент безопасности и управляемости системы Vulns.io.
Он обеспечивает:
- идентификацию актива в инфраструктуре,
- аутентификацию агента при соединении с сервером,
- настройку параметров выполнения аудита и логирования.
Знание структуры и принципов работы этого файла позволят администратору:
- быстро диагностировать и устранять проблемы с подключением,
- безопасно изменять параметры без риска потери связи с системой,
- гибко управлять поведением агентов на разных активах.
Хотите узнать больше?
Оставьте заявку, мы свяжемся с вами и бесплатно предоставим дистрибутив для тестирования в вашей инфраструктуре
Азат Хасанов
Пресейл-менеджер