پرش به مطلب اصلی

HTML Live MQTT برای Onboarding و Settings

HTML تعاملی داخل اپ موبایل می‌تواند Session موقت MQTT بگیرد تا با Gateway ارتباط دوطرفه Live داشته باشد.

Temporary connection​

API Canonical:

api/v1/gateway/devices/GenerateTempConnection

Session شامل sessionId, clientId, username, password, createdAt, expiresAt است. TTL آن ۳۰ دقیقه است.

چهار Channel​

{projectCode}/v1/gw/{gatewaySerial}/html/{sessionId}/request
{projectCode}/v1/gw/{gatewaySerial}/html/{sessionId}/response
{projectCode}/v1/gw/{gatewaySerial}/html/{sessionId}/event
{projectCode}/v1/gw/{gatewaySerial}/html/{sessionId}/control

همه QoS 1 و retain=false هستند.

امنیت​

این Topicها /AES ندارند و Gateway encryptionKey هرگز به HTML داده نمی‌شود. امنیت:

WSS/TLS + temporary credential + strict session ACL

HTML session فقط باید بتواند request/control خودش را publish و response/event خودش را subscribe کند.

Correlation​

request با mid ارسال می‌شود و response همان mid را برمی‌گرداند. Event می‌تواند eventId داشته باشد.

No raw bus tunnel​

HTML مجاز نیست API عمومی برای writeRawRs485Frame, writeArbitraryRegister یا اجرای Function داخلی Firmware داشته باشد. مسیر معتبر:

HTML request
→ validated settings/onboarding handler
→ Driver
→ NativeBusExecutor