Skip to content

Облачное подключение платы

Страница http://<ip-платы>/cloud.html доступна администратору, если модуль cloud включён в сборке. Облако используется для просмотра состояния и удалённых команд; локальные задачи работают на плате.

Подключение

  1. Войдите в кабинет и создайте проект.
  2. Добавьте плату по её UUID. Облако выдаст отдельный API key платы.
  3. На плате задайте http://cloud.kavlev.ru:8081 без завершающего /, ключ и интервал heartbeat. Включите подключение и сохраните.
  4. Проверьте статус и следующий heartbeat в кабинете.
Настройка Назначение
Enabled Включить обмен с облаком
URL API для плат, не HTTPS-адрес браузерного кабинета
API key Ключ этой зарегистрированной платы
Interval Интервал heartbeat, принимается 5–3600 секунд
MQTT Дополнительный канал состояния/команд; требует настроенного брокера
Heap log Диагностика свободной памяти при heartbeat

Проверьте Wi-Fi, DNS и время: сервер принимает подписанный timestamp в окне ±60 секунд. Статус /api/v1/cloud/status показывает результат попытки и ошибку. Если одна плата теряет облако/время, а соседние работают, сравните её IP/MAC и DHCP/ARP до смены прошивки.

Обмен и защита

Плата отправляет POST /api/v1/devices/{uuid}/heartbeat: версию, IP, uptime, состояния, краткий список задач и подтверждённые команды. Ключ не передаётся в URL или как открытый API-key заголовок; используется HMAC-SHA256 запроса. Точная формула приведена в API.

В обновлении протокола плата добавляет случайный response_nonce в подписанное тело. Облако подписывает точные байты ответа, связывая их с подписью текущего запроса. Новая прошивка отклоняет ответ без корректной подписи до применения команд. Поэтому при выпуске сначала обновляется облако, затем прошивка. Старые прошивки игнорируют новый заголовок и требуют отдельного обновления.

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

Команды возвращаются в heartbeat и подтверждаются последующим запросом. Доставка при потере ответа не гарантирована; см. описание ограничения.

Отключение

Выключите Enabled и MQTT и сохраните. Регистрация платы и её локальные задачи при этом сохраняются. Не очищайте ключ при включённом подключении: серверная проверка требует непустой ключ. Удаление записи в кабинете — отдельная операция.