Подтвердите, что вы не робот
Получить демо-доступ
Получить демо-доступ
Разделы
Свернуть

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

Введение

Раздел описывает параметры настройки агента сбора данных.

Агент собирает информацию о действиях пользователей и передаёт её на сервер.

Конфигурация задаётся через файл configuration.json — он находится в установочном пакете или в папке установленного агента.

Изменения параметров производятся вручную: добавлением или редактированием строк в конфигурационном файле.

Функциональные возможности

  • Управление режимом работы агента.

  • Настройка подключения к серверу.

  • Определение параметров логирования и отладки.

  • Настройка модулей сбора данных (клавиатура, экран, сайты и др.).

  • Ограничение мониторинга по пользователям.

Пример структуры файла configuration.json

{
  "agent": {
    "create_employee": "true"
  },
  "client": {
    "type": "http"
  },
  "debug": {
    "enabled": "false",
    "file": "$UserDataDirectory/agent.log",
    "type": "console"
  },
  "mode": "global",
    "server": {
    "address": "***",
    "key": "***",
    "path": "agents/",
    "port": 80,
    "secure": true
  },
  "settings": {
    "path": "$UserDataDirectory/.agent-config.json"
  },
  "users": [
    "user"
  ]
}

Раздел agent

Управление поведением агента.

Пример:

"agent": {
    "create_employee": "true",
    "tray": "true"
}

ПараметрТипОписание
create_employee string ("true" / "false")Автоматическое создание записи о сотруднике. "true" — авторегистрация, "false" — ручная настройка.
tray string ("true" / "false")Режим работы в системном трее. "true" — ручной запуск, "false" — автоматический.

Раздел client

Настройки сетевого взаимодействия.

Пример:

"client": {
    "type": "http"
}

ПараметрТипОписание
type string ("http" / "https")Протокол передачи данных: "http" — без шифрования, "https" — с использованием SSL/TLS.

Раздел debug

Параметры логирования и отладки.

Пример:

"debug": {
    "enabled": true,
    "file": "$UserDataDirectory/agent.log",
    "type": "file"
}

ПараметрТипОписание
enabled booleanВключение режима отладки. true — включено, false — отключено.
file stringПуть к лог-файлу. Можно использовать переменные, например $UserDataDirectory.
type string ("file" / "console")Способ вывода логов: "file" — в файл,"console" — в терминал.

Параметр mode

Определяет режим мониторинга.

Пример:

"mode": "global"

ПараметрТипОписание
modestring ("global" / "user")"global"— мониторинг всех пользователей, "user" — только указанных в разделе users.

Раздел server

Настройки подключения к серверу.

Пример:

"server": {
    "address": "example.insider.test",
    "key": "Fee23fs%wrekdl492efkDLGKS",
    "path": "agents/",
    "port": 81,
    "secure": true
}

ПараметрТипОписание
address stringДомен или IP-адрес сервера.
key stringСекретный ключ для аутентификации. ⚠️ Хранить в секрете!
path stringПуть (endpoint) для приёма данных.
port integerПорт подключения. Примеры: 80 (HTTP), 443 (HTTPS), 81 (кастомный).
secure booleanИспользование SSL/TLS. true — зашифрованный канал. ⚠️ При type: "http" и secure: true возможен конфликт.

Раздел settings

Настройки модулей сбора данных и интервалов.

Пример:

"settings": {
    "path": "$UserDataDirectory/configuration.json",
    "keyboardCaptureEnabled": "true",
    "keyboardCaptureInterval": "2500",
    "mouseCaptureEnabled": "true",
    "mouseCaptureInterval": "60000",
    "processesCaptureEnabled": "true",
    "processesCaptureInterval": "1000",
    "screenCaptureEnabled": "true",
    "screenCaptureInterval": "60000",
    "siteCaptureEnabled": "true",
    "siteCaptureInterval": "1000"
}

ПараметрТипОписание
path stringПуть к файлу конфигурации.
keyboardCaptureEnabled string ("true" / "false")Включение записи нажатий клавиш.
keyboardCaptureInterval string (мс)Интервал отправки данных (пример: 2500 = 2.5 сек).
mouseCaptureEnabled string ("true" / "false")Сбор данных о движениях мыши.
mouseCaptureInterval string (мс)Интервал обновления данных.
processesCaptureEnabled string ("true" / "false")Мониторинг запущенных процессов.
processesCaptureInterval string (мс)Интервал обновления списка процессов.
screenCaptureEnabled string ("true" / "false")Создание скриншотов экрана.
screenCaptureInterval string (мс)Интервал создания скриншотов.
siteCaptureEnabled string ("true" / "false")Отслеживание посещаемых сайтов.
siteCaptureInterval string (мс)Интервал сбора данных о сайтах.

Раздел users

Список пользователей, за которыми ведётся мониторинг.

Пример:

"users": ["zm", "example", "users"]

ПараметрТипОписание
usersarrayСписок имён пользователей. Пример: ["zm", "example"]. При mode: "global" игнорируется. Пустой массив отключает мониторинг.

Примечания

  • Все изменения в configuration.json применяются после перезапуска агента.

  • Рекомендуется сохранять резервную копию конфигурации перед изменениями.

  • Для корректной работы SSL необходимо наличие валидного сертификата на сервере.