UDP Connector

Connector-Details – UDP

Der UDP Connector ermöglicht es der Plattform, Geräte-Updates über das UDP-Protokoll zu empfangen. Dies wird typischerweise von Geräten genutzt, die über NB-IoT, Cat-M oder ähnliche Funktechnologien kommunizieren, wobei auch direkte kabelgebundene UDP-Verbindungen unterstützt werden.

Eingehende Daten müssen ein HEX-kodierter String sein, der eine eingebettete Kennung zur Bestimmung des Quellgeräts enthält.

Erforderliche Informationen

Um eine UDP-Verbindung zu konfigurieren, muss Folgendes angegeben werden:

• Integration name Legt fest, wie die Plattform eingehende UDP-Daten verarbeitet und validiert. Er identifiziert den Gerätetyp, der die Daten sendet, und stellt eine korrekte Zuordnung in der Plattform sicher.

• Port number Der UDP-Port, auf dem die Plattform auf eingehende Daten wartet.

Wichtig: Alle UDP-Ports sind standardmäßig geschlossen. Ein Support-Ticket muss eingereicht werden, um den gewünschten Port zu öffnen. Es stehen 65.536 UDP-Ports zur Verfügung (0–65535).

Sicherheitsaspekte

UDP-Daten werden unverschlüsselt übertragen und können abgefangen werden, sobald sie über öffentliche Netzwerke laufen. Auch wenn die Payload HEX-kodiert ist, ist sie standardmäßig nicht sicher.

Verwenden Sie keine reine UDP-Kommunikation für sensible Daten über öffentliche Netzwerke.

Um die Daten zu sichern, unterstützt die Plattform DTLS (Datagram Transport Layer Security). DTLS kann aktiviert werden, wenn die angeschlossenen IoT-Geräte dies ebenfalls unterstützen.

Zugelassene Absender und Ratenbegrenzung

UDP hat keine Anmeldung, daher prüft die Plattform, woher jedes Paket kommt:

• Zugelassene Absender. Die Plattform kann Pakete nur von einer Liste von Absender-IP-Adressen und Adressbereichen annehmen. Pakete von anderen Adressen werden verworfen und protokolliert. Die Liste wird vom Netzwerkadministrator auf dem Server gesetzt, nicht in der Plattform: bei Plattformen, die Sensative betreibt, wenden Sie sich an den Sensative Support, bei einer eigenen Installation an Ihren Netzwerkadministrator. Ohne Liste werden Pakete von allen Adressen angenommen.
• Ratenbegrenzung. Jede Absender-IP-Adresse darf standardmäßig höchstens 100 Pakete pro Sekunde senden. Pakete über der Grenze werden verworfen und protokolliert. Pakete von anderen Adressen sind nicht betroffen.

Wenn die Geräte NB-IoT oder Cat-M verwenden, kommen ihre Pakete aus dem Netz des Mobilfunkbetreibers. Die Liste muss daher die Adressbereiche des Betreibers enthalten, nicht die Adressen der Geräte. Fragen Sie den Betreiber danach. Aus demselben Grund gilt die Ratenbegrenzung für alle Geräte hinter einer Betreiberadresse gemeinsam, bemessen Sie sie also für die ganze Flotte: 3.000 Geräte, die einmal pro Minute senden, schicken 50 Pakete pro Sekunde.

Der Netzwerkadministrator setzt die Liste und die Grenze im Abschnitt udp der config.json des UDP-Dienstes (allowedSenders und maxPacketsPerSecondPerSender) oder mit den Umgebungsvariablen UDP_ALLOWED_SENDERS und UDP_MAX_PACKETS_PER_SECOND_PER_SENDER, die Vorrang vor der config.json haben.

Mit allowedPorts (oder UDP_ALLOWED_PORTS) legt der Administrator fest, welche UDP-Ports die Firewall durchlässt. Ein UDP-Connector auf einem anderen Port wird nicht gestartet, und der Dienst protokolliert das. Ohne allowedPorts dürfen Connectoren jeden Port von 1025 bis 65535 verwenden.

Konfiguration des physischen UDP-Geräts

Bei der Einrichtung des physischen UDP-Geräts konfigurieren Sie am Gerät Folgendes:

• Die URL oder statische IP-Adresse der Plattform
• Die für den Connector geöffnete UDP-Portnummer

Sie können die IP-Adresse der Plattform über einen Domain-Lookup-Dienst überprüfen. Die IP ist statisch und ändert sich nicht. Stellen Sie sicher, dass der am Gerät konfigurierte Port genau mit dem Port des Connectors übereinstimmt.

Bei Verwendung von NB-IoT oder Cat-M achten Sie darauf, die IMSI-Nummer der SIM-Karte zu notieren, damit sie später dem richtigen Gerät in der Plattform zugeordnet werden kann.

Erstellen von UDP-Geräten

So registrieren Sie ein UDP-verbundenes Gerät:

1. Erstellen Sie einen Standard-generic node in der Plattform.
2. Verwenden Sie die entsprechende Integrationskennung, wie unten definiert.

Tun Sie dies, bevor das physische Gerät seine erste Nachricht sendet. Eine Nachricht, deren Kennung zu keinem Gerät am Connector passt, wird verworfen und protokolliert. Die Plattform legt dafür kein Gerät an.

Integration Name	Kennung
IMBuildings	sensorId

Bei Verwendung von NB-IoT oder Cat-M achten Sie darauf, die IMSI-Nummer der SIM-Karte zu den kontextuellen Parametern des Geräts in der Plattform hinzuzufügen.

Wenn keine Daten empfangen werden, ist es wichtig zu wissen, welche SIM-Karte das Gerät verwendet. Damit können Sie im Portal des SIM-Anbieters überprüfen, dass:

• Die SIM aktiv ist
• Der Datenverkehr korrekt über den erwarteten APN – Access Point Name geleitet wird

Datenformat & Übersetzung

Die empfangenen Daten müssen ein HEX-String sein. Ein Übersetzer muss ausgewählt oder erstellt werden, um die Daten zu dekodieren, und der UDP-Gerätekonfiguration zugewiesen werden.