Partager via


Envoyer des événements client à Event Hubs

Remarque

La fonctionnalité d’écouteur d’événements est en préversion. L’envoi des événements du client MQTT au détecteur d’événements n’est pas pris en charge pour le moment.

Vue d’ensemble

Si vous souhaitez écouter vos événements client sans exposer un point de terminaison accessible publiquement, vous pouvez configurer une règle d’« écouteur d’événements » avec un point de terminaison Event Hub et un filtre pour spécifier les types d’événements qu’il concerne. Vous pouvez configurer plusieurs écouteurs d’événements en même temps. Le service Web PubSub avertit tous les écouteurs d’événements en parallèle lorsqu’un événement client arrive.

Ce tutoriel vous montre comment autoriser votre service Web PubSub à se connecter à Event Hubs et comment ajouter une règle d’écouteur d’événement à vos paramètres de service.

Le service Web PubSub utilise Microsoft Entra ID avec l’identité managée pour se connecter à Event Hubs. Par conséquent, vous devez activer l’identité managée du service et vous assurer qu’il dispose des autorisations appropriées pour se connecter à Event Hubs. Vous pouvez accorder le rôle intégré Expéditeur de données Azure Event Hubs à l’identité managée afin qu’elle dispose d’autorisations suffisantes.

Pour configurer un écouteur Event Hubs, vous devez :

Configurer un détecteur d’événements

Ajouter une identité managée à votre service Web PubSub

Recherchez votre service Azure Web PubSub à partir de Portail Azure. Accédez à Identité. Pour ajouter une identité affectée par le système, sous l’onglet Affectée par le système, basculez État sur Activé. Cliquez sur Enregistrer. Pour plus d’informations sur les identités managées, consultez Identités managées dans Azure Web PubSub.

Capture d’écran de l’ajout d’une identité affectée par le système dans le portail

Accorder un rôle Azure Event Hubs Data sender à l’identité managée

  1. Recherchez votre ressource Azure Event Hubs dans le Portail Azure. Vous pouvez choisir d’accorder le rôle au niveau de l’espace de noms Event Hubs ou au niveau de l’entité. Les étapes suivantes choisissent le niveau d’espace de noms.

  2. Accéder au Contrôle d’accès. Sélectionnez Ajouter une attribution de rôle. Capture d’écran de l’octroi de l’accès à l’espace de noms Event Hubs

  3. Sélectionnez le rôle Expéditeur de données Azure Event Hubs dans l’onglet Rôle. Sélectionnez ensuite Suivant. Capture d’écran de la sélection du rôle Expéditeur de données Azure EventHubs

  4. Sous l’onglet Membres , choisissez d’attribuer l’accès à l’Identité managée. Choisissez Sélectionner des membres pour sélectionner votre service Web PubSub. Ensuite, vous pouvez Vérifier + attribuer votre attribution de rôle. Capture d’écran de la sélection de votre identité de service Web PubSub

Ajouter une règle d’écouteur d’événements à vos paramètres de service

  1. Recherchez votre service à partir du Portail Azure. Accédez aux Paramètres. Sélectionnez ensuite Ajouter pour configurer votre écouteur d’événements. Pour une configuration de hub existante, sélectionnez à droite pour accéder à la même page d’édition. Capture d’écran des paramètres Web PubSub

  2. Ensuite, dans la page de modification ci-dessous, vous devez configurer le nom du hub, puis sélectionner Ajouter pour ajouter un écouteur d’événements. Capture d’écran de la configuration des paramètres du hub

  3. Dans la page Configurer l’écouteur d’événements, configurez d’abord un point de terminaison Event Hub. Vous pouvez sélectionner Sélectionner Event Hub dans votre abonnement ou entrer directement l’espace de noms complet et le nom du hub d’événements. Sélectionnez ensuite les événements user et system que vous souhaitez écouter. Enfin, sélectionnez Confirmer lorsque tout est terminé. Capture d’écran de la configuration de l’écouteur Event Hubs

Tester votre configuration avec la démonstration en direct

  1. Ouvrez cette application web Client consommateur Event Hubs, puis entrez la chaîne de connexion Event Hubs pour vous connecter à un hub d’événements en tant que consommateur. Si vous obtenez la chaîne de connexion Event Hubs à partir d’une ressource d’espace de noms Event Hubs au lieu d’une instance Event Hub, vous devez spécifier le nom du hub d’événements. Ce client consommateur de hub d’événements est connecté au mode qui lit uniquement les nouveaux événements ; les événements publiés avant ne sont pas visibles ici. Vous pouvez modifier le mode de connexion du client consommateur pour lire tous les événements disponibles dans l’environnement de production.

  2. Utilisez cette application web de Client WebSocket pour générer des événements client. Si vous avez configuré pour envoyer un événement système connected à ce hub d’événements, vous devriez être en mesure de voir un événement imprimé connected dans le client consommateur Event Hubs après vous être connecté au service Web PubSub avec succès. Vous pouvez également générer un événement utilisateur avec l’application. Capture d’écran d’un événement connecté imprimé dans l’application client Event Hubs.Capture d’écran illustrant la zone de l’application client WebSocket permettant de générer un événement utilisateur.

Étapes suivantes

Dans cet article, vous avez appris comment fonctionnent les écouteurs d’événements et comment configurer un écouteur d’événement avec un point de terminaison Event Hubs. Pour découvrir le format de données envoyé à Event Hubs, lisez la spécification suivante.