Onboarding als Azure Event Grid-Partner mithilfe des Azure-Portals

In diesem Artikel wird beschrieben, wie SaaS-Anbieter von Drittanbietern, auch bekannt als Partner , in Event Grid integriert werden, um Ereignisse aus ihren Diensten veröffentlichen und wie diese Ereignisse von Endbenutzern genutzt werden.

Onboardingprozess für Partner

Kurz gesagt, die Aktivierung der Ereignisse Ihres Diensts für die Nutzung durch Benutzer umfasst in der Regel den folgenden Prozess:

1. Kommunizieren Sie Ihr Interesse daran, Partner des Event Grid-Serviceteams zu werden.

2. Registrieren Sie den Event Grid-Ressourcenanbieter bei Ihrem Azure-Abonnement.

3. Erstellen Sie eine Partnerregistrierung.

4. Erstellen Sie einen Namespace.

5. Erstellen Sie einen Kanal und ein Partnerthema in einem einzigen Schritt.

   Von Bedeutung

   Möglicherweise können Sie einen Ereigniskanal (Legacy) erstellen, der Partnerthemen unterstützt. Channel ist der neue Typ einer Routingressource und die bevorzugte Option, die das Senden von Ereignissen über Partner-Topics unterstützt. Ein Ereigniskanal ist eine Legacyressource und wird bald veraltet sein.

6. Testen Sie die Funktionalität von Partnerereignissen bis zum Ende.

Für Schritt 5 sollten Sie entscheiden, welche Art von Benutzererfahrung Sie bereitstellen möchten. Sie haben die folgenden Optionen:

• Stellen Sie Ihre eigene Lösung bereit, in der Regel eine grafische Benutzeroberfläche (GUI) im Web, die mit unserem SDK und/oder der REST-API unter Ihrer Domäne gehostet wird, um einen Kanal (neueste und empfohlene Kanäle) /Event Channel (Legacy) und sein entsprechendes Partnerthema zu erstellen. Mit dieser Option können Sie den Benutzer nach der Abonnement- und Ressourcengruppe fragen, unter der Sie ein Partnerthema erstellen.
• Verwenden Sie das Azure-Portal oder die CLI, um den Kanal (empfohlen)/Ereigniskanal (Legacy) und ein zugehöriges Partnerthema zu erstellen. Mit dieser Option müssen Sie irgendwie Zugriff auf das Azure-Abonnement des Benutzers sowie die Ressourcengruppe erhalten, unter der Sie ein Partnerthema erstellen.

In diesem Artikel erfahren Sie, wie Sie das Onboarding als Azure Event Grid-Partner mithilfe des Azure-Portals durchführen.

Kommunizieren Sie Ihr Interesse daran, Partner zu werden

Wenden Sie sich unter askgrid@microsoft.com an das Event Grid-Team, um Ihr Interesse zu kommunizieren, Partner zu werden. Wir werden eine Unterhaltung mit Ihnen führen, die detaillierte Informationen zu den Anwendungsfällen von Partnerereignissen, Personas, Onboardingprozess, Funktionalität, Preisen und mehr bereitstellt.

Voraussetzungen

Um die verbleibenden Schritte auszuführen, stellen Sie sicher, dass Sie folgendes haben:

• Ein Azure-Abonnement. Falls Sie kein Abonnement besitzen, können Sie ein kostenloses Konto erstellen, bevor Sie beginnen.
• Ein Azure-Mandant.

Registrieren des Event Grid-Ressourcenanbieters

Sofern Sie Event Grid nicht bereits zuvor genutzt haben, müssen Sie den Event Grid-Ressourcenanbieter registrieren. Wenn Sie Event Grid bereits eingesetzt haben, fahren Sie mit dem nächsten Abschnitt fort.

Führen Sie im Azure-Portal folgende Schritte aus:

1. Wählen Sie im linken Menü Abonnements aus.

2. Wählen Sie das Abonnement, das Sie für Event Grid verwenden möchten, aus der Abonnementliste aus.

3. Wählen Sie auf der Seite Abonnement unter Einstellungen im linken Menü Ressourcenanbieter aus.

4. Suchen Sie nach Microsoft.EventGrid, und vergewissern Sie sich, dass der StatusNicht registriert lautet.

5. Wählen Sie Microsoft.EventGrid in der Anbieterliste aus.

6. Wählen Sie Registrieren auf der Befehlsleiste aus.

   

7. Aktualisieren Sie, um sicherzustellen, dass der Status von Microsoft.EventGrid in Registriert geändert wird.

   

Erstellen einer Partnerregistrierung

1. Melden Sie sich beim Azure-Portal an.

2. Wählen Sie im linken Navigationsbereich "Alle Dienste " aus, geben Sie dann in der Suchleiste " Event Grid Partner Registrations" ein, und wählen Sie ihn aus.

3. Wählen Sie auf der Seite "Event Grid Partner Registrations " die Option "+Erstellen " auf der Befehlsleiste oder link " Event Grid-Partnerregistrierungen erstellen " auf der Seite aus.

   

4. Geben Sie auf der Seite "Erstellen Partner-Thema-Typ-Registrierungen - Grundlagen" die folgenden Informationen ein:

   1. Führen Sie im Abschnitt "Projektdetails " die folgenden Schritte aus:
      1. Wählen Sie Ihr Azure-Abonnement aus.
      2. Wählen Sie eine vorhandene Azure-Ressourcengruppe aus, oder erstellen Sie eine neue Ressourcengruppe.
   2. Führen Sie im Abschnitt "Registrierungsdetails " die folgenden Schritte aus:
      1. Geben Sie für den Registrierungsnamen einen Namen für die Registrierung ein.
      2. Geben Sie für den Organisationsnamen den Namen Ihrer Organisation ein.
   3. Geben Sie im Abschnitt " Partner-Ressourcentyp " Details zu Ihrem Ressourcentyp ein, der auf der Seite zum Erstellen des Partnerthemas angezeigt wird:

      1. Geben Sie für partner-Ressourcentypnamen den Namen für den Ressourcentyp ein.

      2. Geben Sie für den Anzeigenamen einen benutzerfreundlichen Anzeigenamen für den Partnerthematyp (Ressource) ein.

      3. Geben Sie eine Beschreibung für den Ressourcentyp ein.

      4. Geben Sie eine Beschreibung für das Szenario ein. Er sollte die Möglichkeiten oder Szenarien erläutern, in denen die Partnerthemen für Ihre Ressourcen verwendet werden können.

         

5. Wählen Sie "Weiter" aus: Benutzerdefinierter Dienst am unteren Rand der Seite. Geben Sie auf der Registerkarte " Kundendienst erstellen" auf der Seite " Partnerregistrierung erstellen " Informationen ein, die Abonnentenbenutzer verwenden, um Sie zu kontaktieren, wenn ein Problem mit der Ereignisquelle auftritt:

   1. Geben Sie die Telefonnummer ein.

   2. Geben Sie die Durchwahl ein.

   3. Geben Sie eine Supportwebsite-URL ein.

      

6. Wählen Sie "Weiter" aus: Tags am unteren Rand der Seite.

7. Konfigurieren Sie auf der Seite "Tags " die folgenden Werte.

   1. Geben Sie einen Namen und einen Wert für das Tag ein, das Sie hinzufügen möchten. Dieser Schritt ist optional.
   2. Wählen Sie "Überprüfen" und "Erstellen" am unteren Rand der Seite aus, um die Registrierung (Partnerthematyp) zu erstellen.

8. Überprüfen Sie auf der Seite "Überprüfen + Erstellen " alle Einstellungen, und wählen Sie dann "Erstellen" aus, um die Partnerregistrierung zu erstellen.

Erstellen eines Partnernamespaces

1. Wählen Sie im Azure-Portal im linken Navigationsmenü "Alle Dienste " aus, geben Sie dann "Event Grid Partner Namespaces" in die Suchleiste ein, und wählen Sie sie dann aus der Liste aus.

2. Wählen Sie auf der Seite "Event Grid Partner Namespaces " die Option +Erstellen auf der Symbolleiste aus.

   

3. Geben Sie auf der Seite „Partnernamespace – Basisinformationen“ die folgenden Informationen an.

   1. Führen Sie im Abschnitt "Projektdetails " die folgenden Schritte aus:

      1. Wählen Sie ein Azure-Abonnement aus.
      2. Wählen Sie eine vorhandene Ressourcengruppe aus, oder erstellen Sie eine Ressourcengruppe.

   2. Führen Sie im Abschnitt "Namespacedetails " die folgenden Schritte aus:

      1. Geben Sie einen Namen für den Namespace ein.

      2. Wählen Sie einen Ort für den Namespace aus.

      3. Wählen Sie im Routingmodus für Partnerthemen den Kanalnamen-Header oder das Quellattribut im Ereignis aus.

         • Kanalname-Header-Routing: Mit dieser Art von Routing veröffentlichen Sie Ereignisse mithilfe eines HTTP-Headers, bei dem Sie den Namen des Kanals angeben, an den die Ereignisse weitergeleitet werden sollen. Wenn Sie diese Option auswählen, erstellen Sie Kanäle im Namespace.
         • Quell-Attribut im Ereignisrouting . Dieser Routingansatz basiert auf dem Wert des source Kontextattributes im Ereignis. Wenn Sie diese Option auswählen, erstellen Sie Ereigniskanäle, die älteren Kanälen entsprechen und in Kürze veraltet sind.

         Von Bedeutung

         • Es ist nicht möglich, den Routingmodus zu aktualisieren, nachdem der Namespace erstellt wurde.
         • Kanal ist der neue Routingressourcentyp und ist die bevorzugte Option. Ein Ereigniskanal ist eine veraltete Ressource und wird bald eingestellt.

   3. Führen Sie im Abschnitt "Registrierungsdetails " die folgenden Schritte aus, um den Namespace einer Partnerregistrierung zuzuordnen.

      1. Wählen Sie das Abonnement aus, in dem die Partnerregistrierung vorhanden ist.
      2. Wählen Sie die Ressourcengruppe aus, die die Partnerregistrierung enthält.
      3. Wählen Sie die Partnerregistrierung aus der Dropdownliste aus.

   4. Wählen Sie "Weiter" aus: Tags am unteren Rand der Seite.

      

4. Fügen Sie auf der Seite "Tags" Tags hinzu (optional).

   1. Geben Sie einen Namen und einen Wert für das Tag ein, das Sie hinzufügen möchten. Dieser Schritt ist optional.
   2. Wählen Sie am unteren Rand der Seite die Option Bewerten + erstellen aus.

5. Überprüfen Sie auf der Seite "Überprüfen + Erstellen " die Details, und wählen Sie " Erstellen" aus.

Erstellen eines Kanals

Falls Sie Kanalname-Header für den Modus zum Routing von Partnerthemen ausgewählt haben, erstellen Sie einen Kanal, indem Sie die Schritte in diesem Abschnitt ausführen.

1. Wechseln Sie zur Übersichtsseite des von Ihnen erstellten Partnernamespaces, und wählen Sie auf der Befehlsleiste +Kanal aus.

   

2. Führen Sie auf der Seite "Kanal erstellen – Grundlagen" die folgenden Schritte aus.

   1. Geben Sie einen Namen für den Kanal ein. Der Kanalname sollte in der Region eindeutig sein, in der er erstellt wird.

   2. Wählen Sie für den Kanaltyp " Partnerthema" aus.

      Partnerthemen sind Ressourcen, die veröffentlichte Ereignisse enthalten. Wählen Sie "Partnerthema " aus, wenn Sie Ereignisse an ein Partnerthema weiterleiten möchten, das Ereignisse enthält, die später von einem Handler verarbeitet werden sollen.

   3. Wenn Sie das Partnerthema ausgewählt haben, geben Sie die folgenden Details ein:

      1. ID des Abonnements , in dem das Partnerthema erstellt wird.

      2. Ressourcengruppe , in der das Partnerthema erstellt wird.

      3. Name des Partnerthemas.

      4. Geben Sie Quellinformationen für das Partnerthema an. Die Quelle sind kontextbezogene Informationen zur Quelle von Ereignissen, die vom Partner bereitgestellt wird, die der Endbenutzer sehen kann. Diese Informationen sind hilfreich, wenn Endbenutzer beispielsweise die Aktivierung eines Partnerthemas in Betracht ziehen.

         

      5. Wählen Sie "Ereignistypdefinitionen hinzufügen" aus, um die Art von Ereignissen zu deklarieren, die an den Kanal und das zugehörige Partnerthema gesendet 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.

         

         

         

   4. Wählen Sie "Weiter" aus: Link "Zusätzliche Features " am unteren Rand der Seite.

   5. Führen Sie auf der Seite "Zusätzliche Features " die folgenden Schritte aus:

      1. Aktivieren Sie das Kontrollkästchen neben " Eigene Aktivierungsnachricht festlegen", um den Endbenutzern beim Aktivieren des zugehörigen Partnerthemas zu helfen, und geben Sie die Nachricht ein.
      2. Legen Sie für Ablaufzeit den Zeitpunkt fest, zu dem nach der Erstellung dieses Kanals das zugehörige Partnerthema und dieser Kanal automatisch gelöscht werden, falls sie nicht vom Endbenutzer aktiviert werden. 1. Wählen Sie Weiter: Überprüfen und Erstellen.

      

   6. Überprüfen Sie auf der Seite " Überprüfen + Erstellen " alle Einstellungen für den Kanal, und wählen Sie " Erstellen " am unteren Rand der Seite aus.

      Partnerthema-Option:

Verwalten eines Kanals

Wenn Sie einen Kanal erstellt haben, können Sie die Konfiguration aktualisieren, nachdem die Ressource erstellt wurde.

1. Wechseln Sie zur Konfiguration im Kanal. Sie können die Nachricht für die Aktivierung des Partnerthemas, das Verfallsdatum im Falle einer Nichtaktivierung und die Definitionen der Ereignistypen aktualisieren.

   

Erstellen eines Ereigniskanals

Wenn Sie Quellattribut im Ereignis als Partnerthemen-Routingmodus ausgewählt haben, erstellen Sie einen Ereigniskanal, indem Sie die folgenden Schritte in diesem Abschnitt ausführen.

1. Wechseln Sie zur Übersichtsseite des erstellten Namespaces.

   partner-namespace-overview.png

2. Wählen Sie auf der Symbolleiste + Ereigniskanal aus.

3. Geben Sie auf der Seite "Ereigniskanal erstellen – Grundlagen" die folgenden Informationen an.

   1. Führen Sie im Abschnitt "Kanaldetails " die folgenden Schritte aus:

      1. Geben Sie für den Ereigniskanalnamen einen Namen für den Ereigniskanal ein.
      2. Geben Sie die Quelle ein. Unter Cloud Events 1.0-Spezifikationen erhalten Sie eine Vorstellung von einem geeigneten Wert für die Quelle. Sehen Sie sich auch dieses Schema-Beispiel für Cloud Events an.

   2. Geben Sie im Abschnitt "Zieldetails " Details für das Zielpartnerthema ein, das für diesen Ereigniskanal erstellt wird.

      1. Geben Sie die ID des Abonnements ein, in dem das Partnerthema erstellt wird.
      2. Geben Sie den Namen der Ressourcengruppe ein, in der die Partnerthemaressource erstellt wird.
      3. Geben Sie einen Namen für das Partnerthema ein.

   3. Wählen Sie "Weiter" aus: Filter am unteren Rand der Seite.

      

4. Fügen Sie auf der Seite "Filter" Filter hinzu. führen Sie folgende Schritte aus:

   1. Filtern Sie nach Attributen der einzelnen Ereignisse. Nur Ereignisse, die mit allen Filtern übereinstimmen, werden übermittelt. Bis zu 25 Filter können angegeben werden. Bei den Vergleichen wird die Groß-/Kleinschreibung nicht beachtet. Gültige Schlüssel, die für Filter verwendet werden, variieren je nach Ereignisschema. Im folgenden Beispiel können eventid, source, eventtype und eventtypeversioin für Tasten verwendet werden. Sie können auch benutzerdefinierte Eigenschaften innerhalb der Nutzdaten verwenden, indem Sie . als Schachtelungsoperator verwenden. Beispiel: data, data.key, data.key1.key2.

   2. Wählen Sie "Weiter" aus: Zusätzliche Features am unteren Rand der Seite.

      

5. Auf der Seite "Zusätzliche Features " können Sie eine Ablaufzeit und eine Beschreibung für das Partnerthema festlegen.

   1. Die Ablaufzeit ist der Zeitpunkt, zu dem das Thema und der zugehörige Ereigniskanal automatisch gelöscht werden, wenn er nicht vom Kunden aktiviert wird. Für den Fall, dass keine Zeit angegeben wird, wird ein Standardwert von sieben Tagen verwendet. Aktivieren Sie das Kontrollkästchen, um Ihre eigene Ablaufzeit anzugeben.

   2. Da es sich bei diesem Thema um eine Ressource handelt, die nicht vom Benutzer erstellt wird, kann eine Beschreibung dem Benutzer dabei helfen, die Art dieses Themas zu verstehen. Wenn keines festgelegt ist, wird eine generische Beschreibung bereitgestellt. Aktivieren Sie das Kontrollkästchen, um die Beschreibung Ihres eigenen Partnerthemas festzulegen.

   3. Klicken Sie auf Weiter: Überprüfen + erstellen.

      

6. Überprüfen Sie auf "Überprüfen+ erstellen" die Einstellungen, und wählen Sie "Erstellen" aus, um den Ereigniskanal zu erstellen.

Aktivieren von Partnerthemen

Bevor Ihre Benutzer Partnerthemen abonnieren können, die Sie in ihren Azure-Abonnements erstellen, haben sie zuerst Partnerthemen aktiviert. Ausführliche Informationen finden Sie unter Aktivieren eines Partnerthemas.

Nächste Schritte

Weitere Informationen zum Feature "Partnerereignisse" finden Sie in den folgenden Artikeln:

• Übersicht über Partnerereignisse für Kunden
• Übersicht über Partnerereignisse für Partner
• Abonnieren von Partnerereignissen
• Abonnieren von Auth0-Ereignissen