Hermetry, MQTT 3.1.1 protokolünü destekler. Bu sayfa cihaz geliştiricileri için bağlantı referansıdır: broker’a nasıl ulaşılacağı, nasıl giriş yapılacağı, oturumların nasıl davrandığı, neyin ne zaman onaylandığı ve bir bağlantı reddedildiğinde ne yapılacağı. Konular ve yükler MQTT konuları ve yük referansı sayfasında yer almaktadır.
Bağlantı
| Öğe | Değer |
|---|---|
| Protokol | MQTT 3.1.1 (protokol seviyesi 4). MQTT 5 için yapılan bir CONNECT, CONNACK 1 ile reddedilir. |
| Port, TLS | 8883 |
| Port, düz | 1883, yalnızca düz MQTT’ye izin veren bir profildeki cihazlar için |
| Sunucu adı | Cihazın Bağlantı ayrıntıları kartındaki broker sunucu adı. Kuruluşunuzun bölgesinin sunucu adını kullanın. |
| Temiz oturum | true gönderin. false ile yapılan bir CONNECT, temiz oturum olarak işlenir. |
| Canlı tutma | MQTT canlı tutma değerini kullanın. 0 olan veya broker’ın üst sınırının (varsayılan kurulumda 300 saniye) üzerindeki canlı tutma değeri, üst sınırda işlenir. |
| Will mesajı | İzin verilir, yok sayılır. Bağlantı durumuna Hermetry kendisi karar verir. |
| Retain bayrağı | Yok sayılır. Mesaj işlenir, saklanmaz. |
| Bağlantı süresi | TCP bağlantısından kabul edilen bir CONNECT’e kadar (TLS el sıkışması ve giriş dahil) cihazın birkaç saniyesi vardır (varsayılan 5). |
Çevrimdışıyken, komutlar kalıcı olarak işaretlenmedikçe cihaz için hiçbir şey kuyruğa alınmaz. Her bağlantıdan sonra cihaz yeniden abone olur ve paylaşılan özniteliklerini ister; böylece güncel değerleri alır.
TLS
- En az TLS 1.2, tercihen TLS 1.3.
- TLS 1.2 paket şifreleri:
ECDHE-ECDSA-AES128-GCM-SHA256,ECDHE-RSA-AES128-GCM-SHA256,ECDHE-ECDSA-CHACHA20-POLY1305. RSA anahtar değişimi ve CBC yoktur. - SNI gereklidir. IP adresi yerine sunucu adıyla bağlanın.
- Üçüncü taraf cihazlar için sunucu sertifikası herkese açık bir sertifikadır. Normal CA paketinize ve sunucu adına göre doğrulayın.
- Sunucu istemci sertifikası ister ancak zorunlu kılmaz; bu sayede tek bir port her giriş türüne hizmet eder.
- Küçük cihazlar 4 KB TLS kayıtları isteyebilir (
max_fragment_length).
Bir profil, cihazlarının düz porta hiç erişip erişemeyeceğine karar verir (profilin Taşıma ve kimlik doğrulama sekmesinde Düz MQTT). Varsayılan yalnızca TLS’dir. Bkz. Cihaz taşıma güvenliği.
Giriş yapma
| Kimlik bilgisi | İstemci Kimliği | Kullanıcı adı | Parola |
|---|---|---|---|
| Erişim belirteci | geçerli herhangi bir kimlik | erişim belirteci | boş |
| Temel MQTT | herhangi biri veya sabitlenmiş istemci kimliği | kullanıcı adı | parola |
| X.509 sertifikası | cihaz seri numarası (sertifikanın CN değerine eşit olmalıdır) | seri numarası (yok sayılır) | boş |
- Bir istemci kimliği,
A–Z a–z 0–9 . _ : -karakterlerinden oluşan 1 ila 64 karakterdir. Bunların dışındaki her şey CONNACK 2 ile reddedilir. - Kullanıcı adı olup parolası olmayan bir CONNECT, erişim belirteci olarak okunur. Kullanıcı adı olmayan bir CONNECT reddedilir.
- Bir istemci sertifikası sunulduğunda karar onunla verilir. Parolaya geri dönüş yoktur. Güvenilmeyen bir sertifika TLS el sıkışmasını sonlandırır.
provisionkullanıcı adı, bir sağlama oturumu açar (bkz. Cihaz ekleme ve sahiplenme).- Profil; kimlik bilgisi türüne, cihazın ağına ve portuna (TLS veya düz) izin vermelidir; aksi halde giriş CONNACK 5 ile reddedilir.
Oturumlar
- Cihaz başına bir oturum. Aynı cihazın ikinci bir bağlantısı, birinciyi devralır ve kapatır. Oturumu tekrar tekrar iki ağdan devralınan bir cihaz bir süre geri tutulur ve yöneticileriniz bir bildirim alır (“devralma çekişmesi”); aynı kimlik bilgisini paylaşan iki cihaz olup olmadığını kontrol edin.
- Yeniden kontroller. Her açık oturum yaklaşık 60 saniyede bir yeniden denetlenir. Döndürülmüş veya iptal edilmiş bir kimlik bilgisi, devre dışı bırakılmış veya silinmiş bir cihaz, askıya alınmış bir kuruluş ya da oturumun artık karşılamadığı bir profil değişikliği, oturumu hemen sonlandırır.
- Karantinadaki cihazlar bağlanır, ancak bir yönetici etkinleştirene kadar telemetri ve öznitelikleri onaylanır ve atılır.
- Yeni ağ bildirimi. Bir cihaz son seferden farklı bir ağdan giriş yaptığında, yöneticileriniz bildirim alabilir (cihaz başına saatte en fazla bir kez); böylece çalınan bir kimlik bilgisi fark edilmeden kalmaz.
- Bağlı cihaz sınırı. Planınız aynı anda bağlı olabilecek cihaz sayısını sınırlıyorsa, bu sınırın üzerindeki bir CONNECT, CONNACK 5 ile reddedilir.
Onaylar ve QoS
- QoS 1 ile yayımlayın. QoS 0 kabul edilir; QoS 2, QoS 1 gibi işlenir.
- Hermetry, PUBACK’i yalnızca mesaj güvenli biçimde kuyruğa alındıktan sonra gönderir. PUBACK’ler, cihazın yayımladığı sırayla gönderilir.
- Bir mesaj kuyruğa alınamazsa, o mesaj PUBACK almaz (o oturumdaki sonraki hiçbir mesaj da almaz) ve oturum birkaç saniye içinde kapatılır. Cihaz, yeniden bağlandıktan sonra onaylanmamış mesajları yeniden gönderir.
- Bir cihazın varsayılan olarak en fazla 20 onaylanmamış QoS 1 mesajı uçuşta olabilir (profilin En fazla onaylanmamış mesaj (MQTT) değeri, 1 ila 1.000).
- Aynı cihaz, anahtar ve zaman damgasına sahip yinelenen mesajlar bir kez saklanır; bu nedenle yeniden göndermek güvenlidir.
Sınırlar
| Sınır | Varsayılan | Nerede ayarlanır |
|---|---|---|
| Telemetri mesajları | 10:1,300:60 (saniyede 10 ve dakikada 300) | Profil Sınırlar |
| Telemetri veri noktaları | 200:1,6000:60 | Profil Sınırlar |
| Öznitelik mesajları | 5:1,60:60 | Profil Sınırlar |
| Mesaj boyutu | 64 KiB, en fazla 1.000 anahtar-değer noktasına kadar | Profil En fazla mesaj yükü (bayt) |
| Cihaza giden mesajlar | 64 KiB (lisanslı cihazlar için 4 KiB) | Profil En fazla alt yönlü yük (bayt) |
- Hız limiti aşılırsa mesaj onaylanır ve atılır. Limitini sürekli aşan bir cihazın (bir dakika içinde dakika hakkının üç katından fazlası atılırsa) oturumu kapatılır. Sahipler ve yöneticiler cihaz başına saatte bir bildirim alır.
- Çok büyük bir mesaj bütünüyle atılır; bağlantı açık kalır.
- Kuruluşunuzun bütünü de planından gelen hız sınırlarına sahiptir.
- Bir kesintiden sonra bir cihazın gönderdiği, tamponlanmış okumalar (her kayıt daha eski bir
tstaşır) ayrıca profilin Saniyede yeniden oynatılan mesaj sınırına uymalıdır. - Telemetri ve öznitelik mesajları aylık mesaj kotanıza sayılır; bağlantı olayları, komutlar ve alarmlar sayılmaz. Bkz. Mesaj kotası ve kullanım.
CONNACK kodları
| Kod | Anlamı | Cihazın yapması gereken |
|---|---|---|
| 0 | Kabul edildi | Devam edin. |
| 1 | Protokol sürümü desteklenmiyor | Yeniden denemeyi durdurun; istemciyi düzeltin. |
| 2 | İstemci Kimliği reddedildi | Yapılandırma değişene kadar durun. |
| 3 | Sunucu kullanılamıyor: hizmet meşgul, başlıyor veya durduruluyor ya da adres kısa süreliğine engellenmiş | Rastgele gecikmeyle geri çekilin ve yeniden deneyin. |
| 4 | Hatalı kullanıcı adı veya parola | En az 5 dakika (en fazla 1 saat) bekleyin. |
| 5 | Yetkisiz: cihaz devre dışı, sertifika iptal edilmiş veya süresi dolmuş, kuruluş askıya alınmış ya da cihaz veya bağlı cihaz sınırını aşmış, giriş türü, ağ veya port profil tarafından izin verilmiyor | Uzun programla geri çekilin. |
Kod 5’in arkasındaki neden cihaza hiçbir zaman gönderilmez. Cihazın Günlük sekmesine yazılır.
Not
Tek bir adresten tekrarlanan başarısız girişler, o adresi arkasındaki her cihaz için kısa süreliğine engeller. Bu nedenle yanlış yapılandırılmış bir cihaz, aynı NAT arkasındaki komşularının erişimini engelleyebilir. Yanlış kimlik bilgilerini hızla düzeltin.
Bağlantı kesme nedenleri
Cihazın Günlük sekmesi, bir oturumun neden sona erdiğini gösterir:
| Neden | Anlamı |
|---|---|
client_disconnect | Cihaz bağlantıyı kapattı. |
keepalive_timeout | Canlı tutma süresi içinde hiçbir şey gelmedi. |
takeover | Aynı cihazın başka bir bağlantısı devraldı. |
auth_revoked | Kimlik bilgisine, cihaza veya kuruluşa artık izin verilmiyor. |
rate_limit | Cihaz hız sınırını aşmaya devam etti. |
server_shutdown | Broker düğümü yeniden başlatıldı; yeniden bağlanın. |
protocol_error, inflight_exceeded, socket_error | İstemci protokolü ihlal etti, çok fazla onaylanmamış mesaj gönderdi ya da ağ arızalandı. |
Önerilen cihaz davranışı
- Sunucu adıyla TLS üzerinden bağlanın; canlı tutma değeri 30 ile 300 saniye arasında olsun.
- CONNACK 0 sonrasında alt yönlü konulara abone olun, paylaşılan öznitelikleri isteyin, istemci özniteliklerini bildirin, ardından canlı verilerden önce tamponlanmış telemetriyi gönderin.
- QoS 1 kullanın ve tamponlanmış bir okumayı silmeden önce PUBACK bekleyin.
- Saniyede birden fazla örnek gönderiyorsanız okumaları toplu gönderin.
- Reddedilen bir bağlantıda CONNACK tablosundaki geri çekilme süresini izleyin; bir cihaz filosunun aynı anda yeniden bağlanmaması için rastgele gecikme ekleyin.

