Partager via

Obtenir une chaîne de connexion Event Hubs

  • Article

Pour communiquer avec un hub d’événements dans un espace de noms, vous avez besoin d’une chaîne de connexion pour l’espace de noms ou le hub d’événements. Si vous utilisez une chaîne de connexion à l’espace de noms à partir de votre application, celle-ci aura l’accès fourni (gérer, lire ou écrire) à tous les hubs d’événements dans l’espace de noms. Si vous utilisez une chaîne de connexion pour l’Event Hub, vous obtenez l’accès fourni à l’Event Hub en question.

La chaîne de connexion d’un espace de noms se compose des éléments suivants :

  • Nom de domaine complet de l’espace de noms Event Hubs que vous avez créé (cela comprend le nom de l’espace de noms Event Hubs suivi de servicebus.windows.net)
  • Nom de la clé d’accès partagé
  • Valeur de la clé d’accès partagé

La chaîne de connexion d’un espace de noms ressemble à ceci :

Endpoint=sb://<NamespaceName>.servicebus.windows.net/;SharedAccessKeyName=<KeyName>;SharedAccessKey=<KeyValue>

La chaîne de connexion d’un hub d’événements a un composant supplémentaire. Il s’agit de EntityPath=<EventHubName>.

Endpoint=sb://<NamespaceName>.servicebus.windows.net/;SharedAccessKeyName=<KeyName>;SharedAccessKey=<KeyValue>;EntityPath=<EventHubName>

Cet article explique comment obtenir une chaîne de connexion à un espace de noms ou à un hub d’événements spécifique à l’aide du portail Azure, de PowerShell ou de l’interface CLI.

Portail Azure

Chaîne de connexion pour un espace de noms

  1. Connectez-vous au portail Azure.

  2. Dans le menu de navigation de gauche, sélectionnez Tous les services.

  3. Sélectionnez Event Hubs dans la section Analytics.

  4. Dans la liste de hubs d’événements, sélectionnez votre Event Hub.

  5. Dans la page Espace de noms Event Hubs, sélectionnez Stratégies d’accès partagé dans le menu de gauche sous Paramètres.

  6. Sélectionnez une stratégie d’accès partagé dans la liste des stratégies. Le nom par défaut est le suivant : RootManageSharedAccessPolicy. Vous pouvez ajouter une stratégie avec les autorisations appropriées (envoyer, écouter) et utiliser cette stratégie.

  7. Cliquez sur le bouton copier à côté du champ Clé primaire de la chaîne de connexion.

    Capture d’écran montrant Obtenir la chaîne de connexion Event Hubs.

Chaîne de connexion pour un hub d’événements spécifique dans un espace de noms

Cette section présente les étapes nécessaires à l’obtention d’une chaîne de connexion à un hub d’événements spécifique dans un espace de noms.

  1. Dans la page Espace de noms Event Hubs, sélectionnez l’Event Hub dans le volet du bas.

  2. Dans la page Instance Event Hubs, sélectionnez Stratégies d’accès partagé dans le menu de gauche sous Paramètres.

  3. Aucune stratégie par défaut n’est créée pour un hub d’événements. Créez une stratégie avec accès Gérer, Envoyer ou Écouter.

  4. Sélectionnez la stratégie dans la liste.

  5. Cliquez sur le bouton copier à côté du champ Clé primaire de la chaîne de connexion.

    Capture d’écran de la chaîne de connexion pour un Event Hub spécifique.

Azure PowerShell

Vous pouvez utiliser Get-AzEventHubKey afin d’obtenir la chaîne de connexion pour la stratégie/règle spécifique.

Voici un exemple de commande pour obtenir la chaîne de connexion d’un espace de noms. MyAuthRuleName est le nom de la stratégie d’accès partagé. Pour un espace de noms, il existe une stratégie par défaut : RootManageSharedAccessKey.

Get-AzEventHubKey -ResourceGroupName MyResourceGroupName -NamespaceName MyNamespaceName -AuthorizationRuleName MyAuthRuleName

Voici un exemple de commande pour obtenir la chaîne de connexion pour un hub d’événements spécifique dans un espace de noms :

Get-AzEventHubKey -ResourceGroupName MyResourceGroupName -NamespaceName MyNamespaceName -EventHubName MyEventHubName -AuthorizationRuleName MyAuthRuleName

Voici un exemple de commande pour obtenir la chaîne de connexion pour un hub d’événements dans un cluster Geo-DR, qui a un alias.

Get-AzEventHubKey -ResourceGroupName MyResourceGroupName -NamespaceName MyNamespaceName -EventHubName MyEventHubName -AliasName MyAliasName -Name MyAuthRuleName

Azure CLI

Voici un exemple de commande pour obtenir la chaîne de connexion d’un espace de noms. MyAuthRuleName est le nom de la stratégie d’accès partagé. Pour un espace de noms, il existe une stratégie par défaut : RootManageSharedAccessKey

az eventhubs namespace authorization-rule keys list --resource-group MyResourceGroupName --namespace-name MyNamespaceName --name RootManageSharedAccessKey

Voici un exemple de commande pour obtenir la chaîne de connexion pour un hub d’événements spécifique dans un espace de noms :

az eventhubs eventhub authorization-rule keys list --resource-group MyResourceGroupName --namespace-name MyNamespaceName --eventhub-name MyEventHubName --name MyAuthRuleName

Voici un exemple de commande pour obtenir la chaîne de connexion pour un hub d’événements dans un cluster Geo-DR, qui a un alias.

az eventhubs georecovery-alias authorization-rule keys list --resource-group MyResourceGroupName --namespace-name MyNamespaceName --eventhub-name MyEventHubName --alias-name MyAliasName --name MyAuthRuleName

Pour plus d’informations sur les commandes Azure CLI pour Event Hubs, consultez Azure CLI pour Event Hubs.

Contenu connexe

Vous pouvez en apprendre plus sur Event Hubs en consultant les liens suivants :