Облачное подключение платы¶
Страница http://<ip-платы>/cloud.html доступна администратору, если модуль cloud
включён в сборке. Облако используется для просмотра состояния и удалённых команд;
локальные задачи работают на плате.
Подключение¶
- Войдите в кабинет и создайте проект.
- Добавьте плату по её UUID. Облако выдаст отдельный API key платы.
- На плате задайте
http://cloud.kavlev.ru:8081без завершающего/, ключ и интервал heartbeat. Включите подключение и сохраните. - Проверьте статус и следующий 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 и сохраните. Регистрация платы и её локальные задачи при этом сохраняются. Не очищайте ключ при включённом подключении: серверная проверка требует непустой ключ. Удаление записи в кабинете — отдельная операция.