Konfigurera anslutningsappen för SSE (förhandsversion)

I Azure IoT Operations ger anslutningsappen för serverutskickade händelser (SSE) (förhandsversion) åtkomst till data från SSE-slutpunkter som exponeras av HTTP-tjänster.

En tillgång i Azure IoT Operations är en logisk entitet som du skapar för att representera en fysisk tillgång eller enhet. En Azure IoT Operations-tillgång kan ha anpassade egenskaper, datapunkter, strömmar och händelser som beskriver dess beteende och egenskaper. En tillgång är associerad med en eller flera enheter. Azure IoT Operations lagrar tillgångsdefinitioner i Azure Device Registry.

En enhet i Azure IoT Operations är en logisk entitet som definierar anslutningarna till fysiska tillgångar eller enheter. Utan en enhet kan data inte flöda från en fysisk enhet eller tillgång till MQTT-koordinatorn. När du konfigurerar en enhet och tillgång upprättas en anslutning till den fysiska tillgången eller enheten och datapunktsvärden, händelser och strömmar som kommer till Azure IoT Operations-instansen. En enhet har en eller flera inkommande slutpunkter. Azure IoT Operations lagrar enhetsdefinitioner i Azure Device Registry.

Anslutningsappen för SSE har stöd för följande funktioner:

• Automatiska återförsök när samplingsfel inträffar. Rapporterar en misslyckad status för fel som inte kan åtgärdas.
• Integrering med OpenTelemetry.
• Användning av enhetsslutpunkter och namnområdestillgångar.
• Härled ett schema från JSON-nyttolasten.
• Flera autentiseringsmetoder:
  • Grundläggande HTTP-autentisering med användarnamn/lösenord
  • x509-klientcertifikat
  • Lista över betrodda certifikat
  • Anonym åtkomst i testsyfte
  • Certifikatförtroendepaket för att ange ytterligare certifikatutfärdare

För varje konfigurerad datauppsättning, connectorn för SSE:

• Exempel på SSE-händelser från den angivna SSE-slutpunkten.
• Genererar ett meddelandeschema för varje datauppsättning baserat på de data som den tar emot och registrerar den med Schema Registry och Azure Device Registry.
• Vidarebefordrar händelsedata till det angivna målet.

Den här artikeln beskriver hur du använder anslutningsappen för SSE för att utföra uppgifter som:

• Definiera de enheter som ansluter SSE-källor till din Azure IoT Operations-instans.
• Lägg till tillgångar och definiera händelserna för att aktivera dataflödet från SSE-källan till MQTT-mäklaren eller broker state store.

Förutsättningar

För att konfigurera enheter och tillgångar behöver du en förhandsversionsinstans av Azure IoT Operations.

För att logga in på webbgränssnittet för driftsupplevelsen behöver du ett Microsoft Entra-ID-konto med minst deltagarbehörighet för resursgruppen som innehåller din Kubernetes – Azure Arc-instans . Du kan inte logga in med ett Microsoft-konto (MSA). Så här skapar du ett lämpligt Microsoft Entra-ID-konto i din Azure-klientorganisation:

1. Logga in på Azure Portal med samma klient och användarnamn som du använde för att distribuera Azure IoT Operations.
2. I Azure Portal går du till avsnittet Microsoft Entra-ID och väljer Användare > + Ny användare > Skapa ny användare. Skapa en ny användare och anteckna lösenordet. Du behöver det för att logga in senare.
3. I Azure Portal går du till resursgruppen som innehåller Kubernetes – Azure Arc-instansen. På sidan Åtkomstkontroll (IAM) väljer du +Lägg till > rolltilldelning.
4. På sidan Lägg till rolltilldelning väljer du Privilegierade administratörsroller. Välj sedan Deltagare och välj sedan Nästa.
5. På sidan Medlemmar lägger du till din nya användare i rollen.
6. Välj Granska och tilldela för att slutföra konfigurationen av den nya användaren.

Du kan nu använda det nya användarkontot för att logga in på webbgränssnittet för driftupplevelse .

IT-administratören måste ha konfigurerat anslutningsappen för SSE-mallen för din Azure IoT Operations-instans i Azure-portalen.

Du behöver alla autentiseringsuppgifter som krävs för att få åtkomst till SSE-källan. Om SSE-källan kräver autentisering måste du skapa en Kubernetes-hemlighet som innehåller användarnamnet och lösenordet för SSE-källan.

Distribuera anslutningen för SSE

När du distribuerar förhandsversionen av Azure IoT Operations innehåller distributionen de tre förhandsgranskningsanslutningarna. Du kan kontrollera att du har en förhandsversion av Azure IoT Operations genom att i Azure-portalen kontrollera att förhandsversionsfunktioner är aktiverade för din instans:

Innan du kan använda förhandsgranskningsanslutningsapparna (ONVIF, media och HTTP/REST) i webbgränssnittet för driftsupplevelsen måste en administratör lägga till anslutningsmallsinstanser i din Azure IoT Operations-instans.

Alla tre förhandsversionanslutningar kan publicera insamlade data till MQTT-broker.

Så här lägger du till en mallinstans för anslutningsappen i din Azure IoT Operations-instans:

1. I Azure-portalen går du till din Azure IoT Operations-instans, väljer Anslutningsmallar och väljer sedan Lägg till anslutningsmallinstanser:

   

2. På den första sidan i guiden Lägg till en Akri-anslutningsmall väljer du den typ av anslutningsmall som du vill lägga till, till exempel ONVIF, Media eller HTTP REST. Välj sedan Metadata.

   

3. På sidan Metadata godkänner du standardvärdena och väljer sedan Typ av inkommande slutpunkt för enhet.

4. På sidan Typ av inkommande slutpunkt för enhet godkänner du standardvärdena och väljer sedan Diagnostikkonfigurationer.

5. På sidan Diagnostikkonfigurationer godkänner du standardvärdena och väljer sedan Körningskonfiguration.

6. På sidan Körningskonfiguration godkänner du standardvärdena och väljer sedan Granska:

7. På sidan Granska granskar du informationen om mallinstansen för anslutningsappen och väljer sedan Skapa för att skapa mallinstansen för anslutningsappen.

En OT-användare kan nu använda webbgränssnittet för driftupplevelse för att skapa en enhet med en slutpunkt för förhandsversionen av anslutningsappen.

Skapa en enhet

Om du vill konfigurera anslutningsappen för SSE skapar du först en enhet som definierar anslutningen till SSE-källan. Enheten innehåller URL:en för SSE-källan och eventuella autentiseringsuppgifter som du behöver för att komma åt SSE-källan:

az iot ops ns device create -n sse-connector-cli -g {your resource group name} --instance {your instance name} 

az iot ops ns device endpoint inbound add sse --device sse-connector-cli -g {your resource group name} -i {your instance name}  --name sse-connector-0 --endpoint-address "https://sse-connector-0:443/base-path"

Skapa en namnområdesresurs

Så här definierar du en namnområdestillgång som publicerar händelser från SSE-slutpunkten:

az iot ops ns asset sse create --name mysseasset --instance {your instance name} -g {your resource group name} --device sse-connector-cli --endpoint sse-connector-0 --dataset-dest topic="azure-iot-operations/data/erp" retain=Never qos=Qos1 ttl=3600