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

Hostnamen, Ports und IP-Adressen

Die Verbindungen, die Hermetry von Ihrem Standort benötigt, mit ihrer Richtung und ihrem Port sowie der Angabe, wo die App jeden Hostnamen anzeigt.

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.

HostWas es istWo die App es anzeigt
Adresse Ihrer OrganisationDie kostenlose Adresse <slug>.<platform domain> sowie jede eigene Domain, die Sie hinzugefügt habenDomains im Bereich Organisation des Menüs. Siehe Web addresses and custom domains
Broker-HostDer MQTT-Host, mit dem sich Ihre Geräte verbindenDie Karte Connection details auf der Geräteseite
HTTPS-GeräteadresseDie Basisadresse der HTTP-API für GeräteDie Karte Connection details auf der Geräteseite
Adresse des Network ServersDie 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-DownloadsEin kurzlebiger HTTPS-Link im Attribut fw_url des GerätsWird 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

VerbindungVonNachProtokoll und Port
Web-App und REST-APIBrowser, Skripte und IntegrationenAdresse Ihrer Organisation und die eigene Anmeldeadresse der PlattformHTTPS auf TCP 443
Live-Aktualisierungen in der AppBrowserDieselbe Adresse wie die AppWebsocket über HTTPS auf TCP 443
MQTT-GeräteGeräte und GatewaysDer Broker-HostMQTT 3.1.1 über TLS auf TCP 8883
MQTT-Geräte ohne TLSGeräte eines Profils, das einfaches MQTT erlaubtDer Broker-HostMQTT auf TCP 1883, nur wo die Installation den einfachen Listener betreibt
HTTPS-GeräteGeräteDie HTTPS-Geräteadresse, Pfade unter /api/v1/HTTPS auf TCP 443
LoRaWAN-GatewaysBasics-Station-Gateways und lizenzierte Router mit LoRa-FunkmodulDie Adresse des Network ServersSicherer Websocket (wss://): TCP 443, wenn die Adresse keinen Port zeigt, sonst der Port in der Adresse
Firmware-DownloadsGeräteDer Host in fw_url, danach der Host des Dateispeichers, auf den weitergeleitet werden darfHTTPS
Fernzugriff auf das Bedienfeld eines RoutersLizenzierte RouterDie Tunneladresse der Plattform, die der Router beim Öffnen einer Sitzung erhältTLS (sicherer Websocket)
Fernzugriff auf das Bedienfeld eines RoutersBrowser Ihrer MitgliederDie Adresse des Bedienfelds, auf einer anderen Domain als HermetryHTTPS

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_url ist 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.

WasRichtungWas freizugeben ist
SNMP-Agenten und andere abgefragte GeräteVon Hermetry zur öffentlichen Adresse Ihres GerätsDer eigene Port des Geräts, nur von den Adressen der Plattform
Kameras und RecorderVon Hermetry zur öffentlichen Adresse Ihrer KameraDie 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.