Übersicht über Partnerereignisse für Partner – Azure Event Grid

Artikel
04/12/2023

Die Partnerereignisse von Event Grid ermöglichen es Kunden, Ereignisse zu abonnieren, die aus einem registrierten System kommen, wobei derselbe Mechanismus verwendet wird wie für alle anderen Ereignisquellen in Azure, z. B. ein Azure-Dienst. Diese registrierten Systeme, die in Event Grid integriert sind, werden als „Partner“ bezeichnet. Dieses Feature ermöglicht es Kunden auch, Ereignisse an Partnersysteme zu senden, die das Empfangen und Weiterleiten von Ereignissen an die Lösungen/Endpunkte des Kunden in ihrer Plattform unterstützen. In der Regel sind Partner SaaS- (Software-as-a-Service) oder ERP-Anbieter. Sie können aber auch Unternehmensplattformen sein, die ihre Ereignisse internen Teams zur Verfügung stellen möchten. Sie sind absichtlich in Event Grid integriert, um durchgängige Anwendungsfälle für Kunden realisieren zu können, die in Azure enden (Kunden abonnieren Ereignisse, die vom Partner gesendet werden) oder in einem Partnersystem enden (Kunden abonnieren Microsoft-Ereignisse, die von Azure Event Grid gesendet werden). Kunden verwenden Azure Event Grid, um von einem Partner veröffentlichte Ereignisse an unterstützte Ziele wie beispielsweise Webhooks, Azure Functions, Azure Event Hubs oder Azure Service Bus u. a. zu senden. Kund*innen sind auch darauf angewiesen, dass Azure Event Grid Ereignisse, die in Microsoft-Diensten wie Outlook, Teams oder Microsoft Entra ID entstehen, weiterzuleiten, sodass die Lösungen der Kundschaft auf sie reagieren können. Mit Partnerereignissen können Kunden ereignisgesteuerte Lösungen über Plattformen und Netzwerkgrenzen hinweg erstellen, um Ereignisse zuverlässig, sicher und in großem Umfang zu empfangen oder zu senden.

Hinweis

Dies ist ein konzeptioneller Artikel, den Sie durchlesen müssen, bevor Sie sich als Partner für Azure Event Grid entscheiden. Eine Schritt-für-Schritt-Anleitung für das Onboarding als Event Grid-Partner im Azure-Portal finden Sie unter Onboarding als Event Grid-Partner im Azure-Portal.

Partnerereignisse: Funktionsweise

Als Partner erstellen Sie Event Grid-Ressourcen, mit denen Sie Ereignisse in Azure Event Grid veröffentlichen können, damit Kunden in Azure diese abonnieren können. Für die meisten Partner, z. B. SaaS-Anbieter, ist dies die einzige verwendete Integrationsfunktion.

Sie können auch Event Grid-Ressourcen erstellen, um Ereignisse von Azure Event Grid zu empfangen. Dieser Anwendungsfall ist für Organisationen gedacht, die eine Plattform besitzen oder verwalten, die ihren Kunden den Empfang von Ereignissen ermöglicht, indem entsprechende Endpunkte verfügbar gemacht werden. Einige dieser Organisationen sind ERP-Systeme, die auch über Ereignisroutingfunktionen innerhalb der jeweiligen Plattform verfügen, die eingehende Azure-Ereignisse an eine auf der Plattform gehostete Kundenanwendung sendet.

Wenn Sie Ereignisse veröffentlichen oder Ereignisse empfangen möchten, erstellen Sie dieselbe Art von Event Grid-Ressourcen, indem Sie diese allgemeinen Schritte ausführen.

Wenden Sie sich unter askgrid@microsoft.com an das Event Grid-Team, um Ihr Interesse zu kommunizieren, Partner zu werden. Nachdem Sie uns kontaktiert haben, führen wir Sie durch den Onboardingprozess und unterstützen Sie dabei, eine Eintrittskarte für Ihren Service in unseren Azure Event Grid-Katalog zu erhalten, damit Ihr Dienst im Azure-Portal gefunden werden kann.
Erstellen Sie eine Partnerregistrierung. Hierbei handelt es sich um eine globale Ressource, die Sie normalerweise einmal erstellen müssen.
Erstellen Sie einen Partnernamespace. Diese Ressource macht einen Endpunkt verfügbar, an den Sie Ereignisse in Azure veröffentlichen können. Geben Sie beim Erstellen des Partnernamespaces die erstellte Partnerregistrierung an.
Der Kunde autorisiert Sie, ein Partnerthema im Azure-Abonnement des Kunden zu erstellen.
Der Kunde greift auf Ihre Webseite zu oder führt einen Befehl aus (Sie definieren die Benutzerfunktionalität), um anzufordern, ob Ihre Ereignisse an Azure übertragen werden sollen oder Microsoft-Ereignisse in Ihrem System empfangen werden können. Als Reaktion auf diese Anforderung richten Sie Ihr abhängig von der Eingabe des Kunden entsprechend ein. Der Kunde kann beispielsweise die Möglichkeit erhalten, bestimmte Ereignisse in Ihrem System auszuwählen, die an Azure weitergeleitet werden sollen.
Erstellen Sie ein Partnerthema im Azure-Abonnement und der Ressourcengruppe des Kunden mithilfe von Kanälen. Kanäle sind Ressourcen, die in Partnernamespaces enthalten sind.
Der Kunde aktiviert das Partnerthema, das Sie in seinem Azure-Abonnement und seiner Ressourcengruppe erstellt haben.
Starten Sie die Veröffentlichung von Ereignissen in Ihrem Partnernamespace.

Hinweis

Sie müssen den Azure Event Grid-Ressourcenanbieter für jedes Azure-Abonnement registrieren, in dem Sie Event Grid-Ressourcen erstellen möchten. Andernfalls können keine Ressourcen erstellt werden.

Was spricht für das Feature „Partnerereignisse“?

Das Feature „Partnerereignisse“ kommt für Sie in Frage, wenn Sie eine oder mehrere der folgenden Anforderungen haben.

Für Partner als Herausgeber von Ereignissen

Sie wünschen sich einen Mechanismus, um Kunden Ihre Ereignisse in Azure verfügbar zu machen. Ihre Benutzer können diese Ereignisse filtern und weiterleiten, indem sie Partnerthemen und Ereignisabonnements verwenden, die sie besitzen und verwalten. Sie können auch andere Integrationsansätze verwenden, z. B. Themen und Domänen. Diese Ansätze würden jedoch keine saubere Trennung von Ressourcenbesitz, Verwaltung und Abrechnung zwischen Ihnen und Ihrem Kunden ermöglichen. Das Feature „Partnerereignisse“ bietet auch eine intuitivere Benutzerfunktionalität, die es einfacher macht, Ihren Dienst zu finden.
Sie benötigen ein einfaches Mehrmandantenmodell, in dem Sie Ereignisse auf einem einzelnen regionalen Endpunkt veröffentlichen, dem Endpunkt des Namespaces, um die Ereignisse an verschiedene Kunden weiterzuleiten.
Sie möchten einen Einblick in Metriken haben, die sich auf veröffentlichte Ereignisse beziehen.
Sie möchten das Schema Cloud Events 1.0 für Ihre Ereignisse verwenden.

Für Partner als Abonnent

Sie möchten, dass Ihr Dienst auf Kundenereignisse reagiert, die von Microsoft Azure kommen.
Sie möchten, dass Ihr Kunde mit seinen Anwendungen, die von Ihrer Plattform gehostet werden, auf Microsoft Azure-Dienstereignisse reagiert. Sie verwenden die Ereignisroutingfunktionen Ihrer Plattform, um Ereignisse an die richtige Kundenlösung zu liefern.
Sie möchten ein einfaches Modell, bei dem Ihre Kunden lediglich Ihren Dienstnamen als Ziel auswählen, ohne dass sie technische Details, z. B. Ihre Plattformendpunkte, kennen müssen.
Ihr System/Ihre Plattform unterstützt das Cloud Events 1.0-Schema.

Von Partnern verwaltete Ressourcen

Als Partner verwalten Sie die folgenden Ressourcentypen.

Partnerregistrierung

Eine Registrierung enthält allgemeine Informationen zu einem Partner. Beim Erstellen eines Partnernamespaces ist eine Registrierung erforderlich. Das heißt, Sie müssen über eine Partnerregistrierung verfügen, um die erforderlichen Azure-Ressourcen für die Integration in Azure Event Grid zu erstellen.

Registrierungen sind global. Das heißt, dass sie keiner bestimmten Azure-Region zugeordnet sind. Sie können eine einzelne Partnerregistrierung erstellen und diese beim Erstellen Ihrer Partnernamespaces verwenden.

Channel

Ein Kanal ist eine geschachtelte Ressource für einen Partnernamespace. Ein Kanal erfüllt zwei Hauptzwecke:

Er ist der Ressourcentyp, mit dem Sie Partnerressourcen im Azure-Abonnement eines Kunden erstellen können. Wenn Sie einen Kanal vom Typ partner topic erstellen, wird ein Partnerthema im Azure-Abonnement eines Kunden erstellt. Ein Partnerthema ist die Ressource eines Kunden, an die Ereignisse weitergeleitet werden, wenn ein Partnersystem Ereignisse veröffentlicht.

Ein Kanal hat denselben Lebenszyklus wie sein zugehöriges Kundenpartnerthema oder -ziel. Wenn z. B. ein Kanal vom Typ partner topic gelöscht wird, wird auch das zugehörige Partnerthema des Kunden gelöscht. Wenn das Partnerthema vom Kunden gelöscht wird, wird genauso auch der zugehörige Kanal in Ihrem Azure-Abonnement gelöscht.
Er ist eine Ressource, die zum Weiterleiten von Ereignissen verwendet wird. Ein Kanal vom Typ partner topic wird verwendet, um Ereignisse an das Partnerthema eines Kunden weiterzuleiten. Es werden zwei verschiedene Routingmodi unterstützt.
- Kanalnamenrouting. Bei dieser Art von Routing veröffentlichen Sie Ereignisse mithilfe eines HTTP-Headers namens aeg-channel-name, in dem Sie den Namen des Kanals angeben, an den Ereignisse weitergeleitet werden sollen. Da Kanäle die Darstellung von Partnerthemen eines Partners sind, werden die an den Kanal weitergeleiteten Ereignisse im Partnerthema des Kunden angezeigt. Diese Art von Routing ist eine neue Funktion, die nicht in event channels vorhanden ist. Dort wird nur quellbasiertes Routing unterstützt. Das Kanalnamenrouting ermöglicht mehr Anwendungsfälle als das quellbasierte Routing, und wird daher als Routingmodus empfohlen. Beim Kanalnamenrouting kann beispielsweise ein Kunde fordern, das Ereignisse aus verschiedenen Ereignisquellen in einem einzelnen Partnerthema landen sollen.
- Quellbasiertes Routing. Dieser Routingansatz basiert auf dem Wert des source-Kontextattributes im Ereignis. Quellen werden Kanälen zugeordnet, und wenn ein Ereignis eine Quelle enthält, z. B. mit dem Wert „A“, wird dieses Ereignis an das Partnerthema weitergeleitet, das dem Kanal zugeordnet ist, der „A“ in seiner Quelleigenschaft enthält.
Möglicherweise möchten Sie die Ereignistypen deklarieren, die an den Kanal und an das zugehörige Partnerthema weitergeleitet werden. Ereignistypen werden Kunden beim Erstellen von Ereignisabonnements im Partnerthema angezeigt und werden verwendet, um die spezifischen Ereignistypen auszuwählen, die an ein Ereignishandlerziel gesendet werden sollen. Weitere Informationen

Wichtig

Ereignistypen können auf dem Kanal verwaltet werden und sobald die Werte aktualisiert wurden, werden Änderungen sofort im zugehörigen Partnerthema angezeigt.

Partnernamespace

Ein Partnernamespace ist eine regionale Ressource mit einem Endpunkt, um Ereignisse in Azure Event Grid zu veröffentlichen. Partnernamespaces enthalten entweder Kanäle oder Ereigniskanäle (Legacyressource). Sie müssen Partnernamespaces in Regionen erstellen, in denen Kunden Partnerthemen oder -ziele anfordern, da sich Kanäle und ihre entsprechenden Partnerressourcen in derselben Region befinden müssen. Ein Kanal in einer bestimmten Region, für den sich das zugehörige Partnerthema beispielsweise in einer anderen Region befindet, ist nicht möglich.

Partnernamespaces enthalten entweder Kanäle oder Ereigniskanäle. Er wird durch die Eigenschaft partner topic routing mode im Namespace bestimmt. Bei Einstellung auf Channel name header sind Kanäle der einzige Ressourcentyp, der unter dem Namespace erstellt werden kann. Wenn Source attribute in event als Routingmodus für Partnerthemen festgelegt wird, kann der Namespace nur Ereigniskanäle enthalten. Beachten Sie, dass die Entscheidung, den richtigen Wert für die Eigenschaft partner topic routing mode festzulegen, keine Entscheidung zwischen Kanalnamenrouting oder quellbasiertem Routing ist. Kanäle unterstützen beides. Es ist eher eine Entscheidung zwischen der Verwendung der neuartigen Routingressource – den Kanälen – und der Verwendung einer Legacyressource – den Ereigniskanälen.

Ereigniskanal

Ein Ereigniskanal ist die Ressource, die zuerst für Partnerereignisse veröffentlicht wurde, um eingehende Ereignisse an Partnerthemen weiterzuleiten. Ereigniskanäle unterstützen nur das quellbasierte Routing und stellen immer ein Kundenpartnerthema dar.

Wichtig

Ereigniskanäle gelten als veraltet. Daher wird empfohlen, Kanäle zu verwenden.

Verifizierte Partner

Ein verifizierter Partner ist eine Partnerorganisation, deren Identität von Microsoft überprüft wurde. Es wird dringend empfohlen, Ihre Organisation verifizieren zu lassen. Kunden bevorzugen Partner, die verifiziert wurden, da eine solche Überprüfung größere Sicherheit bietet, dass sie es mit einer rechtmäßigen Organisation zu tun haben. Nach der Überprüfung profitieren Sie von einer Präsenz im Event Grid-Katalog, in dem Kunden Ihren Dienst leicht finden und beim Abonnieren Ihrer Ereignisse beispielsweise Erfahrungen von Erstanwendern erhalten können.

Autorisierung des Kunden zum Erstellen von Partnerthemen

Kunden autorisieren Sie, Partnerthemen in ihrem Azure-Abonnement zu erstellen. Die Autorisierung wird für eine bestimmte Ressourcengruppe in einem Azure-Kundenabonnement erteilt und ist zeitlich gebunden. Sie müssen den Kanal vor dem vom Kunden festgelegten Ablaufdatum erstellen. Sie sollten über eine Dokumentation verfügen, die den Kunden ein angemessenes Zeitfenster zum Konfigurieren Ihres Systems zum Senden oder Empfangen von Ereignissen sowie zum Erstellen des Kanals vor Ablauf der Autorisierung vorschlägt. Wenn Sie versuchen, einen Kanal ohne Autorisierung oder nach Ablauf zu erstellen, schlägt die Kanalerstellung fehl, sodass keine Ressource im Azure-Abonnement des Kunden erstellt wird.

Hinweis

Seit ungefähr dem 30. Juni 2022 verlangt Event Grid Autorisierungsprüfungen zum Erstellen von Partnerthemen. Ihre Dokumentation sollte Ihre Kunden bitten, Ihnen Autorisierung als Voraussetzung zu erteilen, bevor Sie einen Kanal erstellen.

Wichtig

Ein verifizierter Partner ist kein autorisierter Partner. Selbst wenn ein Partner von Microsoft überprüft wurde, müssen Sie immer noch autorisiert werden, um ein Partnerthema im Azure-Abonnement des Kunden erstellen zu können.

Aktivierung des Partnerthemas

Der Kunde aktiviert das Partnerthema oder -ziel, das Sie für ihn erstellt haben. An diesem Punkt ändert sich der Aktivierungsstatus des Kanals in Activated. Sobald ein Kanal aktiviert wurde, können Sie mit der Veröffentlichung von Ereignissen auf dem Endpunkt des Partnernamespace beginnen, der den Kanal enthält.

Wie automatisieren Sie den Prozess, um festzustellen, wann Sie mit der Veröffentlichung von Ereignissen für ein bestimmtes Partnerthema beginnen können?

Sie haben zwei Möglichkeiten:

Regelmäßiges Lesen (Abfragen) des Kanalstatus, um zu überprüfen, ob der Aktivierungsstatus von NeverActivated in Activated geändert wurde. Dieser Vorgang kann rechenintensiv sein.
Erstellen eines Ereignisabonnements für das Azure-Abonnement oder die Ressourcengruppe mit den Kanälen, die Sie überwachen möchten. Sie erhalten Microsoft.Resources.ResourceWriteSuccess-Ereignisse, wenn ein Kanal aktualisiert wird. Anschließend müssen Sie den Status des Kanals mit der Azure Resource Manager-ID lesen, die im Ereignis bereitgestellt wird, um festzustellen, ob die Aktualisierung durch Änderung des Aktivierungsstatus in Activated erfolgt ist.