Перейти к содержанию

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

Введение

Раздел описывает параметры настройки агента сбора данных.
Агент собирает информацию о действиях пользователей и передаёт её на сервер.
Конфигурация задаётся через файл 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"
Параметр Тип Описание
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 применяются после перезапуска агента.

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

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