Översikt över partnerhändelser – Azure Event Grid

Artikel
10/18/2023

Event Grids partnerhändelser gör det möjligt för kunder att prenumerera på händelser som har sitt ursprung i ett registrerat system med samma mekanism som de skulle använda för alla andra händelsekällor i Azure, till exempel en Azure-tjänst. De registrerade systemen integreras med Event Grid kallas "partners". Den här funktionen gör det också möjligt för kunder att skicka händelser till partnersystem som stöder mottagande och routning av händelser till kundens lösningar/slutpunkter på deras plattform. Partner är vanligtvis SaaS-leverantörer (software-as-a-service) eller ERP-leverantörer , men de kan vara företagsplattformar som vill göra sina evenemang tillgängliga för interna team. De integrerar avsiktligt med Event Grid för att förverkliga kundanvändningsfall från slutpunkt till slutpunkt som slutar på Azure (kunder prenumererar på händelser som skickas av partner) eller slutar på ett partnersystem (kunder prenumererar på Microsoft-händelser som skickas av Azure Event Grid). Kunder bankar på Azure Event Grid för att skicka händelser som publicerats av en partner till mål som stöds, till exempel webhooks, Azure Functions, Azure Event Hubs eller Azure Service Bus, för att nämna några. Kunder förlitar sig också på Azure Event Grid för att dirigera händelser som har sitt ursprung i Microsoft-tjänster, till exempel Outlook, Teams eller Microsoft Entra ID, så att kundens lösningar kan reagera på dem. Med Partnerhändelser kan kunder skapa händelsedrivna lösningar över plattformar och nätverksgränser för att ta emot eller skicka händelser på ett tillförlitligt, säkert och i stor skala.

Kommentar

Det här är en konceptuell artikel som krävs för att läsa innan du bestämmer dig för att registrera dig som partner till Azure Event Grid. Stegvisa instruktioner om hur du registrerar dig som Event Grid-partner med hjälp av Azure-portalen finns i Publicera som Event Grid-partner (Azure-portalen).

Partnerhändelser: Så här fungerar det

Som partner skapar du Event Grid-resurser som gör att du kan publicera händelser till Azure Event Grid så att kunder i Azure kan prenumerera på dem. För de flesta partner, till exempel SaaS-leverantörer, är det den enda integreringsfunktionen som de kommer att använda.

Du kan också skapa Event Grid-resurser för att ta emot händelser från Azure Event Grid. Det här användningsfallet gäller för organisationer som äger eller hanterar en plattform som gör det möjligt för deras kunder att ta emot händelser genom att exponera slutpunkter. Vissa av dessa organisationer är ERP-system som också har funktioner för händelsedirigering på sin plattform, som skickar inkommande Azure-händelser till ett kundprogram som finns på deras plattform.

För att antingen publicera händelser eller ta emot händelser skapar du samma typ av Event Grid-resurser genom att följa dessa allmänna steg.

Kontakta Event Grid-teamet för askgrid@microsoft.com att informera om ditt intresse för att bli partner. När du kontaktar oss vägleder vi dig genom registreringsprocessen och hjälper din tjänst att få ett inmatningskort i vårt Azure Event Grid-galleri så att din tjänst kan hittas på Azure-portalen.
Skapa en partnerregistrering. Det här är en global resurs och du behöver vanligtvis skapa en gång.
Skapa ett partnernamnområde. Den här resursen exponerar en slutpunkt som du kan publicera händelser till Azure till. När du skapar partnernamnområdet anger du den partnerregistrering som du skapade.
Kunden ger dig behörighet att skapa ett partnerämne i kundens Azure-prenumeration.
Kunden kommer åt din webbsida eller kör ett kommando, du definierar användarupplevelsen, för att begära antingen flödet av dina händelser till Azure eller möjligheten att ta emot Microsoft-händelser i systemet. Som svar på den begäran konfigurerar du systemet för att göra det med indata från kunden. Kunden kan till exempel ha möjlighet att välja vissa händelser från systemet som ska vidarebefordras till Azure.
Skapa ett partnerämne i kundens Azure-prenumeration och resursgrupp med hjälp av kanaler. Kanaler är resurser som ingår i partnernamnområden.
Kunden aktiverar partnerämnet som du skapade i deras Azure-prenumeration och resursgrupp.
Börja publicera händelser till din partnernamnrymd.

Kommentar

Du måste registrera Azure Event Grid-resursprovidern till varje Azure-prenumeration där du vill skapa Event Grid-resurser. Annars misslyckas åtgärder för att skapa resurser.

Varför ska jag använda partnerhändelser?

Du kanske vill använda funktionen Partnerhändelser om du har ett eller flera av följande krav.

För partner som händelseutgivare

Du vill ha en mekanism för att göra dina händelser tillgängliga för dina kunder i Azure. Användarna kan filtrera och dirigera dessa händelser med hjälp av partnerämnen och händelseprenumerationer som de äger och hanterar. Du kan använda andra integreringsmetoder som ämnen och domäner. Dessa metoder skulle dock inte tillåta en ren uppdelning av resursägarskap, hantering och fakturering mellan dig och din kund. Funktionen Partnerhändelser ger också en mer intuitiv användarupplevelse som gör det enkelt att identifiera din tjänst.
Du behöver en enkel modell för flera klientorganisationer där du publicerar händelser till en enda regional slutpunkt, namnområdets slutpunkt, för att dirigera händelserna till olika kunder.
Du vill ha insyn i mått relaterade till publicerade händelser.
Du vill använda Cloud Events 1.0-schemat för dina händelser.

För partner som prenumerant

Du vill att din tjänst ska reagera på kundhändelser som har sitt ursprung i Microsoft Azure.
Du vill att kunden ska reagera på Microsoft Azure-tjänsthändelser med hjälp av sina program som hanteras av din plattform. Du använder plattformens funktioner för händelsedirigering för att leverera händelser till rätt kundlösning.
Du vill ha en enkel modell där dina kunder bara väljer ditt tjänstnamn som mål utan att de behöver känna till teknisk information som dina plattformsslutpunkter.
Ditt system/din plattform stöder Cloud Events 1.0-schema .

Resurser som hanteras av partner

Som partner hanterar du följande typer av resurser.

Partnerregistrering

En registrering innehåller allmän information som rör en partner. En registrering krävs när du skapar ett partnernamnområde. Du måste alltså ha en partnerregistrering för att kunna skapa nödvändiga Azure-resurser för att integrera med Azure Event Grid.

Registreringar är globala. Det innebär att de inte är associerade med en viss Azure-region. Du kan skapa en enda partnerregistrering och använda den när du skapar dina partnernamnområden.

Kanal

En kanal är en kapslad resurs i ett partnernamnområde. En kanal har två huvudsakliga syften:

Det är resurstypen som gör att du kan skapa partnerresurser i en kunds Azure-prenumeration. När du skapar en kanal av typen partner topicskapas ett partnerämne i en kunds Azure-prenumeration. Ett partnerämne är en kunds resurs som händelser dirigeras till när ett partnersystem publicerar händelser.

En kanal har samma livscykel som dess associerade kundpartnerämne eller mål. När en kanal av typen partner topic tas bort tas till exempel den associerade kundens partnerämne bort. På samma sätt tas den associerade kanalen i din Azure-prenumeration bort om partnerämnet tas bort av kunden.
Det är en resurs som används för att dirigera händelser. En kanal av typen partner topic används för att dirigera händelser till en kunds partnerämne. Den stöder två typer av routningslägen.
- Routning av kanalnamn. Med den här typen av routning publicerar du händelser med hjälp av ett HTTP-huvud med namnet aeg-channel-name där du anger namnet på den kanal som händelserna ska dirigeras till. Eftersom kanaler är en partners representation av partnerämnen visas händelserna som dirigeras till kanalavsnittet på kundens partnerämne. Den här typen av routning är en ny funktion som inte finns i event channels, som endast stöder källbaserad routning. Dirigering av kanalnamn möjliggör fler användningsfall än källbaserad routning och det är det rekommenderade routningsläget att välja. Med kanalnamnsdirigering kan en kund till exempel begära händelser som kommer från olika händelsekällor för att landa på ett enda partnerämne.
- Källbaserad routning. Den här routningsmetoden baseras på värdet för kontextattributet source i händelsen. Källor mappas till kanaler och när en händelse kommer med en källa, till exempel av värdet "A" dirigeras händelsen till partnerämnet som är associerat med kanalen som innehåller "A" i källegenskapen.
Du kanske vill deklarera de händelsetyper som dirigeras till kanalen och dess associerade partnerämne. Händelsetyper visas för kunder när de skapar händelseprenumerationer i partnerämnet och används för att välja de specifika händelsetyper som ska skickas till ett händelsehanterarmål. Läs mer.

Viktigt!

Händelsetyper kan hanteras på kanalen och när värdena har uppdaterats återspeglas ändringarna omedelbart i det associerade partneravsnittet.

Partnernamnområde

Ett partnernamnområde är en regional resurs som har en slutpunkt för att publicera händelser till Azure Event Grid. Partnernamnområden innehåller antingen kanaler eller händelsekanaler (äldre resurs). Du måste skapa partnernamnområden i regioner där kunder begär partnerämnen eller mål eftersom kanaler och deras motsvarande partnerresurser måste finnas i samma region. Du kan inte ha en kanal i en viss region med dess relaterade partnerämne, till exempel i en annan region.

Partnernamnområden innehåller antingen kanaler eller händelsekanaler. Det bestäms av routningsläget för egenskapspartnerämnet i namnområdet. Om den är inställd på Kanalnamnrubrik är kanaler den enda resurstypen som kan skapas under namnområdet. Om routningsläget för partnerämne är inställt på Källattribut i händelse, kan namnområdet bara innehålla händelsekanaler. Tänk på att beslutet att ställa in rätt partner topic routing mode inte är ett beslut mellan att välja kanalnamn eller källbaserad routning. Kanaler stöder båda. Det är snarare ett beslut mellan att använda den nya typen av routningsresurs, kanalerna, jämfört med att använda en äldre resurs, händelsekanalerna.

Händelsekanal

En händelsekanal är den resurs som först släpptes med Partnerhändelser för att dirigera inkommande händelser till partnerämnen. Händelsekanaler stöder endast källbaserad routning och de representerar alltid ett kundpartnerämne.

Viktigt!

Händelsekanaler håller på att bli inaktuella. Därför rekommenderar vi att du använder Kanaler.

Verifierade partner

En verifierad partner är en partnerorganisation vars identitet har verifierats av Microsoft. Det är starkt uppmuntrat att din organisation verifieras. Kunder försöker interagera med partner som har verifierats eftersom sådan verifiering ger större garantier för att de har att göra med en legitim organisation. När du har verifierat det kan du ha en närvaro i Event Grid-galleriet där kunderna enkelt kan upptäcka din tjänst och få en förstapartsupplevelse när de prenumererar på dina händelser, till exempel.

Kundens behörighet att skapa partnerämnen

Kunder ger dig behörighet att skapa partnerämnen i sin Azure-prenumeration. Auktoriseringen beviljas för en viss resursgrupp i en Azure-kundprenumeration och är tidsbunden. Du måste skapa kanalen före det förfallodatum som kunden anger. Du bör ha dokumentation som tyder på att kunden har tillräckligt med tid för att konfigurera systemet för att skicka eller ta emot händelser och för att skapa kanalen innan auktoriseringen upphör att gälla. Om du försöker skapa en kanal utan auktorisering eller när den har upphört att gälla misslyckas kanalskapandet och ingen resurs skapas i kundens Azure-prenumeration.

Kommentar

Event Grid började tillämpa auktoriseringskontroller för att skapa partnerämnen runt den 30 juni 2022. Dokumentationen bör be dina kunder att bevilja dig auktoriseringen som en förutsättning innan du skapar en kanal.

Viktigt!

En verifierad partner är inte en auktoriserad partner. Även om en partner har granskats av Microsoft måste du fortfarande ha behörighet innan du kan skapa ett partnerämne i kundens Azure-prenumeration.

Aktivering av partnerämne

Kunden aktiverar partnerämnet eller målet som du har skapat för dem. Då ändras kanalens aktiveringsstatus till Aktiverad. När en kanal har aktiverats kan du börja publicera händelser till partnernamnområdesslutpunkten som innehåller kanalen.

Hur automatiserar du processen för att veta när du kan börja publicera händelser för ett visst partnerämne?

Du har två alternativ:

Läs (avsök) kanaltillståndet regelbundet för att kontrollera om aktiveringsstatusen har övergått från NeverActivated till Aktiverad. Den här åtgärden kan vara beräkningsintensiv.
Skapa en händelseprenumeration för Den Azure-prenumeration eller resursgrupp som innehåller de kanaler som du vill övervaka. Du får Microsoft.Resources.ResourceWriteSuccess händelser när en kanal uppdateras. Sedan måste du läsa kanalens tillstånd med Azure Resource Manager-ID:t som angavs i händelsen för att kontrollera att uppdateringen är relaterad till en ändring i aktiveringsstatusen till Aktiverad.