Onboarden als een Azure Event Grid-partner via de Azure Portal

In dit artikel wordt beschreven hoe externe SaaS-providers, ook wel bekend als partners , worden toegevoegd aan Event Grid om gebeurtenissen van hun services te kunnen publiceren en hoe deze gebeurtenissen door eindgebruikers worden gebruikt.

Belangrijk

Partners kunnen gebeurtenissen publiceren naar Azure Event Grid en er ook gebeurtenissen van ontvangen. Deze mogelijkheden worden ingeschakeld via de functie Partner events . Als u niet bekend bent met partnerevenementen, raadpleegt u het overzicht van partnerevenementen voor een gedetailleerde introductie van belangrijke concepten die essentieel zijn om te begrijpen en de stappen in dit artikel te volgen.

Onboardingproces voor partners

Kortom, het mogelijk maken dat de gebeurtenissen van uw dienst door gebruikers kunnen worden geconsumeerd, omvat doorgaans het volgende proces:

1. Communiceer uw interesse om partner te worden aan het Event Grid-serviceteam

2. Registreer de Event Grid-resourceprovider bij uw Azure-abonnement.

3. Maak een partnerregistratie.

4. Maak een naamruimte.

5. Maak in één stap een kanaal en een partneronderwerp.

   Belangrijk

   Mogelijk kunt u een gebeurteniskanaal (verouderd) maken dat ondersteuning biedt voor partneronderwerpen. Kanaal is het nieuwe type routeringsresource en is de voorkeursoptie, die ondersteuning biedt voor het verzenden van gebeurtenissen via partneronderwerpen. Een gebeurteniskanaal is een verouderde resource en wordt binnenkort afgeschaft.

6. Test de functionaliteit van Partnerevenementen end-to-end.

Voor stap 5 moet u bepalen wat voor soort gebruikerservaring u wilt bieden. U hebt de volgende opties:

• Bied uw eigen oplossing, meestal een webgrafische gebruikersinterface-ervaring (GUI) die wordt gehost onder uw domein met behulp van onze SDK en/of REST API om een kanaal (meest recent en aanbevolen) /gebeurteniskanaal (verouderd) en het bijbehorende partneronderwerp te maken. Met deze optie kunt u de gebruiker vragen om het abonnement en de resourcegroep waaronder u een partneronderwerp gaat maken.
• Gebruik Azure Portal of CLI om het kanaal (aanbevolen)/gebeurteniskanaal (verouderd) en een gekoppeld partneronderwerp te maken. Met deze optie moet u op een of andere manier toegang krijgen tot het Azure-abonnement van de gebruiker en de resourcegroep waaronder u een partnertopic gaat maken.

In dit artikel leest u hoe u als Azure Event Grid-partner onboardt met behulp van Azure Portal.

Communiceer uw interesse in het worden van een partner

Neem contact op met het Event Grid-team via askgrid@microsoft.com om uw interesse kenbaar te maken om partner te worden. We voeren een gesprek met u over gedetailleerde informatie met betrekking tot de gebruiksscenario's, persona's, het onboardingproces, functionaliteit, prijzen en meer van partnerevenementen.

Vereiste voorwaarden

Om de resterende stappen te voltooien, zorg ervoor dat u het volgende hebt:

• Een Azure-abonnement. Als u nog geen abonnement hebt, maakt u een gratis account voordat u begint.
• Een Azure-tenant.

De Event Grid-resourceprovider registreren

Tenzij u Event Grid eerder hebt gebruikt, moet u de Event Grid-resourceprovider registreren. Als u Event Grid eerder hebt gebruikt, gaat u verder met de volgende sectie.

Voer in Azure Portal de volgende stappen uit:

1. Selecteer Abonnementen in het linkermenu.

2. Selecteer het abonnement dat u wilt gebruiken voor Event Grid in de lijst met abonnementen.

3. Selecteer op de pagina Abonnement resourceproviders onder Instellingen in het linkermenu.

4. Zoek naar Microsoft.EventGrid en controleer of de status niet is geregistreerd.

5. Selecteer Microsoft.EventGrid in de lijst met providers.

6. Selecteer Registreren op de opdrachtbalk.

   

7. Vernieuwen om ervoor te zorgen dat de status van Microsoft.EventGrid wordt gewijzigd in Geregistreerd.

   

Een partnerregistratie maken

1. Meld u aan bij het Azure-portaal.

2. Selecteer Alle services in het linkernavigatiedeelvenster, typ vervolgens Event Grid-partnerregistraties in de zoekbalk en selecteer deze.

3. Op de Event Grid-partnerregistraties pagina, selecteer + Maken op de opdrachtbalk of selecteer de koppeling Create Event Grid-partnerregistraties op de pagina.

   

4. Voer op de pagina Type registraties voor partneronderwerp maken - Basisinformatie de volgende informatie in:

   1. Voer in de sectie Projectdetails de volgende stappen uit:
      1. Selecteer uw Azure-abonnement.
      2. Selecteer een bestaande Azure-resourcegroep of maak een nieuwe resourcegroep.
   2. Voer in de sectie Registratiegegevens de volgende stappen uit:
      1. Voer voor de registratienaam een naam in voor de registratie.
      2. Voer bij Organisatienaam de naam van uw organisatie in.
   3. Voer in de sectie Partnerresourcetype details in over uw resourcetype dat wordt weergegeven op de pagina voor het maken van partneronderwerp :

      1. Voer voor de naam van het partnerresourcetype de naam in voor het resourcetype.

      2. Voer voor Weergavenaam een gebruiksvriendelijke weergavenaam in voor het type partneronderwerp (resource).

      3. Voer een beschrijving in voor het resourcetype.

      4. Voer een beschrijving in voor het scenario. Het moet de manieren of scenario's uitleggen waarin de partneronderwerpen voor uw resources kunnen worden gebruikt.

         

5. Selecteer Volgende: Custom Service onderaan de pagina. Voer op het tabblad Klantenservice van de pagina Partnerregistratie maken informatie in waarmee abonneegebruikers contact met u kunnen opnemen wanneer er een probleem is met de gebeurtenisbron:

   1. Voer het telefoonnummer in.

   2. Voer de extensie in voor het telefoonnummer.

   3. Voer een URL van een ondersteuningswebsite in.

      

6. Selecteer Volgende: Labels onder aan de pagina.

7. Configureer op de pagina Tags de volgende waarden.

   1. Voer een naam en een waarde in voor de tag die u wilt toevoegen. Deze stap is optioneel.
   2. Selecteer Beoordelen en maken onderaan de pagina om de registratie te maken (partneronderwerptype).

8. Controleer op de pagina Beoordelen en maken alle instellingen en selecteer Maken om de partnerregistratie te voltooien.

Een partnernaamruimte maken

1. Selecteer in Azure Portal alle services in het navigatiemenu links, typ vervolgens Event Grid Partner-naamruimten in de zoekbalk en selecteer deze in de lijst.

2. Selecteer + Maken op de werkbalk op de pagina Event Grid-partnernaamruimten.

   

3. Geef op de pagina Partnernaamruimte maken - Basisinformatie de volgende informatie op.

   1. Voer in de sectie Projectdetails de volgende stappen uit:

      1. Selecteer een Azure-abonnement.
      2. Selecteer een bestaande resourcegroep of maak een resourcegroep.

   2. Voer in de sectie Details van de naamruimte de volgende stappen uit:

      1. Voer een naam in voor de naamruimte.

      2. Selecteer een locatie voor de naamruimte.

      3. Voor de routeringsmodus voor partneronderwerp selecteert u kanaalnaamheader of bronkenmerk in gebeurtenis.

         • Routering van kanaalnaamheaders : Met dit type routering publiceert u gebeurtenissen met behulp van een HTTP-header aeg-channel-name waarin u de naam opgeeft van het kanaal waarnaar gebeurtenissen moeten worden gerouteerd. Als u deze optie selecteert, maakt u kanalen in de naamruimte.
         • Bronkenmerk in gebeurtenisroutering . Deze routeringsbenadering is gebaseerd op de waarde van het source contextkenmerk in de gebeurtenis. Als u deze optie selecteert, maakt u gebeurteniskanalen, die functioneel vergelijkbaar zijn met kanalen en binnenkort worden afgeschaft.

         Belangrijk

         • Het is niet mogelijk om de routeringsmodus bij te werken zodra de naamruimte is gemaakt.
         • Kanaal is het nieuwe type routeringsresource en is de voorkeursoptie. Een gebeurteniskanaal is een verouderde resource en wordt binnenkort afgeschaft.

   3. Volg deze stappen in de sectie Registratiegegevens om de naamruimte te koppelen aan een partnerregistratie.

      1. Selecteer het abonnement waarin de partnerregistratie bestaat.
      2. Selecteer de resourcegroep die de partnerregistratie bevat.
      3. Selecteer de partnerregistratie in de vervolgkeuzelijst.

   4. Selecteer Volgende: Labels onder aan de pagina.

      

4. Voeg op de pagina Tags tags toe (optioneel).

   1. Voer een naam en een waarde in voor de tag die u wilt toevoegen. Deze stap is optioneel.
   2. Selecteer Review + create onderaan de pagina.

5. Controleer de details op de pagina Beoordelen en maken en selecteer Maken.

Een kanaal maken

Als u de kanaalnaamheader hebt geselecteerd voor de routeringsmodus voor partneronderwerp, maakt u een kanaal door de stappen in deze sectie te volgen.

1. Ga naar de overzichtspagina van de partnernaamruimte die u hebt gemaakt en selecteer + Kanaal op de opdrachtbalk.

   

2. Volg deze stappen op de pagina Kanaal maken - Basisinformatie .

   1. Voer een naam in voor het kanaal. Kanaalnaam moet uniek zijn in de regio waarin wordt gemaakt.

   2. Selecteer Partneronderwerp voor het kanaaltype.

      Partneronderwerpen zijn resources die gepubliceerde gebeurtenissen bevatten. Selecteer Partneronderwerp als u gebeurtenissen wilt doorsturen naar een partneronderwerp met gebeurtenissen die later door een handler moeten worden verwerkt.

   3. Als u Partneronderwerp hebt geselecteerd, voert u de volgende gegevens in:

      1. Id van het abonnement waarin het partneronderwerp wordt gemaakt.

      2. Resourcegroep waarin het partneronderwerp wordt gemaakt.

      3. Naam van het partneronderwerp.

      4. Geef broninformatie op voor het partneronderwerp. Bron is contextuele informatie over de bron van gebeurtenissen die worden verstrekt door de partner die de eindgebruiker kan zien. Deze informatie is handig wanneer de eindgebruiker bijvoorbeeld overweegt een partneronderwerp te activeren.

         

      5. Selecteer Definitie van gebeurtenistype toevoegen om het soort gebeurtenissen te declareren dat naar het kanaal en naar het bijbehorende partneronderwerp wordt verzonden. 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.

         

         

         

   4. Selecteer Volgende: Aanvullende functies onderaan de pagina.

   5. Voer op de pagina Aanvullende functies de volgende stappen uit:

      1. Als u uw eigen activeringsbericht wilt instellen waarmee eindgebruikers het bijbehorende partneronderwerp kunnen activeren, schakelt u het selectievakje in naast Uw eigen activeringsbericht instellen en voert u het bericht in.
      2. Stel voor de verlooptijd de tijd in waarop dit kanaal is gemaakt waarop het bijbehorende partneronderwerp en dit kanaal automatisch worden verwijderd als dit niet door de eindgebruiker wordt geactiveerd. 1.Selecteer Volgende: Beoordelen en maken.

      

   6. Controleer op de pagina Beoordelen en maken alle instellingen voor het kanaal en selecteer onderaan de pagina Maken.

      Partneronderwerp-optie:

Een kanaal beheren

Als u een kanaal hebt gemaakt, bent u mogelijk geïnteresseerd om de configuratie bij te werken zodra de resource is gemaakt.

1. Ga naar de configuratie in het kanaal. U kunt het bericht bijwerken voor activering van partneronderwerp, verlooptijd als deze niet is geactiveerd en definities van gebeurtenistypen.

   

Belangrijk

Vergeet niet om wijzigingen op te slaan voordat u de configuratiepagina verlaat.

Een gebeurteniskanaal maken

Als u bronkenmerk hebt geselecteerd in gebeurtenis voor de routeringsmodus van partneronderwerp, maakt u een gebeurteniskanaal door de stappen in deze sectie te volgen.

Belangrijk

• Kanaal is het nieuwe type routeringsresource en is de voorkeursoptie.

1. Ga naar de pagina Overzicht van de naamruimte die u hebt gemaakt.

   partner-namespace-overview.png

2. Selecteer + Eventkanaal op de werkbalk.

3. Geef op de pagina Gebeurteniskanaal maken - Basisinformatie de volgende informatie op.

   1. Voer in de sectie Kanaaldetails de volgende stappen uit:

      1. Voer voor de naam van het gebeurteniskanaal een naam in voor het gebeurteniskanaal.
      2. Voer de bron in. Zie Cloud Events 1.0-specificaties om een idee te krijgen van een geschikte waarde voor de bron. Zie ook dit schemavoorbeeld voor cloudevenementen.

   2. Voer in de sectie Bestemmingsgegevens details in voor het onderwerp van de doelpartner die wordt gemaakt voor dit gebeurteniskanaal.

      1. Voer de id in van het abonnement waarin het partneronderwerp wordt gemaakt.
      2. Voer de naam in van de resourcegroep waarin de partneronderwerpresource wordt gemaakt.
      3. Voer een naam in voor het partneronderwerp.

   3. Selecteer Volgende: Filters onder aan de pagina.

      

4. Voeg filters toe op de pagina Filters . Voer de volgende stappen uit:

   1. Filter op kenmerken van elke gebeurtenis. Alleen gebeurtenissen die overeenkomen met alle filters worden geleverd. Er kunnen maximaal 25 filters worden opgegeven. Vergelijkingen zijn ongevoelig voor hoofdlettergebruik. Geldige sleutels die worden gebruikt voor filters variëren op basis van het gebeurtenisschema. In het volgende voorbeeld, eventid, source, eventtype, en eventtypeversioin kunnen ze worden gebruikt voor sleutels. U kunt ook aangepaste eigenschappen in de datalading gebruiken, met behulp van de . nesteringsoperator. Bijvoorbeeld: data, data.key, data.key1.key2.

   2. Selecteer Volgende: Aanvullende functies onder aan de pagina.

      

5. Op de pagina Aanvullende functies kunt u een verlooptijd en beschrijving voor het partneronderwerp instellen.

   1. De verlooptijd is het tijdstip waarop het onderwerp en het bijbehorende gebeurteniskanaal automatisch worden verwijderd als ze niet door de klant worden geactiveerd. Er wordt een standaardwaarde van zeven dagen gebruikt voor het geval er geen tijd is opgegeven. Schakel het selectievakje in om uw eigen verlooptijd op te geven.

   2. Aangezien dit onderwerp een resource is die niet door de gebruiker is gemaakt, kan een beschrijving de gebruiker helpen de aard van dit onderwerp te begrijpen. Er wordt een algemene beschrijving opgegeven als er geen is ingesteld. Schakel het selectievakje in om de beschrijving van uw eigen partneronderwerp in te stellen.

   3. Selecteer Volgende: Beoordelen en maken.

      

6. Controleer de instellingen op Controleren + Maken en selecteer Maken om het gebeurteniskanaal te creëren.

Partneronderwerpen activeren

Voordat uw gebruikers zich kunnen abonneren op partneronderwerpen die u in hun Azure-abonnementen maakt, moeten ze eerst partneronderwerpen activeren. Zie Een partneronderwerp activeren voor meer informatie.

Volgende stappen

Zie de volgende artikelen voor meer informatie over de functie Partnerevenementen:

• Overzicht van partnerevenementen voor klanten
• Overzicht van partnerevenementen voor partners
• Abonneren op partnerevenementen
• Abonneren op Auth0-gebeurtenissen