Das Token eines Gateways ist seine einzige Zugangsdaten. Diese Seite erklärt, wie Sie es ersetzen, wie Sie ein Gateway vorübergehend oder dauerhaft stoppen und was jeweils mit der Verbindung geschieht. Alle Aktionen finden Sie auf dem Tab LoRaWAN des Gateways (für einen lizenzierten Router: die Seitenleiste LoRaWAN-Gateway) und sie erfordern die Berechtigung zur Verwaltung von Gateways. Jede davon fragt zuerst nach einer Bestätigung und wird im Audit-Log protokolliert.
So funktioniert das Token
- Hermetry erzeugt beim Hinzufügen eines Basics-Station-Gateways ein zufälliges Token und zeigt es nur einmal an.
- Gespeichert wird nur ein Fingerabdruck (SHA-256) des Tokens. Niemand, auch nicht das Hermetry-Personal, kann das Token wieder auslesen.
- Das Gateway sendet das Token bei jeder Verbindung im Header
Authorization: Bearer. - Das Token ist an die EUI des Gateways gebunden. Dasselbe Token an einem anderen Gateway wird abgelehnt (
eui_mismatch).
Lizenzierte Router haben kein Token; sie verwenden stattdessen ihr Gerätezertifikat.
Token rotieren
Rotieren Sie das Token, wenn Sie es verloren haben, wenn eine Person, die es nicht haben sollte, es möglicherweise gesehen hat, oder wenn Sie ein Gateway an einen neuen Installateur übergeben.
- Öffnen Sie den Tab LoRaWAN des Gateways.
- Wählen Sie Token rotieren.
- Bestätigen Sie Token rotieren: „Das Gateway wird sofort getrennt und bleibt getrennt, bis Sie ihm das neue Token geben.“
- Der Tab zeigt den neuen Token-Header sowie die Download-Schaltflächen für
tc.uri,tc.trustundtc.key. Kopieren Sie diese jetzt: Sie werden nur einmal angezeigt. - Hinterlegen Sie das neue Token im Gateway und starten Sie dessen Packet Forwarder neu. Siehe Basics-Station-Gateway verbinden.
Was passiert:
| Zeitpunkt | Wirkung |
|---|---|
| Sie bestätigen | Das alte Token funktioniert sofort nicht mehr. Die offene Verbindung des Gateways wird geschlossen. |
| Bis Sie das Gateway aktualisieren | Das Gateway versucht, sich mit dem alten Token neu zu verbinden, und wird abgelehnt. Geräte, die nur von diesem Gateway empfangen werden, erreichen Hermetry nicht. |
| Sie hinterlegen das neue Token | Das Gateway verbindet sich wieder. |
Sobald das neue Token nicht mehr angezeigt wird, steht im Einrichtungsbereich: Das Token wurde beim Hinzufügen des Gateways einmalig angezeigt. Rotieren Sie das Token, um ein neues zu erhalten; das Gateway bleibt getrennt, bis es das neue Token hat.
Deaktivieren und aktivieren
Deaktivieren ist ein vorübergehender Stopp, etwa während ein Gateway umgesetzt wird oder wenn Sie einen Missbrauch vermuten.
- Wählen Sie Deaktivieren.
- Bestätigen Sie Gateway deaktivieren: „Das Gateway wird getrennt und abgewiesen, bis Sie es wieder aktivieren. Geräte, die nur es empfängt, erreichen die Plattform nicht mehr.“
Der Status des Gateways wird zu Deaktiviert und seine Verbindung wird sofort geschlossen. Token, EUI, Gerät und Verlauf bleiben erhalten.
Zum Rückgängigmachen wählen Sie Aktivieren und bestätigen: „Das Gateway darf sich mit seinem Token wieder verbinden.“ Das Gateway verbindet sich mit dem bereits vorhandenen Token selbstständig neu.
Entfernen
Entfernen löscht das Gateway endgültig.
- Wählen Sie Entfernen.
- Bestätigen Sie Gateway entfernen.
| Gateway-Typ | Was entfernt wird | Was erhalten bleibt |
|---|---|---|
| Basics-Station-Gateway | Der Gateway-Datensatz, sein Token, sein EUI-Anspruch und sein Gerät. Die Verbindung wird geschlossen. | Die gespeicherten Messwerte. |
| Lizenzierter Router | Der Gateway-Datensatz des Routers und sein EUI-Anspruch. Die LoRaWAN-Verbindung wird geschlossen. | Das Gerät des Routers und seine Messwerte. |
Nach dem Entfernen ist die EUI wieder frei: Sie oder eine andere Organisation können sie erneut registrieren.
Hinweis
Ein Gateway kann nicht über die allgemeine Gerätelöschung auf der Seite Geräte gelöscht werden. Hermetry meldet, dass das Gerät noch einen LoRaWAN-Datensatz hat. Verwenden Sie stattdessen Entfernen auf dem Tab LoRaWAN, das zuerst die LoRaWAN-Teile entfernt.
Wie schnell ein Gateway abgeschaltet wird
Eine Rotation, Deaktivierung oder Entfernung schließt die Verbindung des Gateways sofort. Sollte dieses Signal verzögert ankommen, wird außerdem jede offene Gateway-Verbindung alle 60 Sekunden gegen das Gateway-Register geprüft, sodass ein widerrufenes Gateway spätestens innerhalb einer Minute getrennt wird.
Über die API
| Aktion | Anfrage |
|---|---|
| Token rotieren | POST /tenant/<tenantId>/api/iot/lorawan/gateways/<gatewayId>/credentials gibt einmalig { gateway, token, stationConfig } zurück. |
| Deaktivieren | PATCH …/gateways/<gatewayId> mit { "status": "DISABLED" } |
| Aktivieren | PATCH …/gateways/<gatewayId> mit { "status": "ACTIVE" } |
| Umbenennen | PATCH …/gateways/<gatewayId> mit { "name": "…" } |
| Entfernen | DELETE …/gateways/<gatewayId> |
Die EUI und das Protokoll eines Gateways ändern sich nie. Ein Basics-Station-Gateway bleibt immer im Cloud-Modus; eine andere Betriebsart wird mit Ein Basics-Station-Gateway läuft immer im Cloud-Modus. abgelehnt. Die Rotation des Tokens eines Gateways ohne Token (ein lizenzierter Router) wird mit Dieses Gateway verwendet kein Token. (no_token_auth) abgelehnt.
Audit-Log-Einträge
| Aktion | Audit-Eintrag |
|---|---|
| Gateway hinzugefügt | iot_lorawan.gateway.created |
| Umbenannt, deaktiviert, aktiviert, auf der Karte verschoben | iot_lorawan.gateway.updated |
| Token rotiert | iot_lorawan.gateway.credential_rotated |
| Entfernt | iot_lorawan.gateway.deleted |