Diese Seite hilft, wenn sich ein Gerät nicht mit Hermetry verbinden kann, bei der Anmeldung abgewiesen wird oder seine Verbindung immer wieder verliert. Sie behandelt MQTT und die HTTP-API für Geräte. Für LoRaWAN-Geräte siehe Troubleshooting joins; für abgefragte (polled) Geräte siehe Polling intervals, back-off and quota.
Wo Sie zuerst nachsehen
| Ort | Zeigt |
|---|---|
| Der Reiter Log des Geräts | Jede Anmeldeabweisung mit ihrem Grund und jede Trennung mit ihrem Grund. Der Grund einer Abweisung wird nie an das Gerät gesendet: Er steht nur hier. |
| Die Karte Connection details des Geräts | Der Broker-Host und die Ports, die Ihr Gerät verwenden muss |
| Das eigene Log des Clients | Der empfangene CONNACK-Code oder HTTP-Status bzw. der TLS-Fehler |
Schritt 1: Kann das Gerät den Broker erreichen?
| Symptom am Gerät | Ursache | Lösung |
|---|---|---|
| DNS-Auflösung schlägt fehl oder die Verbindung läuft in ein Timeout | Falscher Host, oder eine Firewall blockiert den ausgehenden Port | Verwenden Sie den Host auf der Karte Connection details für die Region Ihrer Organisation. Erlauben Sie ausgehendes TCP 8883 (und 443 für HTTPS). |
| Der TLS-Handshake schlägt fehl | Das Gerät verbindet sich über eine IP-Adresse (SNI ist erforderlich), hat kein CA-Bundle, oder seine Uhr geht stark falsch, sodass das Zertifikat ungültig erscheint | Mit dem Host-Namen verbinden; den CA-Speicher des Systems verwenden; Uhrzeit setzen (NTP) |
| TLS schlägt auf einem sehr kleinen Gerät fehl | Es unterstützt nur alte Cipher-Suites oder TLS 1.0/1.1 | TLS 1.2 ist das Minimum, mit ECDHE- und GCM- bzw. ChaCha20-Suites. Aktualisieren Sie die TLS-Bibliothek. |
| Port 1883 wird abgewiesen | Das Profil ist nur TLS (Port 8883), der Standard | Verwenden Sie 8883 oder erlauben Sie – nur in einem privaten Netzwerk – einfaches MQTT im Profil |
| Ein Client-Zertifikat wird während des Handshakes abgelehnt | Das Zertifikat stammt nicht von der Geräte-CA von Hermetry, oder es wurde widerrufen | Ein nicht vertrauenswürdiges Zertifikat beendet den Handshake; es gibt keinen Rückfall auf ein Passwort. Siehe Device certificates. |
Siehe Device transport security.
Schritt 2: Wird die Anmeldung akzeptiert?
MQTT beantwortet das CONNECT mit einem CONNACK-Code:
| CONNACK | Bedeutung | Übliche Ursachen |
|---|---|---|
| 1 | Protokollversion nicht unterstützt | Der Client sendet MQTT 5. Hermetry spricht MQTT 3.1.1. |
| 2 | Client-ID abgelehnt | Die Client-ID ist leer, länger als 64 Zeichen oder enthält Zeichen außerhalb von A–Z a–z 0–9 . _ : - |
| 3 | Server nicht verfügbar | Der Dienst startet gerade oder ist ausgelastet, oder Ihre Adresse ist nach wiederholten fehlgeschlagenen Anmeldungen kurzzeitig gesperrt. Warten Sie ab und versuchen Sie es mit Zufallsverzögerung (Jitter) erneut. |
| 4 | Falscher Benutzername oder Passwort | Das Token oder Passwort ist falsch, wurde rotiert oder widerrufen; ein Benutzername ohne Passwort wird als Zugriffstoken gelesen |
| 5 | Nicht autorisiert | Siehe die Tabelle unten. Der genaue Grund steht im Reiter Log des Geräts. |
| Grund hinter CONNACK 5 | Lösung |
|---|---|
| Das Gerät ist deaktiviert | Aktivieren Sie es auf der Geräteseite |
| Das Zertifikat ist widerrufen oder abgelaufen | Lassen Sie das Gerät erneuern oder stellen Sie es wieder her. Siehe Device certificates. |
| Das Profil erlaubt diesen Anmeldetyp nicht | Allowed authentication im Reiter Transport & auth des Profils |
| Die Adresse des Geräts liegt außerhalb der Allowed networks des Profils | Fügen Sie das Netzwerk hinzu oder prüfen Sie, welche öffentliche Adresse Ihr Standort tatsächlich verwendet (NAT, Mobilfunkanbieter) |
| Einfaches MQTT auf einem Profil nur für TLS | Verwenden Sie Port 8883 |
| Die Organisation ist gesperrt | Wenden Sie sich an einen Inhaber der Organisation. Siehe Organisations and tenants. |
| Das Geräte- oder Verbundgeräte-Limit des Tarifs ist erreicht | Siehe Plans and the IoT add-on |
Über HTTP liefern dieselben Prüfungen 401 (Token fehlt oder ist unbekannt), 403 (deaktiviert, gesperrt, außerhalb der erlaubten Netzwerke, oder eine Befehlsabfrage über einfaches HTTP, das das Profil nicht erlaubt: tls_required) oder 404 (ein Token in der URL bei einem Profil ohne Token in the URL). Siehe Device HTTP API.
Erinnerungen zur Anmeldung
| Anmeldedaten | Client-ID | Benutzername | Passwort |
|---|---|---|---|
| Zugriffstoken | beliebige gültige ID | das Token | leer |
| MQTT basic | beliebig, oder die fixierte | der Benutzername | das Passwort |
| X.509-Zertifikat | die Geräteseriennummer, gleich dem CN des Zertifikats | ignoriert | leer |
Das Geheimnis einer Anmeldedaten wird nur einmal angezeigt, wenn sie erstellt oder rotiert wird. Ging es verloren, rotieren Sie die Anmeldedaten und aktualisieren Sie das Gerät. Siehe Device credentials.
Schritt 3: Das Gerät verbindet sich und trennt dann die Verbindung
Der Reiter Log nennt den Trennungsgrund:
| Grund | Bedeutung | Lösung |
|---|---|---|
keepalive_timeout | Innerhalb der Keepalive-Zeit ist nichts eingegangen | Verwenden Sie ein Keepalive von 30 bis 300 Sekunden und senden Sie PINGREQ; prüfen Sie die Mobilfunkverbindung |
takeover | Eine zweite Verbindung desselben Geräts hat die Sitzung übernommen | Zwei Geräte teilen sich eine Anmeldedatensatz, oder ein Client verbindet sich neu, ohne den alten Socket zu schließen. Geben Sie jedem Gerät eigene Anmeldedaten. |
auth_revoked | Die Anmeldedaten, das Gerät oder die Organisation sind nicht mehr erlaubt | Sitzungen werden etwa alle 60 Sekunden erneut geprüft; rotierte Anmeldedaten beenden die alte Sitzung |
rate_limit | Das Gerät hat sein Ratenlimit wiederholt überschritten (mehr als das Dreifache seines Minutenkontingents innerhalb einer Minute verworfen) | Bündeln Sie Messwerte, senden Sie seltener oder erhöhen Sie die Limits des Profils |
inflight_exceeded | Zu viele unbestätigte QoS-1-Nachrichten (standardmäßig 20) | Warten Sie auf PUBACKs, bevor Sie weitere senden |
server_shutdown | Ein Broker-Knoten wurde neu gestartet | Neu verbinden; es gibt nichts zu beheben |
uplink_window_expired | Das Online-Fenster Recent message ist abgelaufen | Erwartet bei Geräten, die nur zum Senden eine Verbindung herstellen |
protocol_error, socket_error | Der Client hat das Protokoll verletzt, oder das Netzwerk ist ausgefallen | Aktualisieren Sie den Client; prüfen Sie die Verbindung |
Ein Gerät, dessen Sitzung immer wieder von zwei Netzwerken aus übernommen wird, wird für eine Weile zurückgehalten, und Ihre Administratoren erhalten eine Benachrichtigung über einen „takeover fight“.
Schritt 4: Das Gerät verbindet sich, wird aber als offline angezeigt
| Ursache | Prüfung |
|---|---|
| Die Online-Regel des Profils | Live connection, Recent message oder Last seen only legen fest, was „online“ bedeutet. Siehe Connection status and activity. |
| Quarantäne | Ein selbst registriertes Gerät, das in Quarantäne wartet, verbindet sich, aber seine Daten werden bestätigt und verworfen, bis ein Administrator es aktiviert. Siehe Quarantäne. |
| Das Gerät ist ein Gateway-Kind | Sein Status stammt aus den Nachrichten v1/gw/connect und v1/gw/disconnect des Gateways. Siehe Devices behind a gateway. |
Ein falsch konfiguriertes Gerät sperrt andere aus
Wiederholte fehlgeschlagene Anmeldungen von einer Adresse sperren diese Adresse kurzzeitig, für jedes Gerät dahinter. Mehrere Geräte hinter einem NAT oder Mobilfunkrouter werden dann alle mit CONNACK 3 (HTTP 429) abgewiesen. Finden Sie das Gerät mit falschen Anmeldedaten (sein Reiter Log zeigt die Fehlschläge), beheben Sie es, und lassen Sie die anderen mit Backoff erneut versuchen.
Empfohlenes Verhalten des Geräts
- Verbinden Sie sich über TLS mit dem Host-Namen, mit einem Keepalive zwischen 30 und 300 Sekunden.
- Nach CONNACK 0 abonnieren Sie die Downlink-Topics, fragen gemeinsame Attribute ab, melden Client-Attribute und senden dann gepufferte Messwerte.
- Bei einer Abweisung warten Sie ab: Wiederholen Sie CONNACK 3 mit Zufallsverzögerung (Jitter); warten Sie nach CONNACK 4 mindestens 5 Minuten; hören Sie bei CONNACK 1 und 2 mit dem Wiederholen auf, bis sich die Konfiguration ändert.
Siehe MQTT.

