Административная панель

Административная панель — это мощный инструмент для детальной настройки системы. Доступ к ней осуществляется по URL /admin/. Для входа используйте логин и пароль суперадминистратора, созданный при развертывании.

Глобальная конфигурация датчиков

Это самый важный раздел для настройки поведения системы. Он находится в разделе Датчики -> Глобальная конфигурация датчиков.

Примечание: В системе может быть только одна запись с глобальной конфигурацией. Не пытайтесь создать новую, редактируйте существующую.

Доступные настройки:

  • Период отправки данных: Указывается в секундах. Это значение сервер будет отправлять датчикам в ответ на запрос конфигурации. Датчик должен будет присылать данные с этой периодичностью.

  • Таймаут на стороне сервера: Запрещает прием данных с одного IP-адреса чаще, чем раз в указанное количество секунд. Это основная защита от DoS-атак и "слишком активных" датчиков. 0 — отключить ограничение.

  • Хранить логи (дней): Автоматически удалять записи журнала аудита старше указанного количества дней. Оставьте поле пустым, чтобы отключить.

  • Хранить логов (макс. кол-во): Ограничение на максимальное количество записей в журнале. При превышении самые старые записи будут удалены.

  • Удалять неактивные устройства (дней): Автоматически удалять из системы устройства (вместе со всеми их показаниями), которые не проявляли активность указанное количество дней.

  • Удалять связанные логи при удалении устройства: Если флажок снят, при удалении неактивного устройства его записи в журнале аудита будут сохранены.

Управление вебхуками

Вебхуки позволяют отправлять автоматические уведомления во внешние системы при наступлении определенных событий. Раздел находится в Аудит и Вебхуки -> Вебхуки.

При создании или редактировании вебхука вам нужно заполнить следующие поля:

  • Название: Произвольное название (например, "Уведомление в Telegram о DoS").

  • Активен: Галочка для включения/выключения вебхука.

  • События-триггеры: Выберите одно или несколько событий, которые будут вызывать этот вебхук.

  • URL: Адрес, на который будет отправлен запрос (например, API URL вашего Telegram-бота).

  • HTTP метод: Обычно POST.

  • Заголовки: Дополнительные HTTP-заголовки в формате JSON (например, {"Authorization": "Bearer key123"}).

  • Шаблон тела запроса: Самое важное поле. Здесь вы формируете тело запроса, используя синтаксис шаблонов Django.

Справка по шаблонам

Важное правило: Шаблон тела должен всегда формировать валидный однострочный JSON-объект. Переносы строк внутри текста сообщения должны быть указаны как \\n.

Доступные переменные:

  • {{ event.name }}: Название события.

  • {{ device.ip_address }}: IP-адрес устройства.

  • {{ user.username }}: Имя пользователя (если применимо).

  • {{ details }}: JSON-объект с дополнительной информацией о событии.

  • {{ timestamp }}: Метка времени события.

Пример шаблона для Telegram:

Last updated