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

MQTT

Geräte über MQTT 3.1.1 verbinden – Ports, TLS, Anmeldungen, Sitzungen, Bestätigungen, Grenzwerte, CONNACK-Codes und wie ein Gerät den Verbindungsversuch zurückfahren sollte.

Hermetry unterstützt MQTT 3.1.1. Diese Seite ist die Verbindungsreferenz für Geräteentwickler: wie man den Broker erreicht, wie man sich anmeldet, wie Sitzungen sich verhalten, was wann bestätigt wird und was zu tun ist, wenn eine Verbindung abgelehnt wird. Die Themen und Nutzdaten finden Sie in der Referenz zu MQTT-Themen und Nutzdaten.

Verbindung

ElementWert
ProtokollMQTT 3.1.1 (Protokollstufe 4). Ein CONNECT für MQTT 5 wird mit CONNACK 1 abgelehnt.
Port, TLS8883
Port, unverschlüsselt1883, nur für Geräte eines Profils, das unverschlüsseltes MQTT erlaubt
HostDer Broker-Host auf der Karte Verbindungsdetails des Geräts. Verwenden Sie den Host der Region Ihrer Organisation.
Clean SessionSenden Sie true. Ein CONNECT mit false wird als Clean Session bedient.
KeepaliveVerwenden Sie das MQTT-Keepalive. Ein Keepalive von 0 oder oberhalb des Maximums des Brokers (300 Sekunden bei einer Standardinstallation) wird mit dem Maximum bedient.
Will-NachrichtErlaubt, wird ignoriert. Hermetry bestimmt den Verbindungsstatus selbst.
Retain-FlagWird ignoriert. Die Nachricht wird verarbeitet, nicht gespeichert.
VerbindungszeitVon der TCP-Verbindung bis zu einem akzeptierten CONNECT (einschließlich TLS-Handshake und Anmeldung) hat das Gerät einige Sekunden (standardmäßig 5).

Für ein Gerät, das offline ist, wird nichts zwischengespeichert, außer Befehlen, die als persistent markiert sind. Nach jeder Verbindung abonniert das Gerät erneut und fragt seine gemeinsamen Attribute ab, wodurch es die aktuellen Werte erhält.

TLS

  • Mindestens TLS 1.2, TLS 1.3 wird bevorzugt.
  • TLS-1.2-Suites: ECDHE-ECDSA-AES128-GCM-SHA256, ECDHE-RSA-AES128-GCM-SHA256, ECDHE-ECDSA-CHACHA20-POLY1305. Kein RSA-Schlüsselaustausch, kein CBC.
  • SNI ist erforderlich. Verbinden Sie sich über den Host-Namen, nicht über die IP-Adresse.
  • Bei Geräten von Drittanbietern ist das Serverzertifikat ein öffentliches. Prüfen Sie es gegen Ihr übliches CA-Bundle und den Host-Namen.
  • Der Server fordert ein Client-Zertifikat an, verlangt aber keines, sodass ein Port alle Anmeldearten bedient.
  • Kleine Geräte können 4-KB-TLS-Records anfordern (max_fragment_length).

Ein Profil legt fest, ob seine Geräte den unverschlüsselten Port überhaupt nutzen dürfen (Plain MQTT auf dem Reiter Transport & Auth des Profils). Nur TLS ist der Standard. Siehe Transportsicherheit der Geräte.

Anmeldung

AnmeldedatenClient-IDBenutzernamePasswort
Zugriffstokenbeliebige gültige IDdas Zugriffstokenleer
MQTT basicbeliebig oder die fixierte Client-IDder Benutzernamedas Passwort
X.509-Zertifikatdie Gerätenummer (muss dem CN des Zertifikats entsprechen)die Seriennummer (wird ignoriert)leer
  • Eine Client-ID hat 1 bis 64 Zeichen aus A–Z a–z 0–9 . _ : -. Alles andere wird mit CONNACK 2 abgelehnt.
  • Ein CONNECT mit Benutzername, aber ohne Passwort, wird als Zugriffstoken gelesen. Ein CONNECT ohne Benutzername wird abgelehnt.
  • Wird ein Client-Zertifikat vorgelegt, entscheidet es. Es gibt keinen Rückfall auf ein Passwort. Ein nicht vertrauenswürdiges Zertifikat beendet den TLS-Handshake.
  • Der Benutzername provision öffnet eine Bereitstellungssitzung (siehe Geräte hinzufügen und beanspruchen).
  • Das Profil muss den Anmeldetyp, das Netzwerk des Geräts und den Port (TLS oder unverschlüsselt) erlauben; andernfalls wird die Anmeldung mit CONNACK 5 abgelehnt.

Sitzungen

  • Eine Sitzung pro Gerät. Eine zweite Verbindung desselben Geräts übernimmt die Sitzung und schließt die erste. Ein Gerät, dessen Sitzung wiederholt von zwei Netzwerken aus übernommen wird, wird eine Zeit lang zurückgehalten, und Ihre Administratoren erhalten eine Meldung („takeover fight“). Prüfen Sie, ob sich zwei Geräte einen Berechtigungsnachweis teilen.
  • Prüfungen. Jede aktive Sitzung wird etwa alle 60 Sekunden erneut geprüft. Ein rotierter oder widerrufener Berechtigungsnachweis, ein deaktiviertes oder gelöschtes Gerät, eine gesperrte Organisation oder eine Profiländerung, die die Sitzung nicht mehr erfüllt, beendet sie sofort.
  • Quarantined devices verbinden sich, aber ihre Telemetrie und Attribute werden quittiert und verworfen, bis ein Administrator sie aktiviert.
  • Hinweis zu neuem Netzwerk. Meldet sich ein Gerät aus einem anderen Netzwerk als beim letzten Mal an, erhalten Ihre Administratoren gegebenenfalls einen Hinweis (höchstens einmal pro Stunde und Gerät), damit ein gestohlener Berechtigungsnachweis nicht unbemerkt bleibt.
  • Grenze für verbundene Geräte. Begrenzt Ihr Tarif, wie viele Geräte gleichzeitig verbunden sein dürfen, wird ein CONNECT über dieser Grenze mit CONNACK 5 abgelehnt.

Bestätigungen und QoS

  • Veröffentlichen Sie mit QoS 1. QoS 0 wird akzeptiert; QoS 2 wird wie QoS 1 behandelt.
  • Hermetry sendet das PUBACK erst, wenn die Nachricht sicher eingereiht ist. PUBACKs werden in der Reihenfolge gesendet, in der das Gerät veröffentlicht hat.
  • Kann eine Nachricht nicht eingereiht werden, erhält sie kein PUBACK (ebenso wenig alles danach auf dieser Sitzung), und die Sitzung wird nach wenigen Sekunden geschlossen. Das Gerät sendet die unbestätigten Nachrichten nach dem erneuten Verbinden erneut.
  • Ein Gerät darf standardmäßig höchstens 20 unbestätigte QoS-1-Nachrichten gleichzeitig unterwegs haben (das Profil-Feld Max unacknowledged messages (MQTT), 1 bis 1.000).
  • Duplikate desselben Geräts, Schlüssels und Zeitstempels werden nur einmal gespeichert, daher ist erneutes Senden unbedenklich.

Grenzwerte

GrenzwertStandardWo er festgelegt wird
Telemetrienachrichten10:1,300:60 (10 pro Sekunde und 300 pro Minute)Profil Limits
Telemetrie-Datenpunkte200:1,6000:60Profil Limits
Attributnachrichten5:1,60:60Profil Limits
Nachrichtengröße64 KiB, bis zu 1.000 Schlüssel-Wert-PunkteProfil Max message payload (bytes)
Nachrichten an das Gerät64 KiB (4 KiB für lizenzierte Geräte)Profil Max downlink payload (bytes)
  • Bei Überschreitung eines Ratenlimits wird die Nachricht quittiert und verworfen. Ein Gerät, das sein Limit wiederholt überschreitet (mehr als das Dreifache seines Minutenkontingents wird innerhalb einer Minute verworfen), wird in seiner Sitzung geschlossen. Eigentümer und Administratoren erhalten pro Gerät und Stunde einen Hinweis.
  • Eine zu große Nachricht wird als Ganzes verworfen; die Verbindung bleibt bestehen.
  • Ihre Organisation insgesamt hat außerdem Ratenlimits aus ihrem Tarif.
  • Gepufferte Messwerte, die ein Gerät nach einem Ausfall sendet (jeder Datensatz trägt einen älteren ts), müssen ebenfalls in das Profil-Feld Replay messages per second passen.
  • Telemetrie- und Attributnachrichten zählen auf Ihr monatliches Nachrichtenkontingent; Verbindungsereignisse, Befehle und Alarme nicht. Siehe Nachrichtenkontingent und Nutzung.

CONNACK-Codes

CodeBedeutungWas das Gerät tun sollte
0AkzeptiertFortfahren.
1Protokollversion nicht unterstütztKeine Wiederholungen; Client korrigieren.
2Client-ID abgelehntAnhalten, bis sich die Konfiguration ändert.
3Server nicht verfügbar: Der Dienst ist ausgelastet, startet oder stoppt, oder die Adresse ist kurzzeitig gesperrtZurückweichen und mit Zufallsversatz (Jitter) wiederholen.
4Ungültiger Benutzername oder ungültiges PasswortMindestens 5 Minuten warten (bis zu 1 Stunde).
5Nicht autorisiert: Gerät deaktiviert, Zertifikat widerrufen oder abgelaufen, Organisation gesperrt oder über ihrem Geräte- oder Verbindungslimit, Anmeldetyp, Netzwerk oder Port vom Profil nicht erlaubtMit dem langen Zeitplan zurückweichen.

Der Grund zu Code 5 wird nie an das Gerät gesendet. Er wird im Reiter Log des Geräts vermerkt.

Hinweis

Wiederholte fehlgeschlagene Anmeldungen von einer Adresse sperren diese Adresse kurzzeitig, für jedes Gerät hinter ihr. Ein falsch konfiguriertes Gerät kann daher seine Nachbarn hinter demselben NAT aussperren. Korrigieren Sie falsche Zugangsdaten rasch.

Gründe für das Trennen

Der Reiter Log des Geräts zeigt, warum eine Sitzung beendet wurde:

GrundBedeutung
client_disconnectDas Gerät hat die Verbindung geschlossen.
keepalive_timeoutInnerhalb der Keepalive-Zeit kam nichts an.
takeoverEine andere Verbindung desselben Geräts hat die Sitzung übernommen.
auth_revokedDer Berechtigungsnachweis, das Gerät oder die Organisation ist nicht mehr zugelassen.
rate_limitDas Gerät hat sein Ratenlimit immer wieder überschritten.
server_shutdownDer Broker-Knoten wurde neu gestartet; neu verbinden.
protocol_error, inflight_exceeded, socket_errorDer Client hat das Protokoll verletzt, zu viele unbestätigte Nachrichten gesendet, oder das Netzwerk ist ausgefallen.

Empfohlenes Verhalten des Geräts

  1. Über TLS per Host-Namen verbinden, mit einem Keepalive zwischen 30 und 300 Sekunden.
  2. Nach CONNACK 0 auf die Downlink-Themen abonnieren, gemeinsame Attribute abfragen, Client-Attribute melden und dann gepufferte Telemetrie vor Live-Daten senden.
  3. QoS 1 verwenden und auf das PUBACK warten, bevor Sie einen gepufferten Messwert löschen.
  4. Messwerte bündeln, wenn Sie mehr als eine Probe pro Sekunde senden.
  5. Bei einer abgelehnten Verbindung dem Zurückweichen der CONNACK-Tabelle folgen; Zufallsversatz (Jitter) hinzufügen, damit sich eine Geräteflotte nicht gleichzeitig neu verbindet.

Verwandt