Описание параметров для настройки работы агента сбора данных
Изменение конфигурации агента производится путем изменения текущих параметров или добавления новых строк в файл 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": ,
"secure": true
},
"settings": {
"path": "$UserDataDirectory/.agent-config.json"
},
"users": [
"user"
]
}
Управление поведением агента.
Пример:
"agent": {
"create_employee": "true"
"tray": "true"
}
Параметр | Тип | Описание |
---|---|---|
create_employee | string ("true"/"false") | Автоматическое создание записи о сотруднике: - "true": авторегистрация - "false": ручная настройка. |
tray | string ("true"/"false") | Включение ручного режиме агента в трее: - "true": включение ручного режима, "false": работа в автоматическом режиме |
Пример:
"client": {
"type": "http"
}
Параметр | Тип | Описание |
type | string ("http"/"https") | Протокол передачи:- "http": незашифровано "https": шифрование |
Логирование и отладка.
Пример:"debug": {
"enabled": true,
"file": "$UserDataDirectory/agent.log",
"type": "file"
}
Параметр | Тип | Описание |
---|---|---|
enabled | boolean (true/false) | Режим отладки:- true: детальное логирование- false: отключено |
file | string | Путь к логам. Переменные:- $UserDataDirectory → |
type | string ("file"/"console") | Вывод логов:- "file": в файл- "console": в терминал |
Режим работы агента.
Пример:
"mode": "global"
Параметр | Тип | Описание |
---|---|---|
mode | string ("global"/"user") | Уровень мониторинга:- "global": все пользователи - "user": только из раздела users |
Подключение к серверу.
"server": {
"address": "example.insider.test",
"key": "Fee23fs%wrekdl492efkDLGKS",
"path": "agents/",
"port": 81,
"secure": true
}
Параметр | Тип | Описание |
---|---|---|
address | string | Домен/IP сервера (пример: example.insider.test). Должен разрешаться в DNS. |
key | string | Секретный ключ аутентификации. ⚠️ Хранить в секрете! |
path | string | Endpoint для данных |
port | integer | Порт сервера:- 80 (HTTP), 443 (HTTPS), 81 (кастомный) |
secure | boolean (true/false) | SSL/TLS:- true: шифрование трафика⚠️ Конфликт: При client.type: "http" и secure: true проверьте настройки. |
Сбор данных и интервалы.
Пример:
"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 | Путь к конфигурации (пример: $UserDataDirectory/configuration.json). |
keyboardCaptureEnabled | string ("true"/"false") | Запись нажатий клавиш. ⚠️ Требует согласия пользователя! |
keyboardCaptureInterval | string (мс) | Интервал отправки (пример: "2500" = 2.5 сек) |
mouseCaptureEnabled | string ("true"/"false") | Запись движений мыши |
mouseCaptureInterval | string (мс) | Интервал отправки (пример: "60000" = 60 сек) |
processesCaptureEnabled | string ("true"/"false") | Мониторинг процессов |
processesCaptureInterval | string (мс) | Интервал обновления (пример: "1000" = 1 сек) |
screenCaptureEnabled | string ("true"/"false") | Скриншоты экрана |
screenCaptureInterval | string (мс) | Интервал создания (пример: "60000" = 60 сек) |
siteCaptureEnabled | string ("true"/"false") | Отслеживание сайтов |
siteCaptureInterval | string (мс) | Интервал обновления (пример: "1000" = 1 сек) |
Список пользователей для мониторинга.
Пример:
"users": ["zm", "example", "users"]
Параметр | Тип | Описание |
---|---|---|
users | array | Имена пользователей (пример: ["zm", "example"]):- Пустой массив → мониторинг отключен- Для mode: "global" игнорируется. |