Раздел описывает параметры настройки агента сбора данных.
Агент собирает информацию о действиях пользователей и передаёт её на сервер.
Конфигурация задаётся через файл 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"
| Параметр | Тип | Описание |
mode | string ("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"]
| Параметр | Тип | Описание |
users | array | Список имён пользователей. Пример: ["zm", "example"]. При mode: "global" игнорируется. Пустой массив отключает мониторинг. |
configuration.json применяются после перезапуска агента.