Bu sayfa, bir cihazın Hermetry’ye bağlanamadığı, girişte reddedildiği veya bağlantısını sürekli kestiği durumlarda yardımcı olur. MQTT ve cihaz HTTP API’sini kapsar. LoRaWAN cihazları için Katılma sorunlarını giderme bölümüne; yoklanan (polled) cihazlar için Yoklama aralıkları, geri çekilme ve kota bölümüne bakın.
Önce nereye bakmalı
| Yer | Gösterir |
|---|---|
| Cihazın Günlük sekmesi | Her giriş reddinin nedenini ve her bağlantı kesilmesinin nedenini. Reddin arkasındaki neden cihaza hiçbir zaman gönderilmez: yalnızca burada bulunur. |
| Cihazın Bağlantı ayrıntıları kartı | Cihazınızın kullanması gereken broker ana makinesi ve portları |
| İstemcinin kendi günlüğü | Aldığı CONNACK kodu veya HTTP durumu ya da TLS hatası |
Adım 1: Cihaz broker’a ulaşabiliyor mu?
| Cihazdaki belirti | Neden | Çözüm |
|---|---|---|
| DNS sorgusu başarısız oluyor veya bağlantı zaman aşımına uğruyor | Yanlış ana makine veya bir güvenlik duvarı giden portu engelliyor | Kuruluşunuzun bölgesi için Bağlantı ayrıntıları kartındaki ana makineyi kullanın. Giden TCP 8883 (ve HTTPS için 443) trafiğine izin verin. |
| TLS el sıkışması başarısız oluyor | Cihaz IP adresiyle bağlanıyor (SNI gereklidir), CA paketi yok veya saati çok yanlış olduğu için sertifika geçersiz görünüyor | Ana makine adıyla bağlanın; sistemin CA deposunu kullanın; saati ayarlayın (NTP) |
| Çok küçük bir cihazda TLS başarısız oluyor | Yalnızca eski şifre paketlerini veya TLS 1.0/1.1’i destekliyor | En düşük TLS 1.2’dir; ECDHE ve GCM veya ChaCha20 paketleriyle. TLS kütüphanesini güncelleyin. |
| Port 1883 reddediliyor | Profil Yalnızca TLS (port 8883), varsayılan olarak | 8883’ü kullanın veya yalnızca özel bir ağda, profilde düz MQTT’ye izin verin |
| El sıkışma sırasında istemci sertifikası reddediliyor | Sertifika Hermetry’nin cihaz CA’sından değil veya iptal edilmiş | Güvenilmeyen bir sertifika el sıkışmayı sonlandırır; parolaya geri dönüş yoktur. Bkz. Cihaz sertifikaları. |
Bkz. Cihaz taşıma güvenliği.
Adım 2: Giriş kabul ediliyor mu?
MQTT, CONNECT isteğine bir CONNACK kodu ile yanıt verir:
| CONNACK | Anlamı | Olası nedenler |
|---|---|---|
| 1 | Protokol sürümü desteklenmiyor | İstemci MQTT 5 gönderiyor. Hermetry MQTT 3.1.1 kullanır. |
| 2 | İstemci kimliği reddedildi | İstemci kimliği boş, 64 karakterden uzun veya A–Z a–z 0–9 . _ : - dışında karakterler içeriyor |
| 3 | Sunucu kullanılamıyor | Hizmet başlıyor veya meşgul ya da tekrarlanan başarısız girişlerden sonra adresiniz kısa süreliğine engellendi. Geri çekilin ve rastgele gecikmeyle (jitter) yeniden deneyin. |
| 4 | Kullanıcı adı veya parola hatalı | Belirteç veya parola yanlış, döndürülmüş veya iptal edilmiş; parolasız bir kullanıcı adı erişim belirteci olarak okunur |
| 5 | Yetkisiz | Aşağıdaki tabloya bakın. Kesin neden cihazın Günlük sekmesinde bulunur. |
| CONNACK 5 nedeni | Çözüm |
|---|---|
| Cihaz devre dışı | Cihaz sayfasından etkinleştirin |
| Sertifika iptal edilmiş veya süresi dolmuş | Cihazın yenilemesine izin verin veya cihazı kurtarın. Bkz. Cihaz sertifikaları. |
| Profil bu giriş türüne izin vermiyor | Profilin Taşıma ve kimlik doğrulama sekmesindeki İzin verilen kimlik doğrulama |
| Cihazın adresi profilin İzin verilen ağları dışında | Ağı ekleyin veya sahanızın gerçekte hangi genel adresi kullandığını kontrol edin (NAT, mobil operatör) |
| Yalnızca TLS olan bir profilde düz MQTT | 8883 portunu kullanın |
| Kuruluş askıya alındı | Kuruluşun bir sahibine başvurun. Bkz. Kuruluşlar ve kiracılar. |
| Planın cihaz veya bağlı cihaz sınırına ulaşıldı | Bkz. Planlar ve IoT eklentisi |
HTTP üzerinden aynı kontroller 401 (eksik veya bilinmeyen belirteç), 403 (devre dışı, askıya alınmış, izin verilen ağların dışında veya profilin izin vermediği düz HTTP üzerinden komut yoklaması: tls_required) veya 404 (URL’de belirteç bulunmayan bir profilde URL’deki belirteç) ile yanıt verir. Bkz. Cihaz HTTP API’si.
Giriş hatırlatıcıları
| Kimlik bilgisi | İstemci kimliği | Kullanıcı adı | Parola |
|---|---|---|---|
| Erişim belirteci | geçerli herhangi bir kimlik | belirteç | boş |
| MQTT temel | herhangi biri veya sabitlenmiş olan | kullanıcı adı | parola |
| X.509 sertifikası | cihaz seri numarası, sertifikanın CN’siyle eşit | yok sayılır | boş |
Bir kimlik bilgisinin gizli anahtarı yalnızca oluşturulduğunda veya döndürüldüğünde bir kez gösterilir. Kaybedildiyse, döndürün ve cihazı güncelleyin. Bkz. Cihaz kimlik bilgileri.
Adım 3: Cihaz bağlanıyor, sonra kopuyor
Günlük sekmesi bağlantı kesilme nedenini belirtir:
| Neden | Anlamı | Çözüm |
|---|---|---|
keepalive_timeout | Keepalive süresi içinde hiçbir şey gelmedi | 30 ile 300 saniye arasında bir keepalive kullanın ve PINGREQ gönderin; mobil bağlantıyı kontrol edin |
takeover | Aynı cihazın ikinci bir bağlantısı devraldı | İki cihaz tek bir kimlik bilgisini paylaşıyor veya bir istemci eski soketi kapatmadan yeniden bağlanıyor. Her cihaza kendi kimlik bilgisini verin. |
auth_revoked | Kimlik bilgisine, cihaza veya kuruluşa artık izin verilmiyor | Oturumlar yaklaşık her 60 saniyede bir yeniden denetlenir; döndürülen bir kimlik bilgisi eski oturumu sonlandırır |
rate_limit | Cihaz hız sınırını tekrar tekrar aştı (bir dakika içinde dakikalık kotasının üç katından fazlası düşürüldü) | Okumaları toplu gönderin, daha seyrek gönderin veya profilin sınırlarını yükseltin |
inflight_exceeded | Çok fazla onaylanmamış QoS 1 iletisi var (varsayılan 20) | Daha fazla göndermeden önce PUBACK’leri bekleyin |
server_shutdown | Bir broker düğümü yeniden başlatıldı | Yeniden bağlanın; düzeltilecek bir şey yok |
uplink_window_expired | Son ileti çevrimiçi penceresi sona erdi | Yalnızca veri göndermek için bağlanan cihazlarda beklenen durum |
protocol_error, socket_error | İstemci protokolü bozdu veya ağ başarısız oldu | İstemciyi güncelleyin; bağlantıyı kontrol edin |
İki ağdan sürekli olarak oturumu devralınan bir cihaz bir süre geri tutulur ve yöneticileriniz bir “devralma kavgası” bildirimi alır.
Adım 4: Cihaz bağlanıyor ama çevrimdışı görünüyor
| Neden | Kontrol |
|---|---|
| Profilin çevrimiçi kuralı | “Çevrimiçi”nin ne anlama geldiğini Canlı bağlantı, Son ileti veya Yalnızca son görülme belirler. Bkz. Bağlantı durumu ve etkinlik. |
| Karantina | Karantinada bekleyen kendi kendine kaydolmuş bir cihaz bağlanır, ancak bir yönetici etkinleştirene kadar verisi onaylanır ve düşürülür. Bkz. Quarantine. |
| Cihaz bir ağ geçidinin alt cihazı | Durumu ağ geçidinin v1/gw/connect ve v1/gw/disconnect iletilerinden gelir. Bkz. Ağ geçidinin arkasındaki cihazlar. |
Yanlış yapılandırılmış bir cihaz diğerlerini kilitliyor
Tek bir adresten tekrarlanan başarısız girişler, o adresi kısa süreliğine engeller; bu, arkasındaki her cihaz için geçerlidir. Tek bir NAT veya mobil yönlendiricinin arkasındaki birkaç cihaz, bu nedenle hepsi CONNACK 3 (HTTP 429) ile reddedilir. Yanlış kimlik bilgisine sahip cihazı bulun (Günlük sekmesi başarısızlıkları gösterir), düzeltin ve diğerlerinin geri çekilerek yeniden denemesine izin verin.
Önerilen cihaz davranışı
- Ana makine adıyla TLS üzerinden, 30 ile 300 saniye arasında bir keepalive ile bağlanın.
- CONNACK 0 sonrasında, alt bağlantı konularına abone olun, paylaşılan öznitelikleri isteyin, istemci özniteliklerini bildirin, ardından arabelleğe alınmış okumaları gönderin.
- Reddedildiğinde geri çekilin: CONNACK 3’ü rastgele gecikmeyle (jitter) yeniden deneyin; CONNACK 4’ten sonra en az 5 dakika bekleyin; yapılandırma değişene kadar CONNACK 1 ve 2’de yeniden denemeyi durdurun.
Bkz. MQTT.