Diese Seite richtet sich an die Personen, die das Netzwerk und die Firewall an einem Standort betreiben, der Hermetry nutzt. Sie listet jede Verbindung auf, die Hermetry benötigt, welche Seite sie öffnet, den Port und wo die App den genauen Hostnamen anzeigt.
Die Regeln kurz gefasst
- Jede Verbindung von Ihrem Standort ist ausgehend. Browser, Geräte, LoRaWAN-Gateways und lizenzierte Router verbinden sich nach außen zu Hermetry. Nichts an Ihrem Standort muss Verbindungen aus dem Internet annehmen. Eine Ausnahme bildet ein Gerät, das Hermetry abfragt; siehe unten den Abschnitt zu Geräten, mit denen Hermetry sich verbindet.
- Schreiben Sie Regeln auf Hostnamen, nicht auf IP-Adressen. Hermetry veröffentlicht keine festen IP-Adressen für diese Hosts. Geräte müssen ohnehin über den Hostnamen verbinden, denn die TLS-Prüfung des Serverzertifikats benötigt den Namen.
- Verwenden Sie die Hosts der Region Ihrer Organisation. Jede Region ist eine eigenständige Bereitstellung mit eigenen Hostnamen. Ein Gerät oder Gateway verbindet sich mit den Hosts der Region, in der Ihre Organisation angesiedelt ist. Siehe Regions and data residency.
Wo Sie jeden Hostnamen finden
Sie müssen einen Hostnamen nicht raten. Die App zeigt jeden dort an, wo Sie ihn benötigen.
| Host | Was es ist | Wo die App es anzeigt |
|---|---|---|
| Adresse Ihrer Organisation | Die kostenlose Adresse <slug>.<platform domain> sowie jede eigene Domain, die Sie hinzugefügt haben | Domains im Bereich Organisation des Menüs. Siehe Web addresses and custom domains |
| Broker-Host | Der MQTT-Host, mit dem sich Ihre Geräte verbinden | Die Karte Connection details auf der Geräteseite |
| HTTPS-Geräteadresse | Die Basisadresse der HTTP-API für Geräte | Die Karte Connection details auf der Geräteseite |
| Adresse des Network Servers | Die sichere Websocket-Adresse, mit der sich Ihre LoRaWAN-Gateways verbinden, wss://<slug>.<network server host> | Der Reiter LoRaWAN des Gateways. Siehe Your network server address |
| Adresse für Firmware-Downloads | Ein kurzlebiger HTTPS-Link im Attribut fw_url des Geräts | Wird bei jedem Update an das Gerät gesendet. Siehe Firmware updates (OTA) |
Die Verbindungsdaten des Geräts sind auch über die API verfügbar: GET /api/iot/devices/{deviceId}/connection. Die Antwort enthält den Broker-Host, Port und TLS-Kennzeichen sowie die HTTPS-Basisadresse, und nichts Geheimes. Siehe Devices and profiles API.
Von Ihrem Standort freizugebende Ports
| Verbindung | Von | Nach | Protokoll und Port |
|---|---|---|---|
| Web-App und REST-API | Browser, Skripte und Integrationen | Adresse Ihrer Organisation und die eigene Anmeldeadresse der Plattform | HTTPS auf TCP 443 |
| Live-Aktualisierungen in der App | Browser | Dieselbe Adresse wie die App | Websocket über HTTPS auf TCP 443 |
| MQTT-Geräte | Geräte und Gateways | Der Broker-Host | MQTT 3.1.1 über TLS auf TCP 8883 |
| MQTT-Geräte ohne TLS | Geräte eines Profils, das einfaches MQTT erlaubt | Der Broker-Host | MQTT auf TCP 1883, nur wo die Installation den einfachen Listener betreibt |
| HTTPS-Geräte | Geräte | Die HTTPS-Geräteadresse, Pfade unter /api/v1/ | HTTPS auf TCP 443 |
| LoRaWAN-Gateways | Basics-Station-Gateways und lizenzierte Router mit LoRa-Funkmodul | Die Adresse des Network Servers | Sicherer Websocket (wss://): TCP 443, wenn die Adresse keinen Port zeigt, sonst der Port in der Adresse |
| Firmware-Downloads | Geräte | Der Host in fw_url, danach der Host des Dateispeichers, auf den weitergeleitet werden darf | HTTPS |
| Fernzugriff auf das Bedienfeld eines Routers | Lizenzierte Router | Die Tunneladresse der Plattform, die der Router beim Öffnen einer Sitzung erhält | TLS (sicherer Websocket) |
| Fernzugriff auf das Bedienfeld eines Routers | Browser Ihrer Mitglieder | Die Adresse des Bedienfelds, auf einer anderen Domain als Hermetry | HTTPS |
Einfaches HTTP auf TCP 80 leitet die App auf HTTPS weiter. Geräte verwenden Port 80 nur, wenn sie kein TLS können und die Installation für die Geräte-API einfaches HTTP anbietet.
Wichtig
Geräteprofile sind standardmäßig nur TLS (Port 8883). Ein Gerät, das sich auf Port 1883 anmeldet, wird abgewiesen, sofern sein Profil kein einfaches MQTT erlaubt. Halten Sie Port 1883 geschlossen, solange Sie kein solches Profil haben. Siehe Device transport security.
Hinweise zu jeder Verbindung
- Broker-Host. Die Karte kann die eigene Adresse Ihrer Organisation oder den Broker-Host der Region zeigen. Kopieren Sie ihn genau wie angezeigt und lassen Sie das Gerät das Serverzertifikat anhand des Hostnamens prüfen. Siehe MQTT.
- HTTPS-Geräteadresse. Die Geräte-API antwortet unter
/api/v1/der Adresse auf der Karte. Siehe Device HTTP API. - Adresse des Network Servers. Alle Gateways Ihrer Organisation verwenden dieselbe Adresse. Sie folgt dem Namen der Web-Adresse Ihrer Organisation und ändert sich, wenn ein Administrator diesen Namen ändert.
- Firmware-Downloads. Der Link
fw_urlist standardmäßig 15 Minuten gültig, und das Gerät setzt einen abgebrochenen Download mit einer HTTP-Range-Anfrage fort. Der Link kann mit einer Weiterleitung auf den Dateispeicher-Host Ihrer Region antworten. Daher muss ein Gerät Weiterleitungen folgen, und Ihre Firewall muss ihm auch den Zugriff auf diesen Host erlauben. - Fernzugriff. Der Router wählt sich nach außen ein, wenn Sie Open panel auswählen; er benötigt keine feste IP-Adresse und keinen offenen Port. Das Bedienfeld öffnet sich in einem neuen Tab unter seiner eigenen Adresse, auf einer anderen Domain als Hermetry. Siehe Remote access to a router’s panel.
- Datei-Uploads im Browser. Wenn Ihre Region Dateien in einem Objektspeicher ablegt, kann der Browser eine Datei direkt in diesen Speicher hochladen. Wenn Ihr Netzwerk nur aufgeführte Hostnamen erlaubt, erlauben Sie zusätzlich den Dateispeicher-Host.
Geräte, mit denen Hermetry sich verbindet
Manche Geräte können sich nicht nach außen verbinden: ein SNMP-Agent in einer USV, eine Kamera, ein Recorder. Für diese verbindet sich der Poller von Hermetry mit dem Gerät. Dies ist der einzige Fall, in dem Ihr Standort eine Verbindung aus dem Internet annimmt.
| Was | Richtung | Was freizugeben ist |
|---|---|---|
| SNMP-Agenten und andere abgefragte Geräte | Von Hermetry zur öffentlichen Adresse Ihres Geräts | Der eigene Port des Geräts, nur von den Adressen der Plattform |
| Kameras und Recorder | Von Hermetry zur öffentlichen Adresse Ihrer Kamera | Die HTTP- und RTSP-Ports der Kamera, nur von den Adressen der Plattform |
Nennt die Installation die festen Adressen, von denen der Poller sich verbindet, zeigt das Endpunktformular sie an: „Die Plattform verbindet sich von … mit dem Gerät. Erlauben Sie diese Adressen in der Firewall des Standorts.“ Erlauben Sie nur diese Adressen und nur zum Port des Geräts.
Private, Loopback- und Link-Local-Adressen werden abgewiesen. Um Geräte in einem privaten Netzwerk ohne öffentliche Adresse oder Portweiterleitung zu erreichen, stellen Sie einen Hermetry Edge im Standortnetz auf. Siehe Protocol endpoints und Add a camera or recorder.
Verbindungen von Hermetry zu Ihren Diensten
Webhooks, die HTTP-Request- und MQTT-Out-Bausteine von Flows sowie abgefragte Endpunkte verbinden sich von Hermetry aus nach außen zu Adressen, die Sie eingeben. Ihr empfangender Server muss diese Verbindungen auf dem Port in seiner URL annehmen. Hermetry weist dafür private, Loopback- und interne Adressen nach der Namensauflösung ab. Siehe Webhooks und Connections and secrets.
Eine Verbindung von Ihrem Standort prüfen
Führen Sie diese Befehle von einem Computer im selben Netzwerk wie Ihre Geräte aus. Ersetzen Sie den Host durch den, den die App anzeigt.
# The broker: the handshake must end with "Verify return code: 0 (ok)"
openssl s_client -connect <broker host>:8883 -servername <broker host> </dev/null
# The web app and the device HTTP API
curl -sI https://<your organisation's address>/
# The network server (no port in the address means 443)
openssl s_client -connect <network server host>:443 -servername <network server host> </dev/null
Ein Timeout bedeutet, dass eine Firewall die Verbindung verwirft. Ein Zertifikatsfehler bedeutet meist, dass sich das Gerät über eine IP-Adresse verbindet, kein CA-Bundle hat oder seine Uhr falsch geht. Siehe A device does not connect.

