UDP Connector
Connector-detaljer – UDP
UDP-connectorn gör det möjligt för plattformen att ta emot enhetsuppdateringar via UDP-protokollet. Detta används vanligtvis av enheter som kommunicerar via NB-IoT, Cat-M eller liknande trådlösa tekniker, även om direkta trådbundna UDP-anslutningar också stöds.
Inkommande data måste vara en HEX-kodad sträng som innehåller en inbäddad identifierare för att avgöra vilken enhet den kommer från.
Nödvändig Information
För att konfigurera en UDP-anslutning måste följande anges:
-
Integration name Anger hur plattformen bearbetar och validerar inkommande UDP-data. Den identifierar vilken typ av enhet som skickar datan och säkerställer korrekt matchning i plattformen.
-
Port number UDP-porten som plattformen lyssnar på för inkommande data.
Viktigt: Alla UDP-portar är stängda som standard. En supportförfrågan måste skickas in för att öppna önskad port. Det finns 65 536 tillgängliga UDP-portar (1025 till 65535 är giltiga nummer).
Säkerhetsöverväganden
UDP-data överförs okrypterat och kan avlyssnas när den färdas över publika nätverk. Även om payloaden är HEX-kodad är den inte säker som standard.
Använd inte enbart UDP-kommunikation för känslig data över publika nätverk.
För att säkra datan stödjer plattformen DTLS (Datagram Transport Layer Security). DTLS kan aktiveras om de anslutna IoT-enheterna också stödjer det.
Tillåtna avsändare och hastighetsgräns
UDP har ingen inloggning, så plattformen kontrollerar var varje paket kommer ifrån:
- Tillåtna avsändare. Plattformen kan ta emot paket bara från en lista med avsändar-IP-adresser och adressintervall. Paket från andra adresser slängs och loggas. Listan sätts på servern av nätverksadministratören, inte i plattformen: på plattformar som Sensative driftar frågar du Sensative support, på en egen installation frågar du din nätverksadministratör. Utan lista tas paket från alla adresser emot.
- Hastighetsgräns. Varje avsändar-IP-adress får skicka högst 100 paket per sekund som standard. Paket över gränsen slängs och loggas. Paket från andra adresser påverkas inte.
När enheterna använder NB-IoT eller Cat-M kommer deras paket från mobiloperatörens nät, så listan måste innehålla operatörens adressintervall, inte enheternas egna adresser. Fråga operatören efter dem. Av samma skäl gäller hastighetsgränsen alla enheter bakom en operatörsadress tillsammans, så anpassa den efter hela flottan: 3 000 enheter som rapporterar en gång i minuten skickar 50 paket per sekund.
Nätverksadministratören sätter listan och gränsen i udp-delen av UDP-tjänstens config.json
(allowedSenders och maxPacketsPerSecondPerSender), eller med miljövariablerna
UDP_ALLOWED_SENDERS och UDP_MAX_PACKETS_PER_SECOND_PER_SENDER, som går före config.json.
Med allowedPorts (eller UDP_ALLOWED_PORTS) anger administratören vilka UDP-portar brandväggen
släpper igenom. En UDP-connector på någon annan port startas inte, och tjänsten loggar det. Utan
allowedPorts får connectorer använda alla portar från 1025 till 65535.
Fysisk Konfiguration av UDP-enheten
När du sätter upp den fysiska UDP-enheten, konfigurera följande på enheten:
- Plattformens URL eller statiska IP-adress
- UDP-portnumret som öppnats för connectorn
Du kan verifiera plattformens IP-adress via en domänuppslagstjänst. IP-adressen är statisk och ändras inte. Se till att porten som konfigurerats i enheten exakt matchar connectorns port.
Vid användning av NB-IoT eller Cat-M, se till att notera SIM-kortets IMSI-nummer så att det senare kan tilldelas rätt enhet i plattformen.
Skapa UDP-enheter
Så här registrerar du en UDP-ansluten enhet:
- Skapa en standard generisk nod i plattformen.
- Använd motsvarande integrationsidentifierare, enligt definitionen nedan.
Gör detta innan den fysiska enheten skickar sitt första meddelande. Ett meddelande vars identifierare inte matchar någon enhet på connectorn slängs och loggas. Plattformen skapar ingen enhet för det.
| Integration Name | Identifierare |
|---|---|
| IMBuildings | sensorId |
Om NB-IoT eller Cat-M används, se till att lägga till SIM-kortets IMSI-nummer i enhetens kontextuella parametrar i plattformen.
Om ingen data tas emot är det viktigt att veta vilket SIM-kort enheten använder. Detta gör det möjligt att verifiera i SIM-leverantörens portal att:
- SIM-kortet är aktivt
- Datatrafiken routas korrekt via förväntad APN - Access Point Name
Dataformat och Översättning
Den mottagna datan måste vara en HEX-sträng. En översättare måste väljas eller skapas för att avkoda datan och tilldelas till UDP-enhetens konfiguration.