Hoppa till huvudinnehåll

Actility / Netmore ThingPark DX Connector:

connector-details-actility-thingpark

Actility / Netmore ThingPark-integration via DX API​

Plattformen integrerar med Actility / Netmore ThingPark via DX API.

  • Standard DX API URL: https://dx-api.thingpark.com/

    ⚠️ Denna URL kan variera beroende på din ThingPark-leverantör.

Vad Connectorn Gör​

Med hjälp av DX API:et gör connectorn det möjligt för plattformen att:

  • Provisionera nya enheter
  • Importera befintliga enheter
  • Instruera ThingPark att publicera enhetsdata till Yggios MQTT broker

Autentisering och Anslutning​

DX API:et använder OAuth 2.0-autentisering. Följande uppgifter krävs:

  • DX API URL – Standard: https://dx-api.thingpark.com/, men kan variera
  • Username – Giltig för domänen för den valda profilen
  • Password – Motsvarande lösenord för användarnamnet
  • Target Profile Identifier (valfritt) – Anger vilken ThingPark-domän och vilket operatörskonto som används för API-anrop. ThingPark Enterprise-värdar använder ingen; lämna fältet tomt där
  • Processing Strategy ID (valfritt) – Den ThingPark-processtrategi som tillämpas på enheter som provisioneras genom den här connectorn, till exempel IOT_FLOW
  • Domains (valfritt) – En eller flera ThingPark-domäner som enheten ska tillhöra, var och en angiven som ett Organization-namn och ett Group-namn
  • Route References (valfritt) – En eller flera ThingPark-ruttreferenser, angivna som Route Reference 1, Route Reference 2 och så vidare

Target Profile Identifier Detta representerar en kombination av en ThingPark-domän (t.ex. mycustomer.thingpark.com) och det operatörskonto som används för att utföra API-anrop, samt andra parametrar relaterade till tokengenerering. Din ThingPark-leverantör tillhandahåller denna identifierare, och den måste vara förkonfigurerad i DX-plattformen.

Lämna fältet tomt på en ThingPark Enterprise-värd, som saknar target profile. Då används enbart inloggningen för att hämta en token, och ett värde som plattformen inte känner igen avvisas med "Profile not defined on the server".

ThingPark Enterprise En Enterprise-plattform tillhandahåller samma API under prefixet /thingpark/dx, så ange URL:en som https://<host>/thingpark/dx, till exempel https://thingparkenterprise.eu2.actility.com/thingpark/dx. Allt annat konfigureras på samma sätt.

En connector behåller den OAuth-klient den skapades med. Att i efterhand ändra URL eller target profile påverkar inte hur den autentiserar, så för att flytta en befintlig connector till en Enterprise-värd skapar du en ny connector i stället.

De tre valfria inställningarna Processing Strategy ID, Domains och Route References är ThingPark-begrepp snarare än Yggio-begrepp. De behövs oftast vid lokala eller operatörsspecifika ThingPark-installationer; på en vanlig hostad ThingPark kan de vanligtvis lämnas tomma.

Yggio lagrar dem på connectorn och skickar dem till ThingPark när en ny enhet provisioneras och när en befintlig uppdateras. De används ingen annanstans, så en ändring får effekt för enheter som skapas eller synkroniseras från den tidpunkten och framåt, inte retroaktivt.

Värdena kommer från din ThingPark-leverantör eller administratör: fråga vilken processtrategi, vilka domäner och vilka rutter ditt konto förväntar sig. Ett värde som ThingPark inte känner igen gör att provisioneringen misslyckas i stället för att ignoreras.

Processing Strategy ID kan också sättas på en enskild enhet, och enhetens eget värde har företräde framför connectorns.

Ställa in MQTT Export (ThingPark → Yggio)​

För att publicera data från ThingPark till Yggio måste MQTT Export konfigureras i båda ändar.

Nödvändiga Steg:​

  1. Skapa connectorn. När den sparas genererar plattformen ett MQTT-användarnamn och ett lösenord åt den, och visar dem i guidens sista steg tillsammans med de två topics som står nedan, med varsin kopieringsknapp. Kopiera dem därifrån i stället för att sätta ihop dem för hand.

    Lösenordet visas en gång. Det lagras hashat och går inte att hämta i efterhand. Kopiera det innan du lämnar sidan. Tappat bort det? Radera connectorn och skapa den på nytt.

  2. Konfigurera ThingParks MQTT Export med följande värden:

FältVärde
Hostnamemqtt.staging.yggio.net:8883
MQTT Usernameanvändarnamnet som plattformen genererade
MQTT Passwordlösenordet som plattformen genererade
Published Topicsdet genererade published-topicet, slutar med /things/{DevEUI}/uplink
Subscribed Topicsdet genererade subscribed-topicet, slutar med /things/{DevEUI}/downlink
ProtocolSSL
CA CertificatesKrävs inte om du inte använder en anpassad/lokal ThingPark-installation

Tabell över vilken MQTT-information som behöver uppdateras med korrekt information

thingpark-connection ThingParks MQTT-anslutningsinställningar som bör uppdateras med korrekt information

För fullständiga installationsinstruktioner, se Actilitys officiella dokumentation för MQTT-connectorn: https://docs.thingpark.com/thingpark-x/latest/Connector/MQTT/

Verifiera Connectorn​

  • Plattformen verifierar automatiskt anslutningen när connectorn skapas, men detta garanterar inte full funktionalitet.

  • För att utföra en fullständig verifiering:

    1. Skapa en enhet i plattformen med Actility / Netmore ThingPark-connectorn.
    2. Öppna enhetssidan efter att den skapats.
    3. Gå till Tools och kontrollera statusen för Synchronize - den bör inte visa "never".
    4. Klicka på Synchronize-knappen manuellt för att bekräfta att det fungerar.
    5. Logga in på ThingPark och bekräfta att enheten har provisionerats.
    6. Utlös (eller vänta på) enhetens första uplink.
    7. Kontrollera att uplinken tas emot och avkodas korrekt av plattformen.

Importera enheter:​

När connectorn är korrekt konfigurerad kan du vilja importera befintliga enheter från ThingPark till IoT-plattformen. Detta kan göras direkt från Connector-gränssnittet, och plattformen kommer alltid att försöka importera alla tillgängliga enheter.

Multikonto-installation:​

Det finns två huvudsakliga sätt att integrera ThingPark med IoT-plattformen. Den viktigaste faktorn är hur fakturering till slutanvändare ska hanteras – via ThingPark, via IoT-plattformen, eller en kombination av båda. Om dina användare kommer att komma åt IoT-plattformen direkt måste du konfigurera Organization Manager för att säkerställa att varje användare bara ser de enheter de har behörighet till.

Integrationsalternativ​

  • Fakturering via ThingPark eller båda systemen: Spegla ThingParks organisationsstruktur i IoT-plattformen. Skapa en connector per Netmore-kund.

  • Fakturering enbart via IoT-plattformen: Använd en platt struktur i ThingPark, där alla enheter hanteras på ett och samma ställe. Endast en connector behövs i IoT-plattformen.

⚠️ Viktigt:​

Om en enhet tas bort från IoT-plattformen kommer den som standard även att tas bort och avvecklas från ThingParks LoRaWAN-server. För att undvika detta, se till att välja bort borttagningsåtgärden när du blir tillfrågad i bekräftelsedialogen.

Opt out delete

Felsökning​

Enhetsprovisionering misslyckas​

Ett rött felmeddelande (toaster) visas när en ny enhet läggs till, och prismodeller visas inte. Detta tyder vanligtvis på ett problem med din URL, dina autentiseringsuppgifter, åtkomsträttigheter eller Target Profile Identifier. Uteslut dessa en i taget:

  • Dubbelkolla URL:en – se till att det inte finns ett avslutande / i slutet.
  • Verifiera att Username, Password, Target Profile Identifier och åtkomstbehörigheter är korrekta.

Om ovanstående inte löser problemet:

  1. Gå till DX API-URL:en: https://dx-api.thingpark.com/ (eller din operatörs anpassade DX API-URL)
  2. Försök logga in med ditt username och password.
  3. Om inloggningen misslyckas eller ingen token returneras:
    • Kontakta din ThingPark-leverantör för att bekräfta korrekt autentiseringsuppgifter och Target Profile Identifier.

Den troliga grundorsaken är en felmatchning eller felkonfiguration i MQTT export-inställningen mellan ThingPark och Yggio. Gå till sensorn i ThingPark-portalen.

  • Bekräfta att MQTT-topics matchar på både ThingPark-sidan och IoT-plattformens sida.
  • Dubbelkolla MQTT-användarnamnet, lösenordet och base topic.
  • Säkerställ att SSL- och portinställningarna (mqtt.[staging.yggio.net]:8883) är korrekt konfigurerade.

ThingPark MQTT-dokumentation: https://docs.thingpark.com/thingpark-x/latest/Connector/MQTT/

Jag har en API Gateway mellan mig och ThingPark - vad ska jag göra?​

  • Se till att API Gateway ger åtkomst till både ThingPark-API:et och att ThingPark får åtkomst till IoT-plattformens MQTT broker.
  • När du skapar connectorn, uppdatera API URL till att peka på de gateway-endpoints som routar korrekt till ThingPark.
  • En API Gateway kan använda organisationsspecifika certifikat som kan behöva läggas till i IoT-plattformen. Kontakta Sensative support för att lägga till nödvändiga certifikat.

Jag får ett 40x-fel när jag försöker importera eller skapa enheter - vad kan det bero på?​

  • Ett 40x-fel innebär att ThingPark avvisar förfrågan. Detta orsakas vanligtvis av:
    • Felaktiga autentiseringsuppgifter
    • Fel URL
    • Saknade eller felaktiga åtkomsträttigheter på ThingPark-sidan
  • Gå igenom installationen igen och verifiera följande:
    • Username, password, API URL
    • Target Profile Identifier
  • Bekräfta även:
    • Användarkontots åtkomsträttigheter

Jag får fortfarande ett 40x-fel efter att ha följt stegen ovan. Vad nu?​

  • Om allt ser korrekt ut i ditt ThingPark-konto, fortsätt med avancerad felsökning:
  1. Gå till DX API-URL:en: https://dx-api.thingpark.com/ (eller din operatörs anpassade DX API-URL)
  2. Försök logga in med ditt username, password och Target Profile Identifier.
  • Om inloggningen misslyckas, kontakta ThingPark support – API-autentiseringen kanske inte är fullständigt konfigurerad på deras sida.
  • Om inloggningen lyckas, testa andra endpoints för att bekräfta dina åtkomsträttigheter via API:et.