Настройки приложения

ℹ️ О настройках приложения

Раздел настроек приложения позволяет администраторам конфигурировать глобальные параметры системы INFRAX, включая мониторинг, подключения, интеграции и безопасность. Все настройки организованы в удобную иерархическую структуру для быстрого доступа.

Содержание раздела

Обзор настроек
Доступ к настройкам
Общие параметры
Параметры мониторинга
Подключения и записи сессий
Отдел техподдержки
Telegram интеграция
Электронная почта
Загрузка файлов
Обновления и статистика
Лицензирование
INFRAX Cloud
Системные уведомления
Рекомендации

Обзор настроек

Настройки приложения в INFRAX предоставляют централизованное управление всеми параметрами системы. Интерфейс настроек построен на основе иерархического дерева, что позволяет легко находить нужные параметры.

Основные возможности

Иерархическая структура — параметры организованы по категориям для удобной навигации
Валидация данных — система автоматически проверяет корректность вводимых значений
Тестирование интеграций — встроенные функции проверки подключений (Email, Telegram)
Динамические параметры — некоторые настройки влияют на доступность других опций
Контроль доступа — настройки доступны только пользователям с соответствующими правами

Категории настроек

Настройки приложения разделены на следующие основные категории:

Общее — базовые параметры приложения
Мониторинг — конфигурация системы мониторинга
Подключения и записи сессий — настройки удаленного доступа
Отдел техподдержки — параметры модуля Helpdesk
Telegram — интеграция с мессенджером Telegram
Электронная почта — настройки SMTP и IMAP
Загрузка файлов — лимиты размеров файлов
Обновления и статистика — проверка обновлений и аналитика

Доступ к настройкам

Навигация к настройкам

Чтобы открыть настройки приложения:

Откройте главное меню приложения
Нажмите на иконку вашего профиля в правом верхнем углу
В выпадающем меню выберите пункт с иконкой настроек
Или перейдите напрямую по пути /app-settings

⚠️ Требуются права доступа

Для доступа к настройкам приложения требуется право /menu/settings:/menu/allow. Обычно это право имеют только администраторы системы.

Структура страницы настроек

Страница настроек разделена на несколько вкладок:

Основные настройки — главная вкладка с деревом параметров
Лицензирование — управление лицензией системы
INFRAX Cloud — интеграция с облачным сервисом
Системные уведомления — отправка уведомлений всем пользователям

Сохранение изменений

После внесения изменений в настройки необходимо нажать кнопку "Сохранить", которая закреплена внизу страницы. Все изменения применяются одновременно для всех измененных параметров.

ℹ️ Применение настроек

Большинство настроек применяются немедленно после сохранения. Некоторые параметры могут требовать перезапуска определенных сервисов или компонентов системы.

Общие параметры

Раздел "Общее" содержит базовые параметры приложения, влияющие на работу системы в целом.

Порт для подключения нативных клиентов

Параметр	Описание	Значение по умолчанию
`native_connect_port`	Порт, на котором доступны подключения через нативные клиенты (RDP, SSH и другие)	Зависит от установки

Этот параметр определяет TCP-порт, который система будет использовать для туннелирования подключений к нативным клиентам.

⚠️ Важно

При изменении этого параметра необходимо убедиться, что:

Порт не занят другими сервисами
Порт открыт в файерволе
Пользователи обновили свои клиентские настройки

Параметры мониторинга

Раздел "Мониторинг" позволяет настроить параметры сбора, хранения и отображения данных мониторинга.

Графики и визуализация

Параметр	Описание
`mon_chart_max_points`	Максимальное количество точек данных, отображаемых на графиках
`mon_chart_approximation_enabled`	Включить аппроксимацию данных при превышении максимального количества точек

Аппроксимация данных: Когда количество точек данных превышает максимальное значение, система может применять аппроксимацию для сглаживания графика и улучшения производительности отображения.

Хранение данных

Параметр	Описание
`monitoring_data_retention_days`	Глубина хранения данных мониторинга в днях. Данные старше указанного срока автоматически удаляются
`dashboard_metrics_max_age`	Максимальный возраст метрик для дашборда в секундах. Метрики старше этого времени не отображаются в топ-10 на дашборде

ℹ️ Оптимизация хранилища

Система автоматически удаляет старые данные мониторинга в соответствии с настроенным периодом хранения. Это помогает контролировать размер базы данных.

Настройка пороговых значений для дашборда

Параметр "Настройка пороговых значений для дашборда мониторинга" позволяет определить, при каких значениях метрик узлы будут отображаться на дашборде в разделах "Высокая загрузка CPU", "Высокая загрузка RAM" и т.д.

Это специальный компонент с расширенными настройками, который позволяет гибко настроить критерии отображения проблемных узлов на главном дашборде мониторинга.

Подключения и записи сессий

Раздел "Подключения и записи сессий" управляет параметрами удаленного доступа к узлам и записи действий пользователей.

Режимы подключения

Параметр	Описание
`only_web_client_connections`	Разрешить подключения только через веб-клиент. Если включено, подключения через нативные клиенты (RDP, SSH) будут заблокированы

✅ Безопасность

Включение режима "только веб-клиент" повышает безопасность, так как все подключения проходят через централизованный веб-интерфейс с полным контролем и записью.

Запись сессий

Параметр	Описание
`sessions_video_storage_limit_gb`	Максимальный объем дискового пространства для хранения видеозаписей удаленных сессий в гигабайтах. При превышении лимита старые записи автоматически удаляются
`sessions_recording_mode`	Режим записи сессий: "exclude" (записывать всех кроме выбранных) или "include" (записывать только выбранных)
`sessions_recording_users`	Список пользователей для записи сессий (в зависимости от выбранного режима)

Режимы записи сессий

Записывать всех кроме выбранных (exclude)

В этом режиме записываются сессии всех пользователей, кроме тех, кто указан в списке исключений. Это удобно, когда нужно исключить из записи только доверенных администраторов.

Записывать только выбранных (include)

В этом режиме записываются сессии только указанных пользователей. Это полезно для целевого мониторинга определенных сотрудников или для соблюдения требований безопасности.

⚠️ Дисковое пространство

Запись всех сессий может требовать значительного объема дискового пространства. Регулярно мониторьте использование диска и настраивайте лимит хранения в соответствии с доступными ресурсами.

Отдел техподдержки

Раздел "Отдел техподдержки" содержит специализированные настройки для модуля Helpdesk.

Сопоставление адресов отправителей с организациями

Параметр "Сопоставление адресов отправителей с организациями" позволяет настроить автоматическое определение организации при создании тикета из email.

Это специальный компонент, который позволяет создать правила сопоставления email-адресов или доменов с организациями в системе. Когда приходит письмо от определенного адреса, система автоматически привяжет создаваемый тикет к соответствующей организации.

Примеры использования

Все письма с домена @company.com автоматически привязываются к организации "Компания"
Письма от конкретного адреса support@client.com относятся к организации "Клиент"
Система поддерживает как точные адреса, так и маски доменов

Telegram интеграция

Раздел "Telegram" управляет интеграцией с мессенджером Telegram для отправки уведомлений и получения команд.

Настройки бота

Параметр	Описание
`telegram_bot_token`	Токен для доступа к API Telegram, полученный от @BotFather
`telegram_long_polling_enabled`	Включить Telegram бота. Использует long polling для получения сообщений. Не требует публичного IP адреса

Как настроить Telegram бота

Создайте бота через @BotFather в Telegram
Скопируйте полученный токен бота
Вставьте токен в поле "Токен бота"
Включите параметр "Включить Telegram бота"
Нажмите "Сохранить"

ℹ️ Информация о боте

После сохранения настроек в разделе "Информация о Telegram боте" отобразятся детали подключения: имя бота, username и статус подключения. Это позволяет убедиться, что бот настроен правильно.

✅ Long Polling

INFRAX использует технологию Long Polling для получения сообщений от Telegram. Это означает, что вам не нужен публичный IP адрес или настройка webhook — система сама будет опрашивать Telegram API.

Электронная почта

Раздел "Электронная почта" содержит настройки SMTP и IMAP серверов для отправки и получения email сообщений.

Настройки отправителя

Параметр	Описание
`email_main_sender_name`	Имя отправителя, которое будет отображаться в письмах
`email_main_sender_email`	Email адрес отправителя
`email_main_sender_login`	Логин для авторизации на почтовом сервере
`email_main_sender_password`	Пароль для авторизации на почтовом сервере

SMTP сервер (исходящая почта)

Параметр	Описание
`email_main_smtp_server_ip`	Адрес SMTP сервера (IP или доменное имя)
`email_main_smtp_server_port`	Порт SMTP сервера (обычно 25, 465 или 587)
`email_main_smtp_server_encryption`	Тип шифрования: TLS, SSL или без шифрования

IMAP сервер (входящая почта)

Параметр	Описание
`email_main_imap_server_ip`	Адрес IMAP сервера (IP или доменное имя)
`email_main_imap_server_port`	Порт IMAP сервера (обычно 143 или 993)
`email_main_imap_server_encryption`	Тип шифрования: TLS, SSL или без шифрования

Проверка настроек

После настройки параметров email интеграции вы можете проверить корректность настроек:

Заполните все необходимые поля
Нажмите кнопку "Сохранить"
Нажмите кнопку "Проверить отправку письма"
Система отправит тестовое письмо и покажет результат

⚠️ Важно

Перед проверкой отправки письма необходимо сохранить настройки. Кнопка проверки использует сохраненные в базе данных параметры.

Загрузка файлов

Раздел "Загрузка файлов" позволяет настроить лимиты размеров файлов для различных модулей системы.

Лимиты загрузки

Параметр	Описание
`upload_max_filesize_knowledge_base`	Максимальный размер одного файла для базы знаний в мегабайтах
`upload_max_filesize_helpdesk`	Максимальный размер одного файла для вложений в тикетах Helpdesk в мегабайтах

ℹ️ Ограничения

Эти лимиты помогают контролировать использование дискового пространства и предотвращают загрузку слишком больших файлов, которые могут замедлить работу системы.

⚠️ PHP конфигурация

Обратите внимание, что эти лимиты также зависят от настроек PHP (upload_max_filesize и post_max_size). Убедитесь, что лимиты PHP установлены не меньше, чем значения в INFRAX.

Обновления и статистика

Раздел "Обновления и статистика" управляет проверкой обновлений системы и отправкой анонимной статистики использования.

Параметры

Параметр	Описание
`check_updates_enabled`	Проверять обновления приложения. При проверке отправляются данные о текущей версии, количестве пользователей и узлов для проверки лицензирования
`anonymous_stats_enabled`	Разрешить отправку анонимной статистики использования приложения для улучшения качества продукта

Проверка обновлений

Когда параметр "Проверять обновления приложения" включен:

Система периодически проверяет наличие новых версий INFRAX
При появлении обновления администраторы получают уведомление
Информация о доступных обновлениях отображается в интерфейсе

ℹ️ Конфиденциальность

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

Анонимная статистика

Анонимная статистика помогает разработчикам INFRAX понять, как используется продукт, и улучшить его функциональность. Собираемая информация включает:

Информация о наиболее используемых функциях
Статистика производительности
Общая информация о конфигурации (без конкретных данных)

Отправка статистики полностью анонимна и не включает персональные данные, IP-адреса узлов или другую чувствительную информацию.

Лицензирование

Вкладка "Лицензирование" позволяет управлять лицензией INFRAX и просматривать информацию о доступных лимитах.

Управление лицензией

На странице лицензирования вы можете:

Загрузить лицензию — импортировать файл лицензии, полученный от поставщика
Просмотреть параметры лицензии — увидеть доступные лимиты и модули
Проверить срок действия — узнать, когда истекает текущая лицензия
Просмотреть использование — сравнить текущее использование с лимитами лицензии

Лимиты лицензии

Лицензия INFRAX может ограничивать:

Количество узлов сети — максимальное число мониторируемых устройств
Количество пользователей — максимальное число активных пользователей системы
Доступные модули — какие функциональные модули активированы (Helpdesk, Monitoring, Remote Access и т.д.)

⚠️ Community Edition

INFRAX может работать без лицензии в режиме Community Edition с ограниченной функциональностью. В этом режиме доступны базовые возможности, но имеются лимиты на количество узлов и пользователей.

Как загрузить лицензию

Перейдите на вкладку "Лицензирование"
Нажмите кнопку загрузки лицензии
Выберите файл лицензии с расширением .lic
Дождитесь подтверждения успешной загрузки
Обновите страницу для применения новых лимитов

INFRAX Cloud

Вкладка "INFRAX Cloud" предназначена для интеграции с облачным сервисом INFRAX Cloud, который предоставляет дополнительные возможности.

Возможности INFRAX Cloud

Централизованное управление — управление несколькими экземплярами INFRAX из единого интерфейса
Облачное резервное копирование — автоматическое резервное копирование конфигурации
Синхронизация данных — обмен данными между различными инсталляциями
Дополнительные сервисы — доступ к облачным функциям и интеграциям

Подключение к облаку

Для подключения к INFRAX Cloud:

Перейдите на вкладку "INFRAX Cloud"
Получите токен подключения от облачного сервиса
Введите токен в соответствующее поле
Нажмите кнопку подключения
Дождитесь подтверждения успешного подключения

ℹ️ Статус подключения

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

Системные уведомления

Вкладка "Системные уведомления" позволяет администраторам отправлять важные уведомления всем пользователям, подключенным к системе.

Отправка уведомлений

Чтобы отправить системное уведомление:

Перейдите на вкладку "Системные уведомления"
Нажмите кнопку "Отправить системное уведомление"
В открывшемся модальном окне введите текст уведомления
Выберите тип уведомления (информация, предупреждение, ошибка)
Нажмите кнопку отправки

Когда использовать

Системные уведомления полезны в следующих ситуациях:

Плановое обслуживание — предупредить пользователей о предстоящих работах
Критические обновления — уведомить о важных изменениях в системе
Аварийные ситуации — оперативно информировать о проблемах
Общие объявления — донести важную информацию до всех пользователей

✅ Мгновенная доставка

Уведомления доставляются всем активным пользователям мгновенно через WebSocket соединение. Пользователи увидят всплывающее уведомление в интерфейсе.