Neu: Die KI-Firewall überwacht die gesamte Plattform und erklärt jeden Vorfall in einfachen Worten. So funktioniert es

Ein Gerät verbindet sich nicht

Warum sich ein Gerät nicht verbinden kann oder die Verbindung immer wieder trennt – Host und TLS, Anmeldedaten, Profilregeln, erlaubte Netzwerke, CONNACK-Codes, gesperrte Adressen.

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

OrtZeigt
Der Reiter Log des GerätsJede 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ätsDer Broker-Host und die Ports, die Ihr Gerät verwenden muss
Das eigene Log des ClientsDer empfangene CONNACK-Code oder HTTP-Status bzw. der TLS-Fehler

Schritt 1: Kann das Gerät den Broker erreichen?

Symptom am GerätUrsacheLösung
DNS-Auflösung schlägt fehl oder die Verbindung läuft in ein TimeoutFalscher Host, oder eine Firewall blockiert den ausgehenden PortVerwenden 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 fehlDas 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 erscheintMit dem Host-Namen verbinden; den CA-Speicher des Systems verwenden; Uhrzeit setzen (NTP)
TLS schlägt auf einem sehr kleinen Gerät fehlEs unterstützt nur alte Cipher-Suites oder TLS 1.0/1.1TLS 1.2 ist das Minimum, mit ECDHE- und GCM- bzw. ChaCha20-Suites. Aktualisieren Sie die TLS-Bibliothek.
Port 1883 wird abgewiesenDas Profil ist nur TLS (Port 8883), der StandardVerwenden Sie 8883 oder erlauben Sie – nur in einem privaten Netzwerk – einfaches MQTT im Profil
Ein Client-Zertifikat wird während des Handshakes abgelehntDas Zertifikat stammt nicht von der Geräte-CA von Hermetry, oder es wurde widerrufenEin 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:

CONNACKBedeutungÜbliche Ursachen
1Protokollversion nicht unterstütztDer Client sendet MQTT 5. Hermetry spricht MQTT 3.1.1.
2Client-ID abgelehntDie Client-ID ist leer, länger als 64 Zeichen oder enthält Zeichen außerhalb von A–Z a–z 0–9 . _ : -
3Server nicht verfügbarDer 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.
4Falscher Benutzername oder PasswortDas Token oder Passwort ist falsch, wurde rotiert oder widerrufen; ein Benutzername ohne Passwort wird als Zugriffstoken gelesen
5Nicht autorisiertSiehe die Tabelle unten. Der genaue Grund steht im Reiter Log des Geräts.
Grund hinter CONNACK 5Lösung
Das Gerät ist deaktiviertAktivieren Sie es auf der Geräteseite
Das Zertifikat ist widerrufen oder abgelaufenLassen Sie das Gerät erneuern oder stellen Sie es wieder her. Siehe Device certificates.
Das Profil erlaubt diesen Anmeldetyp nichtAllowed authentication im Reiter Transport & auth des Profils
Die Adresse des Geräts liegt außerhalb der Allowed networks des ProfilsFü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 TLSVerwenden Sie Port 8883
Die Organisation ist gesperrtWenden Sie sich an einen Inhaber der Organisation. Siehe Organisations and tenants.
Das Geräte- oder Verbundgeräte-Limit des Tarifs ist erreichtSiehe 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

AnmeldedatenClient-IDBenutzernamePasswort
Zugriffstokenbeliebige gültige IDdas Tokenleer
MQTT basicbeliebig, oder die fixierteder Benutzernamedas Passwort
X.509-Zertifikatdie Geräteseriennummer, gleich dem CN des Zertifikatsignoriertleer

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:

GrundBedeutungLösung
keepalive_timeoutInnerhalb der Keepalive-Zeit ist nichts eingegangenVerwenden Sie ein Keepalive von 30 bis 300 Sekunden und senden Sie PINGREQ; prüfen Sie die Mobilfunkverbindung
takeoverEine zweite Verbindung desselben Geräts hat die Sitzung übernommenZwei 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_revokedDie Anmeldedaten, das Gerät oder die Organisation sind nicht mehr erlaubtSitzungen werden etwa alle 60 Sekunden erneut geprüft; rotierte Anmeldedaten beenden die alte Sitzung
rate_limitDas 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_exceededZu viele unbestätigte QoS-1-Nachrichten (standardmäßig 20)Warten Sie auf PUBACKs, bevor Sie weitere senden
server_shutdownEin Broker-Knoten wurde neu gestartetNeu verbinden; es gibt nichts zu beheben
uplink_window_expiredDas Online-Fenster Recent message ist abgelaufenErwartet bei Geräten, die nur zum Senden eine Verbindung herstellen
protocol_error, socket_errorDer Client hat das Protokoll verletzt, oder das Netzwerk ist ausgefallenAktualisieren 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

UrsachePrüfung
Die Online-Regel des ProfilsLive connection, Recent message oder Last seen only legen fest, was „online“ bedeutet. Siehe Connection status and activity.
QuarantäneEin 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-KindSein 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

  1. Verbinden Sie sich über TLS mit dem Host-Namen, mit einem Keepalive zwischen 30 und 300 Sekunden.
  2. Nach CONNACK 0 abonnieren Sie die Downlink-Topics, fragen gemeinsame Attribute ab, melden Client-Attribute und senden dann gepufferte Messwerte.
  3. 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.

Verwandte Themen