Vue d’ensemble des événements partenaires pour les partenaires - Azure Event Grid

Article
04/12/2023

Les événements partenaires d’Event Grid permettent aux clients de s’abonner aux événements qui proviennent d’un système inscrit à l’aide du même mécanisme qu’ils utiliseraient pour toute autre source d’événement sur Azure, comme un service Azure. Ces systèmes inscrits s’intègrent à Event Grid sont appelés « partenaires ». Cette fonctionnalité permet également aux clients d’envoyer des événements à des systèmes partenaires qui prennent en charge la réception et le routage d’événements vers les solutions/points de terminaison du client dans leur plateforme. En règle générale, les partenaires sont des fournisseurs SaaS (Software-as-a-Service) ou ERP, mais ils peuvent être des plateformes d’entreprise souhaitant mettre leurs événements à la disposition des équipes internes. Ils s’intègrent volontairement à Event Grid pour réaliser des cas d’usage des clients de bout en bout qui se terminent sur Azure (les clients s’abonnent aux événements envoyés par un partenaire) ou se terminent sur un système partenaire (les clients s’abonnent aux événements Microsoft envoyés par Azure Event Grid). Les clients s’appuient sur Azure Event Grid pour envoyer des événements publiés par un partenaire à des destinations prises en charge, telles que des webhooks, des Azure Functions, des Azure Event Hubs ou des Azure Service Bus, pour n’en citer que quelques-uns. Les clients s'appuient également sur Azure Event Grid pour acheminer des événements provenant de services Microsoft, tels que Outlook, Teams ou Microsoft Entra ID afin que les solutions du client puissent y réagir. Avec les événements partenaires, les clients peuvent créer des solutions basées sur des événements sur les plateformes et les limites du réseau pour recevoir ou envoyer des événements de manière fiable, sécurisée et à grande échelle.

Notes

Il s’agit d’un article conceptuel qui est requis avant de décider d’intégrer en tant que partenaire à Azure Event Grid. Pour obtenir des instructions pas à pas sur la façon d’intégrer en tant que partenaire Event Grid à l’aide du portail Azure, consultez Comment intégrer en tant que partenaire Event Grid (Portail Azure).

Événements de partenaire : fonctionnement

En tant que partenaire, vous créez des ressources Event Grid qui vous permettent de publier des événements sur Azure Event Grid afin que les clients sur Azure puissent s’y abonner. Pour la plupart des partenaires, par exemple des fournisseurs SaaS, il s’agit de la seule fonctionnalité d’intégration qu’ils utiliseront.

Vous pouvez également créer des ressources Event Grid pour recevoir des événements de Azure Event Grid. Ce cas d’usage concerne les organisations qui possèdent ou gèrent une plateforme qui permet à leurs clients de recevoir des événements en exposant des points de terminaison. Certaines de ces organisations sont des systèmes ERP qui ont également des fonctionnalités de routage des événements au sein de leur plateforme, qui envoient les événements Azure entrants à une application cliente hébergée sur leur plateforme.

Pour la publication d’événements ou la réception d’événements, vous créez le même type de ressources Event Grid en suivant ces étapes générales.

Contactez l’équipe Event Grid à l’adresse askgrid@microsoft.com, indiquant que vous souhaitez devenir partenaire. Une fois que vous nous avez contactés, nous allons vous guider tout au long du processus d’intégration et aider votre service à obtenir une carte d’entrée sur notre galerie de Azure Event Grid afin que votre service soit trouvé sur le portail Azure.
Créer une inscription de partenaire. Il s’agit d’une ressource globale et vous devez généralement créer une seule fois.
Créer un espace de noms de partenaire. Cette ressource expose un point de terminaison auquel vous pouvez publier des événements sur Azure. Lors de la création de l’espace de noms du partenaire, indiquez l’inscription du partenaire que vous avez créée.
Le client vous autorise à créer une rubrique partenaire dans son abonnement Azure.
Le client accède à votre page web ou exécute une commande, vous définissez l’expérience utilisateur pour demander le flux de vos événements à Azure ou la possibilité de recevoir des événements Microsoft dans votre système. En réponse à cette demande, vous configurez votre système pour le faire avec l’entrée du client. Par exemple, le client peut avoir la possibilité de sélectionner certains événements de votre système qui doivent être transférés à Azure.
Créez une rubrique partenaire dans l’abonnement et le groupe de ressources Azure du client à l’aide de canaux. Les canaux sont des ressources contenues dans les espaces de noms de partenaires.
Le client active la rubrique partenaire que vous avez créée dans son abonnement Azure et son groupe de ressources.
Commencez à publier des événements dans votre espace de noms partenaire.

Notes

Vous devez inscrire le fournisseur de ressources Azure Event Grid à chaque abonnement Azure dans lequel vous souhaitez créer des ressources Event Grid. Sinon, les opérations de création de ressources échouent.

Pourquoi devrais-je utiliser Événements de partenaire ?

Il peut être intéressant pour vous d’utiliser Événements de partenaire si une ou plusieurs des exigences suivantes sont les vôtres.

Pour les partenaires en tant qu’éditeurs d’événements

Vous souhaitez disposer d’un mécanisme permettant de rendre vos événements disponibles pour vos clients sur Azure. Vos utilisateurs peuvent filtrer et acheminer ces événements par l’intermédiaire des rubriques de partenaire et des abonnements aux événements qu’ils possèdent et gèrent. Vous pouvez utiliser d’autres moyens d’intégration, comme les rubriques et les domaines. Toutefois, ces approches ne permettent pas une séparation claire de la propriété des ressources, de la gestion et de la facturation entre vous et votre client. La fonctionnalité Événements partenaires offre également une expérience utilisateur plus intuitive qui facilite la découverte de votre service.
Vous avez besoin d’un modèle multilocataire simple dans lequel vous publiez des événements sur un point de terminaison régional unique, le point de terminaison de l’espace de noms, pour acheminer les événements vers différents clients.
Vous voulez bénéficier d’une visibilité sur les métriques liées aux événements publiés.
Vous souhaitez utiliser le schéma Cloud Events 1.0 pour vos événements.

Pour les partenaires en tant qu’abonné

Vous souhaitez que votre service réagisse aux événements clients qui proviennent de Microsoft Azure.
Vous souhaitez que votre client réagisse aux événements de service Microsoft Azure à l’aide de ses applications hébergées par votre plateforme. Vous utilisez les fonctionnalités de routage des événements de votre plateforme pour fournir des événements à la solution client appropriée.
Vous souhaitez un modèle simple dans lequel vos clients sélectionnent simplement le nom de votre service comme destination sans qu’ils n’ont besoin de connaître les détails techniques tels que vos points de terminaison de plateforme.
Votre système/plateforme prend en charge le schéma Cloud Events 1.0.

Ressources gérées par des partenaires

En tant que partenaire, vous gérez les types de ressources suivants.

Inscription de partenaire

Une inscription contient des informations générales liées à un partenaire. Une inscription est requise lors de la création d’un espace de noms partenaire. Autrement dit, vous devez disposer d’une inscription de partenaire pour créer les ressources Azure nécessaires à intégrer à Azure Event Grid.

Les inscriptions sont globales. Autrement dit, elles ne sont pas associées à une région Azure particulière. Vous pouvez créer une inscription de partenaire unique et l’utiliser lors de la création de vos espaces de noms partenaires.

Canal

Un canal est une ressource imbriquée à un espace de noms partenaire. Un canal a deux objectifs principaux :

Il s’agit du type de ressource qui vous permet de créer des ressources de partenaire sur l’abonnement Azure d’un client. Lorsque vous créez un canal de type partner topic, une rubrique partenaire est créée sur l’abonnement Azure d’un client. Une rubrique partenaire est la ressource d’un client vers laquelle les événements sont routés lorsqu’un système partenaire publie des événements.

Un canal a le même cycle de vie que la rubrique ou la destination de son partenaire client associé. Lorsqu’un canal de type partner topic est supprimé, par exemple, la rubrique partenaire du client associé est supprimée. De même, si la rubrique partenaire est supprimée par le client, le canal associé sur votre abonnement Azure est supprimé.
Il s’agit d’une ressource utilisée pour router les événements. Un canal de type partner topic est utilisé pour acheminer les événements vers la rubrique partenaire d’un client. Il prend en charge deux types de modes de routage.
- Routage du nom du canal. Avec ce type de routage, vous publiez des événements à l’aide d’un en-tête HTTP appelé aeg-channel-name où vous fournissez le nom du canal vers lequel les événements doivent être routés. Comme les canaux sont la représentation d’un partenaire des rubriques de partenaire, les événements acheminés vers l’émission de canal sur la rubrique du partenaire du client. Ce type de routage est une nouvelle fonctionnalité absente de event channels qui ne prend en charge que le routage basé sur la source. Le routage de noms de canal permet d’utiliser plus de cas d’usage que le routage basé sur la source et il s’agit du mode de routage recommandé à choisir. Par exemple, avec le routage du nom de canal, un client peut demander des événements qui proviennent de différentes sources d’événements pour atterrir sur une rubrique partenaire unique.
- Routage basé sur la source. Cette approche de routage est basée sur la valeur de l’attribut source de contexte dans l’événement. Les sources sont mappées aux canaux et lorsqu’un événement est fourni avec une source, par exemple, de la valeur « A » que l’événement est acheminé vers la rubrique partenaire associée au canal qui contient « A » dans sa propriété source.
Vous pouvez déclarer les types d’événements routés vers le canal et vers sa rubrique partenaire associée. Les types d’événements sont affichés aux clients lors de la création d’abonnements aux événements sur la rubrique partenaire et sont utilisés pour sélectionner les types d’événements spécifiques à envoyer à une destination de gestionnaire d’événements. En savoir plus

Important

Les types d’événements peuvent être gérés sur le canal, et une fois les valeurs mises à jour, les modifications sont reflétées immédiatement sur la rubrique partenaire associée.

Espace de noms de partenaire

Un espace de noms partenaire est une ressource régionale qui a un point de terminaison pour publier des événements sur Azure Event Grid. Les espaces de noms de partenaires contiennent des canaux ou des canaux d’événements (ressource héritée). Vous devez créer des espaces de noms partenaires dans les régions où les clients demandent des rubriques ou destinations de partenaire, car les canaux et leurs ressources partenaires correspondantes doivent résider dans la même région. Vous ne pouvez pas avoir de canal dans une région donnée avec sa rubrique partenaire associée, par exemple, située dans une autre région.

Les espaces de noms de partenaires contiennent des canaux ou des canaux d’événements. Il est déterminé par le mode de routage de rubrique partenaire de propriété dans l’espace de noms. S’il est défini sur en-tête de nom de canal, les canaux sont le seul type de ressource qui peut être créé sous l’espace de noms. Si le mode de routage de rubrique partenaire est défini sur l’attribut Source dans l’événement, l’espace de noms ne peut contenir que des canaux d’événements. N’oubliez pas que la décision de définir le droit partner topic routing mode n’est pas une décision entre choisir le nom du canal ou le routage basé sur la source. Les canaux prennent en charge les deux. Il s’agit plutôt d’une décision entre l’utilisation du nouveau type de ressource de routage, les canaux, et l’utilisation d’une ressource héritée, les canaux d’événements.

Canal d’événements

Un canal d’événements est la ressource qui a été publiée pour la première fois avec les événements partenaires pour acheminer les événements entrants vers les rubriques du partenaire. Les canaux d’événements prennent uniquement en charge le routage basé sur la source et représentent toujours une rubrique partenaire client.

Important

Les canaux d’événements sont dépréciés. Par conséquent, il est recommandé d’utiliser les canaux.

Partenaires vérifiés

Un partenaire vérifié est une organisation partenaire dont l’identité a été validée par Microsoft. Il est fortement encouragé que votre organisation soit vérifiée. Les clients cherchent à s’engager avec des partenaires vérifiés comme tels la vérification fournissent des garanties plus importantes qu’ils traitent avec une organisation légitime. Une fois vérifié, vous bénéficiez d’une présence dans la galerie Event Grid où les clients peuvent facilement découvrir votre service et avoir une expérience de première partie lors de l’abonnement à vos événements, par exemple.

Autorisation du client pour créer des rubriques de partenaire

Les clients vous autorisent à créer des rubriques de partenaire sur leur abonnement Azure. L’autorisation est accordée pour un groupe de ressources donné dans un abonnement Azure client et elle est limitée. Vous devez créer le canal avant la date d’expiration définie par le client. Vous devez disposer d’une documentation suggérant au client une fenêtre de temps adéquate pour configurer votre système afin d’envoyer ou de recevoir des événements et de créer le canal avant l’expiration de l’autorisation. Si vous tentez de créer un canal sans autorisation ou après son expiration, la création du canal échoue et aucune ressource n’est créée sur l’abonnement Azure du client.

Notes

Event Grid a commencé à appliquer des contrôles d’autorisation pour la création de rubriques au alentours du 30 juin 2022. Votre documentation doit demander à vos clients de vous accorder l’autorisation comme condition préalable avant de créer un canal.

Important

Un partenaire vérifié n’est pas un partenaire autorisé. Même si un partenaire a été vérifié par Microsoft, vous devez toujours être autorisé avant de pouvoir créer une rubrique partenaire sur l’abonnement Azure du client.

Activation de la rubrique de partenaire

Le client active la rubrique ou la destination du partenaire que vous avez créée pour ces derniers. À ce stade, l’état d’activation du canal passe à Activé. Une fois qu’un canal est activé, vous pouvez commencer à publier des événements sur le point de terminaison d’espace de noms du partenaire qui contient le canal.

Comment automatiser le processus pour savoir quand vous pouvez commencer à publier des événements pour une rubrique partenaire donnée ?

Deux options s'offrent à vous :

Lisez (interrogez) régulièrement l’état du canal pour vérifier si l’état d’activation est passé de NeverActivated à Activated. Cette opération peut être gourmande en ressources de calcul.
Créez un abonnement aux événements pour l’abonnement Azure ou le groupe de ressources qui contient le ou les canaux que vous souhaitez surveiller. Vous recevrez des événements Microsoft.Resources.ResourceWriteSuccess chaque fois qu’un canal est mis à jour. Vous devez ensuite lire l’état du canal avec l’ID Azure Resource Manager fourni dans l’événement pour vérifier que la mise à jour est liée à une modification de l’état d’activation à Activé.