Администрирование серверов компании

В общем случае предприятие имеет несколько локальных серверов. Функции администрирования, которые относятся ко всем серверам одновременно, выполняются на странице глобального сервера. Функции, специфичные для каждого локального сервера в отдельности, выполняются со страницы настроек локального сервера. Поэтому один и тот же администратор имеет две различные страницы для администрирования. Одна из них находится на глобальном сервере, вторая - в каждом локальном сервере (хабе).

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

Откройте карточку «Локальные серверы компании»

На странице администрирования найдите карточку 🖥️ Локальные серверы компании.

Выберите сервер из списка

В выпадающем списке отображаются все серверы, привязанные к вашей учётной записи или компании:

• Серверы показываются в формате: Имя сервера (UUID)
• UUID — это уникальный идентификатор устройства, присваивается производителем и хранится в прошивке устройства.
• Имя сервера — понятное название для удобства (например, «Офис Москва»)

Добавьте сервер

Выберите нужный сервер из выпадающего списка и нажмите кнопку ➕ Добавить.

Сервер появится в списке доступных серверов вашей компании.

Сохраните изменения

Нажмите кнопку 💾 Сохранить список для применения изменений.

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

Получите токен на локальном сервере

Откройте веб-интерфейс вашего локального сервера и перейдите в раздел настроек. Найдите и скопируйте токен для интеграции с глобальным сервером.

Введите токен на глобальном сервере

На странице администрирования нажмите кнопку 🔑 Ввести токен для Алисы.

В открывшемся диалоге:

• Выберите сервер из списка
• Вставьте скопированный токен в текстовое поле
• Нажмите Сохранить

Создание нового пользователя

В карточке на глобальном сервере 👥 Управление пользователями компании вы можете создавать учётные записи для сотрудников вашей организации.

1. Введите email и пароль нового пользователя
2. Нажмите Создать
3. Пользователь появится в списке

Назначение серверов пользователю

Для каждого пользователя в списке доступна кнопка Назначить серверы:

1. Нажмите кнопку Назначить серверы рядом с нужным пользователем
2. В открывшемся диалоге отметьте галочками серверы, к которым пользователь должен иметь доступ
3. Нажмите Сохранить

Удаление пользователя

Для удаления пользователя нажмите кнопку Удалить рядом с его учётной записью и подтвердите действие.

Как работает подключение

Все локальные серверы в системе автоматически подключаются к глобальному серверу через защищённое WebSocket-соединение и обратный прокси-сервер на порту 8443.

• Каждый сервер идентифицируется уникальным UUID (генерируется при производстве)
• Имя сервера используется только для отображения в интерфейсе
• Доступ к серверу возможен из любой точки мира через глобальный сервер
• Работает без настройки портов и файрволов на стороне клиента

Выбор сервера при входе

При входе в систему, если у вас есть доступ к локальным серверам, появится диалог выбора:

• Кнопки с именами серверов — выбор конкретного локального сервера
• Остаться в облаке — работа только с облачными устройствами

После выбора сервера вы будете перенаправлены на его веб-интерфейс.

Принципы безопасности

• Изоляция компаний: Вы можете управлять только серверами своей компании
• Уникальные идентификаторы: UUID предотвращает конфликты имён между организациями
• Привязка к владельцу: Сервер не может быть использован без явной привязки
• Собственная авторизация: Каждый локальный сервер имеет свою систему аутентификации

Ограничения прав администратора

Как администратор компании, вы не можете:

• Регистрировать новые физические устройства (серверы/хабы) — только суперадминистратор
• Привязывать к себе серверы других компаний
• Изменять UUID устройств
• Видеть или управлять пользователями других компаний

Вы можете:

• Добавлять в свой список серверы, уже привязанные к вам
• Создавать пользователей в рамках своей компании
• Назначать им доступ к вашим серверам
• Настраивать токены для интеграций (Алиса и др.)
• Изменять имена серверов через BLE

Как работает обратный прокси

Локальные серверы автоматически подключаются к глобальному серверу (wss://realiot.ru:8443) через защищённое WebSocket-соединение:

1. При запуске локальный сервер считывает свой UUID из файла /opt/realiot-ble/device_id.txt
2. Отправляет событие register с UUID и именем сервера
3. Глобальный сервер проверяет, что UUID привязан к владельцу
4. При успешной проверке сервер регистрируется и становится доступен через прокси
5. Запросы вида https://realiot.ru:8443/<UUID>/... проксируются на локальный сервер

Статусы серверов

На странице реестра (доступна суперадминистратору) отображается статус каждого сервера:

• Онлайн — сервер активно подключён (последнее подключение менее 5 минут назад)
• Оффлайн — сервер не подключался более 5 минут или выключен