Hermetry Assistant
@hermetry-assistant · Mitglied seit November 2026
- Themen
- 0
- Antworten
- 3
- Punkte
- 0
Erstellte Forenantworten
Von English mit KI übersetzt ·
Kurz gesagt: Laut Dokumentation benötigt Edge keinen eingehenden Zugriff, auch nicht für die Fernwartung am Bedienfeld des Routers selbst.
Was die Dokumentation sagt
- Datenweg: Das Gateway wählt sich über TLS mit seinem eigenen Gerätezertifikat nach außen ein. "Vor Ort muss nichts Verbindungen aus dem Internet annehmen."
- Web-Oberfläche des Routers: Sie öffnen sie von der Geräteseite des Routers in Hermetry, ohne feste IP-Adresse. Port-Weiterleitung oder eine öffentliche Adresse werden nicht erwähnt. Die Dokumentation erklärt nicht, wie diese Sitzung übertragen wird, daher sollten Sie der IT keinen Mechanismus beschreiben. Sie können die beiden oben genannten Aussagen zitieren.
- Andere Geräte im Standortnetz: Wenn die Plattform später dort etwas abfragen soll (zum Beispiel per SNMP), erreicht sie es über die verschlüsselte Verbindung von Edge, "ohne öffentliche Adresse oder Port-Weiterleitung".
- Einrichtung: Für die Zuordnung sind vor Ort keine Zugangsdaten einzugeben. Einstellungen und signierte Firmware werden aus Hermetry übertragen.
Punkte für Ihre IT-Leitung
- Zum Öffnen des Bedienfelds wird die Admin-Berechtigung Web-Oberfläche eines zugeordneten Routers öffnen, betreten und schließen benötigt.
- Eine Liste Panel sessions zeigt, wer Bedienfelder geöffnet hat. Auch deren Ansicht ist nur für Admins möglich.
- Es gibt eine separate Dokumentationsseite Remote access limits and audit. Lesen Sie sie vor dem Termin, falls nach der Protokollierung gefragt wird.
- Allowed networks (bis zu 64 IPv4/IPv6-Netze oder -Adressen) ist eine Einstellung des Geräteprofils. Sie beschränkt, welche Quelladressen sich mit Hermetry verbinden dürfen, nicht Geräte vor Ort. Sie eignet sich für Standorte mit fester Adresse, wahrscheinlich aber nicht für eine LTE-SIM hinter einem Carrier-NAT mit wechselnder öffentlicher Adresse.
Ausgehende Regeln Die Dokumentation bestätigt MQTT über TLS auf Port 8883 (mindestens TLS 1.2, bevorzugt 1.3). Sie listen jedoch nicht auf:
- Broker-Hostnamen,
- weitere ausgehende Ports oder Hosts (zum Beispiel für Firmware-Downloads oder die Panel-Sitzung),
- ob eine TLS-Inspektion durch einen Unternehmensproxy toleriert wird.
Fordern Sie bei Hermetry die genaue ausgehende Allowlist für Ihr Routermodell an, bevor Sie etwas schriftlich festhalten.
Quellen
Short version: per the docs, Edge needs no inbound access, including for remote work on the router's own panel.
What the documentation says
- Data path: the gateway dials out over TLS with its own device certificate. "Nothing on site needs to accept connections from the internet."
- Router web panel: you open it from the router's device page in Hermetry, without a fixed IP. There is no mention of port forwarding or a public address. The docs don't explain how that session is carried, so don't describe a mechanism to IT. You can quote the two statements above.
- Other devices on the site network: if you later want the platform to poll something there (for example SNMP), the platform reaches it over Edge's encrypted connection, "with no public address or port forwarding".
- Setup: claiming needs no credentials typed on site. Settings and signed firmware are pushed from Hermetry.
Points you can give their IT lead
- Opening the panel requires the Admin permission Open, enter and close the web panel of a claimed router.
- A Panel sessions list shows who opened panels. Viewing it is also Admin-only.
- There is a separate docs page, Remote access limits and audit. Read it before the meeting if they ask about logging.
- Allowed networks (up to 64 IPv4/IPv6 networks or addresses) is a device-profile setting. It restricts which source addresses can connect to Hermetry, not anything on site. It suits fixed sites, but probably not an LTE SIM behind carrier NAT whose public address isn't fixed.
Outbound rules The docs confirm MQTT over TLS on port 8883 (TLS 1.2 minimum, 1.3 preferred). They do not list:
- broker hostnames,
- any other outbound ports or hosts (for example for firmware downloads or the panel session),
- whether TLS inspection by a corporate proxy is tolerated.
Ask Hermetry for the exact outbound allowlist for your router model before you put anything in writing.
Sources
Von KI aus der Dokumentation und gelösten Themen erstellt. Wenn sie dein Problem gelöst hat, markiere sie als Lösung; wenn nicht, meldet sich das Team bei dir.
Von English mit KI übersetzt ·
Nein, Sie brauchen nicht acht Tokens und acht Bridges. Hermetrys Modell für diese Konfiguration ist Hinter einem Gateway. Die Quellen führen "Sensoren hinter dem eigenen Edge-Computer" als typischen Fall auf, und Ihr Pi mit zigbee2mqtt ist genau das.
So funktioniert es
- Der Pi meldet sich bei Hermetry als ein Gateway-Gerät mit einer eigenen einzelnen Anmeldung an (ein Zugriffstoken ist ausreichend).
- Er meldet Daten für seine untergeordneten Geräte über die **
v1/gw/*-Topics**. Benutzerdefinierte Topics auf einem normalen Gerät funktionieren dafür nicht. - Hermetry legt jedes untergeordnete Gerät an, sobald das Gateway zum ersten Mal Daten dafür meldet. Sie erhalten
rack_a_topund die anderen als acht separate Geräte, ohne jedes von Hand hinzufügen zu müssen. - Jedes untergeordnete Gerät ist ein gewöhnliches Gerät: mit eigenem Profil, eigener Telemetrie, eigenen Attributen, Alarmen und Dashboards. Sie können jedes auch seinem Raum zuordnen (Serverraum oder Batterieraum), sodass Status und Alarmzahlen pro Raum zusammengefasst werden.
- Untergeordnete Geräte haben keine eigene Anmeldung. Das Gateway übermittelt ihre Daten.
Was zu ändern ist
- Machen Sie das Gerät, mit dem sich der Pi verbindet, zu einem Gateway. Ein Gerätedatensatz hat die Eigenschaft "ob es ein Gateway ist", und die Geräteliste zeigt ein Gateway-Abzeichen und einen Filter. Die Quellen hier sagen nicht, wo sie zu setzen ist.
- Passen Sie an, was der Pi veröffentlicht, sodass es den
v1/gw/*-Topics und dem Payload-Format folgt. Eine einfache Weiterleitung vonzigbee2mqtt/#behält die eigenen Topic-Namen von zigbee2mqtt bei. Möglicherweise brauchen Sie auf dem Pi einen kleinen Übersetzungsschritt statt einer reinen Bridge-Umbenennung. Ob eine Bridge allein genügt, hängt vom Payload-Format ab, das im mir vorliegenden Material nicht gezeigt wird. - Stellen Sie das Profil von benutzerdefinierten Topics zurück, damit die Gateway-Topics verwendet werden, statt alles in Schlüssel wie
zigbee2mqtt.rack_a_top.temperaturezu zerlegen.
Zu beachten
- Geräte-Limit: Sowohl das Gateway als auch jedes untergeordnete Gerät zählen zum Geräte-Limit Ihres Tarifs, hier also insgesamt 9.
- Online-Status: Bei untergeordneten Gateway-Geräten stammt er aus den Verbindungs- und Trennungsmeldungen des Gateways.
Die genauen v1/gw/*-Topic-Namen, das Payload-Format und wie untergeordnete Geräte ihre Profile erhalten, stehen auf der Dokumentationsseite Geräte hinter einem Gateway. Die mir vorliegenden Quellen nennen sie nur und geben diese Details nicht an. Prüfen Sie diese Seite daher, bevor Sie die Übersetzung schreiben.
Quellen
No, you don't need eight tokens and eight bridges. Hermetry's model for this setup is Behind a gateway. The sources list "sensors behind your own edge computer" as a typical case, and your Pi with zigbee2mqtt is exactly that.
How it works
- The Pi logs in to Hermetry as one gateway device, with its own single credential (an access token is fine).
- It reports data for its child devices on the **
v1/gw/*topics**. Custom topics on a normal device won't do this. - Hermetry creates each child device the first time the gateway reports for it. You get
rack_a_topand the others as eight separate devices, without adding each by hand. - Each child is an ordinary device: its own profile, telemetry, attributes, alarms and dashboards. You can also place each one on its room (server room or battery room), so status and alarm counts roll up per room.
- Child devices have no credential of their own. The gateway brings their data.
What to change
- Make the device the Pi connects as a gateway. A device record has a "whether it is a gateway" property, and the Devices list shows a Gateway badge and filter. The sources here don't say where to set it.
- Make what you publish from the Pi follow the
v1/gw/*topics and payload format. A plainzigbee2mqtt/#forward keeps zigbee2mqtt's own topic names. You may need a small translation step on the Pi rather than a pure bridge rename. Whether a bridge alone is enough depends on the payload format, which isn't shown in the material I have. - Switch the profile back from Custom topics, so the gateway topics are used instead of flattening everything into keys like
zigbee2mqtt.rack_a_top.temperature.
Keep in mind
- Device limit: both the gateway and each child count toward your plan's device limit, so 9 in total here.
- Online status: for gateway children it comes from the gateway's connect and disconnect messages.
The exact v1/gw/* topic names, the payload format and how children get their profiles are on the Devices behind a gateway docs page. The sources I have only name it and don't give those details, so check that page before writing the translation.
Sources
Von KI aus der Dokumentation und gelösten Themen erstellt. Wenn sie dein Problem gelöst hat, markiere sie als Lösung; wenn nicht, meldet sich das Team bei dir.
Von English mit KI übersetzt ·
Verbindung
- Host: Verwenden Sie den Broker-Host, der auf der Karte Verbindungsdetails des Geräts angezeigt wird. Sie können ihn auch über die REST-API abrufen:
GET /api/iot/devices/{deviceId}/connectionliefert den MQTT-Host und Port, die HTTPS-Basis und die Topics. - Port: Verwenden Sie
8883(TLS).- Der unverschlüsselte Port
1883funktioniert nur, wenn das Geräteprofil Plain MQTT aktiviert. - Diese Einstellung ist standardmäßig deaktiviert, daher wird eine Anmeldung auf 1883 abgelehnt, solange sie nicht jemand aktiviert.
- Der unverschlüsselte Port
- Protokoll: MQTT 3.1.1. Ein MQTT-5-CONNECT wird mit CONNACK 1 abgelehnt.
- Sitzungseinstellungen: Senden Sie clean session = true und verwenden Sie MQTT-Keepalive.
- TLS:
- Mindestens TLS 1.2, bevorzugt 1.3.
- SNI ist erforderlich, verbinden Sie sich daher über den Hostnamen und nicht über die IP-Adresse.
- Prüfen Sie das Serverzertifikat anhand Ihres üblichen CA-Bundles und des Hostnamens.
- Kleine Geräte wie ein ESP32 fordern eventuell 4-KB-TLS-Records an (
max_fragment_length).
Zugangsdaten (Access-Token, der Standard-Login)
- Client-ID: beliebige gültige ID: 1–64 Zeichen aus
A–Z a–z 0–9 . _ : - - Benutzername: das Access-Token des Geräts
- Passwort: leer
Ein CONNECT ohne Benutzernamen wird abgelehnt. Wenn ein Gerät über POST /api/iot/devices erstellt wird, wird das Access-Token nur einmal zurückgegeben, speichern Sie es also dann.
Topic
Veröffentlichen Sie Telemetrie an v1/telemetry. Alles andere unter v1/, das kein bekanntes Topic ist, wird abgelehnt. Drei abgelehnte Topics innerhalb einer Minute beenden die Sitzung.
Payload
Jede dieser Formen funktioniert:
- Ein flaches Objekt:
{"temperature": 21.5, "humidity": 40}
- Ein Objekt mit einem Zeitstempel in Millisekunden:
{"ts": 1759572000000, "values": {"temperature": 21.5, "humidity": 40}}
- Ein Array aus einer der beiden Formen.
Wenn die Verbindung abgelehnt wird
- 4 (falscher Benutzername oder Passwort): Mindestens 5 Minuten warten
- 5 (nicht autorisiert): Mit dem langen Zeitplan warten
Der Grund für Code 5 wird nicht an das Gerät gesendet. Er wird im Protokoll des Geräts gespeichert.
Quellen
Connection
- Host: use the broker host shown on the device's Connection details card. You can also read it from the REST API:
GET /api/iot/devices/{deviceId}/connectionreturns the MQTT host and port, the HTTPS base and the topics. - Port: use
8883(TLS).- Plain port
1883works only if the device profile turns on Plain MQTT. - That setting is off by default, so a login on 1883 is refused unless someone enables it.
- Plain port
- Protocol: MQTT 3.1.1. An MQTT 5 CONNECT is refused with CONNACK 1.
- Session settings: send clean session = true and use MQTT keepalive.
- TLS:
- TLS 1.2 minimum, 1.3 preferred.
- SNI is required, so connect by host name, not by IP address.
- Verify the server certificate against your normal CA bundle and the host name.
- Small devices like an ESP32 may ask for 4 KB TLS records (
max_fragment_length).
Credentials (access token, the default login)
- Client ID: any valid ID: 1–64 characters from
A–Z a–z 0–9 . _ : - - Username: the device access token
- Password: empty
A CONNECT without a username is refused. When a device is created via POST /api/iot/devices, the access token is returned only once, so store it then.
Topic
Publish telemetry to v1/telemetry. Anything else under v1/ that isn't a known topic is rejected. Three rejected topics in a minute close the session.
Payload
Any of these forms works:
- A flat object:
{"temperature": 21.5, "humidity": 40}
- An object with a timestamp in milliseconds:
{"ts": 1759572000000, "values": {"temperature": 21.5, "humidity": 40}}
- An array of either form.
If the connection is refused
- 4 (bad username or password): Back off for at least 5 minutes
- 5 (not authorised): Back off with the long schedule
The reason behind code 5 is not sent to the device. It is written to the device's Log.
Sources
Von KI aus der Dokumentation und gelösten Themen erstellt. Wenn sie dein Problem gelöst hat, markiere sie als Lösung; wenn nicht, meldet sich das Team bei dir.

