S’abonner aux événements publiés par un partenaire avec Azure Event Grid

  • Article

Cet article décrit les étapes à suivre pour s’abonner aux événements qui proviennent d’un système détenu ou géré par un partenaire (SaaS, Enterprise Resource Planning (ERP), etc.).

Important

Si vous n’êtes pas familiarisé avec la fonctionnalité Événements partenaires, consultez la Vue d’ensemble des événements partenaires pour comprendre la logique des étapes décrites dans cet article.

Procédure générale

Voici les étapes à suivre pour qu’un abonné reçoive des événements d’un partenaire.

  1. Inscrivez le fournisseur de ressources Event Grid avec votre abonnement Azure.
  2. Autoriser le partenaire à créer une rubrique partenaire dans votre groupe de ressources.
  3. Demandez au partenaire d’activer le flux d’événements vers une rubrique partenaire.
  4. Activez la rubrique partenaire afin que vos événements commencent à circuler vers votre rubrique partenaire.
  5. S’abonner aux événements.

Enregistrer le fournisseur de ressources Event Grid

Si vous n’avez pas déjà utilisé Event Grid auparavant, vous devez inscrire le fournisseur de ressources Event Grid. Si vous avez déjà utilisé Event Grid, passez à la section suivante.

Dans le portail Azure, procédez comme suit :

  1. Sélectionner Abonnements dans le menu de gauche.

  2. Sélectionnez l’abonnement que vous souhaitez utiliser pour Event Grid dans la liste des abonnements.

  3. Dans la page Abonnement, sélectionnez Fournisseurs de ressources dans la section Paramètres du menu de gauche.

  4. Recherchez Microsoft.EventGrid et assurez-vous que l’état est Non inscrit.

  5. Sélectionnez Microsoft.EventGrid dans la liste des fournisseurs.

  6. Sélectionnez Inscrire dans la barre de commandes.

    Image showing the registration of Microsoft.EventGrid provider with the Azure subscription.

  7. Actualisez pour vous assurer que l’état de Microsoft.EventGrid est modifié en Inscrit.

    Image showing the successful registration of Microsoft.EventGrid provider with the Azure subscription.

Autoriser le partenaire à créer une rubrique de partenaire

Vous devez accorder votre consentement au partenaire pour créer des rubriques de partenaire dans un groupe de ressources que vous désignez. Cette autorisation a un délai d’expiration. Il est effectif pour la période que vous spécifiez entre 1 et 365 jours.

Important

Pour une meilleure position de sécurité, spécifiez la durée d’expiration minimale qui offre au partenaire suffisamment de temps pour configurer vos événements afin de passer à Event Grid et de provisionner votre rubrique partenaire. Votre partenaire ne pourra pas créer de ressources (rubriques du partenaire) dans votre abonnement Azure après l’expiration de l’autorisation.

L’exemple suivant montre comment créer une ressource de configuration de partenaire qui contient l’autorisation du partenaire. Vous devez identifier le partenaire en fournissant son ID d’inscription partenaire ou le nom du partenaire. Les deux peuvent être obtenus auprès de votre partenaire, mais un seul d’entre eux est requis. Pour plus de commodité, les exemples suivants conservent un exemple d’heure d’expiration au format UTC.

Portail Azure

  1. Connectez-vous au portail Azure.

  2. Dans la barre de recherche en haut, entrez Configurations de partenaire, puis sélectionnez Configurations des partenaires Event Grid sous Services dans les résultats.

  3. Dans la page Configurations des partenaires Event Grid , sélectionnez le bouton Créer une configuration de partenaire Event Grid dans la page (ou) sélectionnez + Créer dans la barre de commandes.

    Screenshot showing the Event Grid Partner Configurations with the list of partner configurations and a link to create a partner registration.

  4. Dans la page Créer une configuration de partenaire, procédez comme suit :

    1. Dans la section Détails du projet, sélectionnez l’abonnement Azure et le groupe de ressources où vous souhaitez autoriser le partenaire à créer une rubrique partenaire.

    2. Dans la section Autorisations du partenaire, spécifiez une heure d’expiration par défaut pour les autorisations de partenaire définies dans cette configuration.

    3. Pour autoriser un partenaire à créer des rubriques partenaires dans le groupe de ressources spécifié, sélectionnez le lien + Autorisation du partenaire.

      Screenshot showing the Create Partner Configuration page with the Partner Authorization link selected.

  5. Dans la page Ajouter une autorisation de partenaire pour créer des ressources, vous voyez une liste de partenaires vérifiés. Un partenaire vérifié est un partenaire dont l’identité a été validée par Microsoft. Vous pouvez sélectionner un partenaire vérifié, et sélectionner le bouton Ajouter en bas pour donner au partenaire l’autorisation d’ajouter une rubrique partenaire dans votre groupe de ressources. Cette autorisation est effective jusqu’au délai d’expiration.

    Vous avez également la possibilité d’autoriser un partenaire non vérifié. À moins que le partenaire ne soit une entité que vous connaissez bien, par exemple, une organisation au sein de votre entreprise, il est fortement encouragé que vous travaillez uniquement avec des partenaires vérifiés. Si le partenaire n’est pas encore vérifié, encouragez-les à être vérifiés en leur demandant de contacter l’équipe Event Grid à l’adresse askgrid@microsoft.com.

    1. Pour autoriser un partenaire vérifié :

      1. Sélectionnez le partenaire dans la liste.

      2. Spécifiez l’heure d’expiration de l’autorisation.

      3. Sélectionnez Ajouter.

        Screenshot for granting a verified partner the authorization to create resources in your resource group.

    2. Pour autoriser un partenaire non vérifié, sélectionnez Autoriser un partenaire non vérifié, puis procédez comme suit :

      1. Entrez l’ID d’inscription du partenaire. Vous devez demander cet ID à votre partenaire.

      2. Spécifiez l’heure d’expiration de l’autorisation.

      3. Sélectionnez Ajouter.

        Screenshot for granting a non-verified partner the authorization to create resources in your resource group.

        Important

        Votre partenaire ne pourra pas créer de ressources (rubriques du partenaire) dans votre abonnement Azure après l’expiration de l’autorisation.

  6. Dans la page Créer une configuration partenaire, vérifiez que le partenaire est ajouté à la liste d’autorisation du partenaire en bas.

  7. Au bas de la page, sélectionnez Examiner et créer.

    Screenshot showing the Create Partner Configuration page with the partner authorization you just added.

  8. Sur la page Vérifier, vérifiez les paramètres, puis sélectionnez Créer pour créer l’enregistrement de partenaire.

Demandez au partenaire d’activer le flux d’événements vers une rubrique partenaire

Voici la liste des partenaires et un lien permettant d’envoyer une demande d’activation du flux d’événements à une rubrique partenaire.

Activer une rubrique de partenaire

  1. Dans la barre de recherche du portail Azure, recherchez et sélectionnez Rubriques système Event Grid.

  2. Dans la page Rubriques des partenaires Event Grid, sélectionnez la rubrique partenaire dans la liste.

    Screenshot that shows selection a partner topic in the Event Grid Partner Topics page.

  3. Passez en revue le message d’activation, puis sélectionnez Activer sur la page ou dans la barre de commandes pour activer la rubrique partenaire avant l’heure d’expiration mentionnée sur la page.

    Screenshot showing the selection of the Activate button on the command bar or on the page.

  4. Vérifiez que l’état d’activation est défini sur Activé , puis créez des abonnements aux événements pour la rubrique partenaire en sélectionnant + Abonnement aux événements dans la barre de commandes.

    Screenshot showing the activation state of a partner topic as **Activated**.

S’abonner à des événements

Tout d’abord, créez un gestionnaire d’événements qui gérera les événements du partenaire. Par exemple, créez un hub d’événements, file d’attente ou rubrique Service Bus, ou une fonction Azure. Ensuite, créez un abonnement aux événements pour la rubrique partenaire à l’aide du gestionnaire d’événements que vous avez créé.

Créer un gestionnaire d’événements

Pour tester votre rubrique de partenaire, vous avez besoin d’un gestionnaire d’événements. Accédez à votre abonnement Azure et lancez un service pris en charge en tant que gestionnaire d’événements, par exemple Azure Function. Pour obtenir un exemple, consultez l’exemple de visionneuse Event Grid que vous pouvez utiliser comme gestionnaire d’événements via des webhooks.

S’abonner à la rubrique du partenaire

L’abonnement à la rubrique partenaire indique à Event Grid où vous souhaitez que vos événements partenaires soient remis.

  1. Dans le portail Azure, tapez Rubriques des partenaires Event Grid dans la zone de recherche, puis sélectionnez Rubriques des partenaires Event Grid.

  2. Dans la page Rubriques des partenaires Event Grid, sélectionnez la rubrique partenaire dans la liste.

    Screenshot showing the selection of a partner topic on the Event Grid Partner Topics page.

  3. Dans la page Rubrique du partenaire Event Grid pour la rubrique partenaire, sélectionnez + Abonnement aux événements dans la barre de commandes.

    Screenshot showing the selection of Add Event Subscription button on the Event Grid Partner Topic page.

  4. Dans la page Créer un abonnement aux événements, effectuez les étapes suivantes :

    1. Entrez un nom pour l’abonnement aux événements.

    2. Pour Filtrer sur les types d’événements, sélectionnez les types d’événements que votre abonnement recevra.

    3. Pour le type de point de terminaison, sélectionnez un service Azure (Azure Function, File d’attente Stockage, Event Hubs, Service Bus Queue, Service Bus Topic, Hybrid Connections, etc.) ou un webhook.

    4. Cliquez sur le lien Sélectionner un point de terminaison. Dans cet exemple, nous allons utiliser une destination ou un point de terminaison Azure Event Hubs.

      Screenshot showing the configuration of an endpoint for an event subscription.

    5. Dans la page Sélectionner un hub d’événements, sélectionnez configurations pour le point de terminaison, puis sélectionnez Confirmer la sélection.

      Screenshot showing the configuration of an Event Hubs endpoint.

    6. Dans la page Créer un abonnement aux événements, sélectionnez Créer.

      Screenshot showing the Create Event Subscription page with example configurations.

Étapes suivantes

Pour plus d’informations, consultez les articles suivants sur la fonctionnalité Événements partenaires :