Overzicht van partnergebeurtenissen voor partners - Azure Event Grid

Artikel
06/14/2023

Met partnerevenementen van Event Grid kunnen klanten zich abonneren op gebeurtenissen die afkomstig zijn van een geregistreerd systeem met hetzelfde mechanisme dat ze zouden gebruiken voor elke andere gebeurtenisbron in Azure, zoals een Azure-service. Deze geregistreerde systemen worden geïntegreerd met Event Grid, ook wel partners genoemd. Met deze functie kunnen klanten ook gebeurtenissen verzenden naar partnersystemen die ondersteuning bieden voor het ontvangen en routeren van gebeurtenissen naar oplossingen/eindpunten van klanten in hun platform. Normaal gesproken zijn partners SaaS- of ERP-providers (software als een dienst), maar ze kunnen bedrijfsplatforms zijn die hun gebeurtenissen beschikbaar willen maken voor interne teams. Ze integreren met Event Grid om end-to-end-klantgebruiksscenario's te realiseren die eindigen op Azure (klanten abonneren zich op gebeurtenissen die door een partner worden verzonden) of eindigen op een partnersysteem (klanten abonneren zich op Microsoft-gebeurtenissen die door Azure Event Grid worden verzonden). Klanten bankeren op Azure Event Grid om gebeurtenissen te verzenden die zijn gepubliceerd door een partner naar ondersteunde bestemmingen, zoals webhooks, Azure Functions, Azure Event Hubs of Azure Service Bus, om er een paar te noemen. Klanten vertrouwen ook op Azure Event Grid om gebeurtenissen te routeren die afkomstig zijn uit Microsoft-services, zoals Outlook, Teams of Microsoft Entra-id, zodat de oplossingen van klanten hierop kunnen reageren. Met partnergebeurtenissen kunnen klanten gebeurtenisgestuurde oplossingen bouwen op verschillende platforms en netwerkgrenzen om gebeurtenissen betrouwbaar, veilig en op een schaal te ontvangen of verzenden.

Notitie

Dit is een conceptueel artikel dat moet worden gelezen voordat u besluit om te onboarden als partner voor Azure Event Grid. Voor stapsgewijze instructies voor het onboarden als Event Grid-partner met behulp van Azure Portal, raadpleegt u Onboarden als Event Grid-partner (Azure Portal).

Partnerevenementen: hoe het werkt

Als partner maakt u Event Grid-resources waarmee u gebeurtenissen naar Azure Event Grid kunt publiceren, zodat klanten in Azure zich hierop kunnen abonneren. Voor de meeste partners, bijvoorbeeld SaaS-providers, is dit de enige integratiemogelijkheid die ze gebruiken.

U kunt ook Event Grid-resources maken om gebeurtenissen te ontvangen van Azure Event Grid. Deze use case is bedoeld voor organisaties die eigenaar zijn van of beheren van een platform waarmee hun klanten gebeurtenissen kunnen ontvangen door eindpunten weer te geven. Sommige van deze organisaties zijn ERP-systemen die ook mogelijkheden voor gebeurtenisroutering hebben binnen hun platform, waarmee de binnenkomende Azure-gebeurtenissen worden verzonden naar een klanttoepassing die op hun platform wordt gehost.

Voor het publiceren van gebeurtenissen of het ontvangen van gebeurtenissen maakt u hetzelfde type Event Grid-resources als volgt deze algemene stappen.

Neem contact op met het Event Grid-team bij askgrid@microsoft.com het communiceren van uw interesse om partner te worden. Zodra u contact met ons op neemt, begeleiden we u door het onboardingproces en helpen we uw service bij het verkrijgen van een invoerkaart in onze Azure Event Grid-galerie , zodat uw service te vinden is in Azure Portal.
Maak een partnerregistratie. Dit is een globale resource en u moet meestal één keer maken.
Maak een partnernaamruimte. Deze resource maakt een eindpunt beschikbaar waarop u gebeurtenissen naar Azure kunt publiceren. Geef bij het maken van de partnernaamruimte de partnerregistratie op die u hebt gemaakt.
De klant machtigt u om een partneronderwerp te maken in het Azure-abonnement van de klant.
De klant heeft toegang tot uw webpagina of voert een opdracht uit, u definieert de gebruikerservaring om de stroom van uw gebeurtenissen naar Azure aan te vragen of de mogelijkheid om Microsoft-gebeurtenissen in uw systeem te ontvangen. Als reactie op die aanvraag stelt u uw systeem in met invoer van de klant. De klant kan bijvoorbeeld de mogelijkheid hebben om bepaalde gebeurtenissen in uw systeem te selecteren die moeten worden doorgestuurd naar Azure.
Maak een partneronderwerp in het Azure-abonnement en de resourcegroep van de klant met behulp van kanalen. Kanalen zijn resources die zijn opgenomen in partnernaamruimten.
De klant activeert het partneronderwerp dat u hebt gemaakt in hun Azure-abonnement en resourcegroep.
Begin met het publiceren van gebeurtenissen naar uw partnernaamruimte.

Notitie

U moet de Azure Event Grid-resourceprovider registreren bij elk Azure-abonnement waar u Event Grid-resources wilt maken. Anders mislukken bewerkingen om resources te maken.

Waarom moet ik partnerevenementen gebruiken?

U kunt de functie Partnerevenementen gebruiken als u een of meer van de volgende vereisten hebt.

Voor partners als gebeurtenisuitgevers

U wilt een mechanisme om uw gebeurtenissen beschikbaar te maken voor uw klanten in Azure. Uw gebruikers kunnen deze gebeurtenissen filteren en routeren met behulp van partneronderwerpen en gebeurtenisabonnementen die ze bezitten en beheren. U kunt andere integratiemethoden gebruiken, zoals onderwerpen en domeinen. Deze benaderingen bieden echter geen duidelijke scheiding van eigendom, beheer en facturering van resources tussen u en uw klant. De functie Partner events biedt ook een intuïtievere gebruikerservaring waarmee u uw service eenvoudig kunt ontdekken.
U hebt een eenvoudig model met meerdere tenants nodig waarin u gebeurtenissen publiceert naar één regionaal eindpunt, het eindpunt van de naamruimte, om de gebeurtenissen naar verschillende klanten te routeren.
U wilt inzicht hebben in metrische gegevens met betrekking tot gepubliceerde gebeurtenissen.
U wilt het schema Cloud Events 1.0 gebruiken voor uw gebeurtenissen.

Voor partners als abonnee

U wilt dat uw service reageert op klantevenementen die afkomstig zijn uit Microsoft Azure.
U wilt dat uw klant reageert op Microsoft Azure-servicegebeurtenissen met behulp van hun toepassingen die door uw platform worden gehost. U gebruikt de mogelijkheden voor het routeren van gebeurtenissen van uw platform om gebeurtenissen aan de juiste klantoplossing te leveren.
U wilt een eenvoudig model waarin uw klanten alleen uw servicenaam als bestemming selecteren zonder dat ze technische details zoals uw platformeindpunten hoeven te kennen.
Uw systeem/platform ondersteunt Cloud Events 1.0-schema .

Resources die worden beheerd door partners

Als partner beheert u de volgende typen resources.

Partnerregistratie

Een registratie bevat algemene informatie met betrekking tot een partner. Er is een registratie vereist bij het maken van een partnernaamruimte. Dat wil gezegd, u moet een partnerregistratie hebben om de benodigde Azure-resources te maken die moeten worden geïntegreerd met Azure Event Grid.

Registraties zijn globaal. Dat wil gezegd, ze zijn niet gekoppeld aan een bepaalde Azure-regio. U kunt één partnerregistratie maken en deze gebruiken bij het maken van uw partnernaamruimten.

Channel

Een kanaal is een geneste resource voor een partnernaamruimte. Een kanaal heeft twee hoofddoeleinden:

Dit is het resourcetype waarmee u partnerresources kunt maken voor het Azure-abonnement van een klant. Wanneer u een kanaal van het type partner topicmaakt, wordt er een partneronderwerp gemaakt op het Azure-abonnement van een klant. Een partneronderwerp is de resource van een klant waarnaar gebeurtenissen worden doorgestuurd wanneer een partnersysteem gebeurtenissen publiceert.

Een kanaal heeft dezelfde levenscyclus als het bijbehorende onderwerp of doel van de klantpartner. Wanneer een kanaal van het type partner topic wordt verwijderd, wordt bijvoorbeeld het partneronderwerp van de gekoppelde klant verwijderd. Als het partneronderwerp door de klant wordt verwijderd, wordt het bijbehorende kanaal in uw Azure-abonnement verwijderd.
Het is een resource die wordt gebruikt om gebeurtenissen te routeren. Een kanaal van het type partner topic wordt gebruikt om gebeurtenissen te routeren naar het partneronderwerp van een klant. Het ondersteunt twee typen routeringsmodi.
- Kanaalnaamroutering. Met dit type routering publiceert u gebeurtenissen met behulp van een HTTP-header met de naam aeg-channel-name van het kanaal waarnaar gebeurtenissen moeten worden gerouteerd. Aangezien kanalen de weergave van partneronderwerpen zijn, worden de gebeurtenissen die naar het kanaal worden doorgestuurd, weergegeven in het onderwerp van de klant. Dit type routering is een nieuwe mogelijkheid die niet aanwezig is, event channelswaardoor alleen op bron gebaseerde routering wordt ondersteund. Routering van kanaalnamen maakt meer gebruiksvoorbeelden mogelijk dan de op bron gebaseerde routering en het is de aanbevolen routeringsmodus om te kiezen. Met kanaalnaamroutering kan een klant bijvoorbeeld gebeurtenissen aanvragen die afkomstig zijn uit verschillende gebeurtenisbronnen om te landen op één partneronderwerp.
- Routering op basis van bron. Deze routeringsbenadering is gebaseerd op de waarde van het source contextkenmerk in de gebeurtenis. Bronnen worden toegewezen aan kanalen en wanneer een gebeurtenis wordt geleverd met een bron, bijvoorbeeld 'A' die gebeurtenis wordt doorgestuurd naar het partneronderwerp dat is gekoppeld aan het kanaal dat 'A' bevat in de broneigenschap.
Mogelijk wilt u de gebeurtenistypen declareren die naar het kanaal worden gerouteerd en naar het bijbehorende partneronderwerp. Gebeurtenistypen worden weergegeven voor klanten bij het maken van gebeurtenisabonnementen op het partneronderwerp en worden gebruikt om de specifieke gebeurtenistypen te selecteren die naar een gebeurtenis-handlerbestemming moeten worden verzonden. Meer informatie.

Belangrijk

Gebeurtenistypen kunnen worden beheerd in het kanaal en zodra de waarden zijn bijgewerkt, worden wijzigingen onmiddellijk doorgevoerd in het bijbehorende partneronderwerp.

Partnernaamruimte

Een partnernaamruimte is een regionale resource die een eindpunt heeft voor het publiceren van gebeurtenissen naar Azure Event Grid. Partnernaamruimten bevatten kanalen of gebeurteniskanalen (verouderde resource). U moet partnernaamruimten maken in regio's waar klanten partneronderwerpen of bestemmingen aanvragen, omdat kanalen en de bijbehorende partnerresources zich in dezelfde regio moeten bevinden. U kunt geen kanaal in een bepaalde regio hebben met het bijbehorende partneronderwerp, bijvoorbeeld in een andere regio.

Partnernaamruimten bevatten kanalen of gebeurteniskanalen. Dit wordt bepaald door de routeringsmodus van het eigenschapspartneronderwerp in de naamruimte. Als deze is ingesteld op kanaalnaamheader, zijn kanalen het enige type resource dat kan worden gemaakt onder de naamruimte. Als de routeringsmodus voor partneronderwerp is ingesteld op bronkenmerk in gebeurtenis, kan de naamruimte alleen gebeurteniskanalen bevatten. Houd er rekening mee dat de beslissing om het recht in partner topic routing mode te stellen geen beslissing is tussen het kiezen van kanaalnaam of routering op basis van bron. Kanalen ondersteunen beide. Het is eerder een beslissing tussen het gebruik van het nieuwe type routeringsresource, de kanalen, versus het gebruik van een verouderde resource, de gebeurteniskanalen.

Gebeurteniskanaal

Een gebeurteniskanaal is de resource die voor het eerst is uitgebracht met partnergebeurtenissen om binnenkomende gebeurtenissen naar partneronderwerpen te routeren. Gebeurteniskanalen ondersteunen alleen routering op basis van bronnen en ze vertegenwoordigen altijd een klantpartneronderwerp.

Belangrijk

Gebeurteniskanalen worden afgeschaft. Daarom wordt u aangeraden kanalen te gebruiken.

Geverifieerde partners

Een geverifieerde partner is een partnerorganisatie waarvan de identiteit door Microsoft is gevalideerd. Het wordt sterk aangeraden dat uw organisatie wordt geverifieerd. Klanten willen contact opnemen met partners die als dergelijke verificatie zijn geverifieerd, bieden meer zekerheid dat ze te maken hebben met een legitieme organisatie. Zodra dit is geverifieerd, profiteert u van een aanwezigheid in de Event Grid-galerie , waar klanten uw service eenvoudig kunnen detecteren en een ervaring van een eerste partij kunnen hebben bij het abonneren op uw gebeurtenissen, bijvoorbeeld.

Autorisatie van de klant voor het maken van partneronderwerpen

Klanten machtigen u om partneronderwerpen te maken in hun Azure-abonnement. De autorisatie wordt verleend voor een bepaalde resourcegroep in een Azure-abonnement van een klant en het is tijdsgebonden. U moet het kanaal maken voordat de vervaldatum is ingesteld door de klant. U moet documentatie hebben die de klant een voldoende tijdsperiode voorstelt voor het configureren van uw systeem voor het verzenden of ontvangen van gebeurtenissen en het maken van het kanaal voordat de autorisatie verloopt. Als u een kanaal probeert te maken zonder autorisatie of nadat het is verlopen, mislukt het maken van het kanaal en wordt er geen resource gemaakt in het Azure-abonnement van de klant.

Notitie

Event Grid is begonnen met het afdwingen van autorisatiecontroles voor het maken van partneronderwerpen rond 30 juni 2022. Uw documentatie moet uw klanten vragen om u de autorisatie als vereiste te verlenen voordat u een kanaal maakt.

Belangrijk

Een geverifieerde partner is geen geautoriseerde partner. Zelfs als een partner is gecontroleerd door Microsoft, moet u nog steeds gemachtigd zijn voordat u een partneronderwerp kunt maken in het Azure-abonnement van de klant.

Activering van partneronderwerp

De klant activeert het partneronderwerp of de bestemming die u voor hen hebt gemaakt. Op dat moment wordt de activeringsstatus van het kanaal gewijzigd in Geactiveerd. Zodra een kanaal is geactiveerd, kunt u beginnen met het publiceren van gebeurtenissen naar het eindpunt van de partnernaamruimte dat het kanaal bevat.

Hoe automatiseert u het proces om te weten wanneer u gebeurtenissen voor een bepaald partneronderwerp kunt publiceren?

U hebt twee opties:

Lees de kanaalstatus periodiek (poll) om te controleren of de activeringsstatus is overgegaan van NeverActivated naar Geactiveerd. Deze bewerking kan rekenintensief zijn.
Maak een gebeurtenisabonnement voor het Azure-abonnement of de resourcegroep die de kanalen bevat die u wilt bewaken. U ontvangt Microsoft.Resources.ResourceWriteSuccess gebeurtenissen wanneer een kanaal wordt bijgewerkt. Vervolgens moet u de status van het kanaal lezen met de Azure Resource Manager-id die is opgegeven in het geval dat de update is gerelateerd aan een wijziging in de activeringsstatus in Geactiveerd.

Share via