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 au hub d’événements, vous aurez l’accès fourni à ce hub d’événements spécifique.

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. Sur la page Espace de noms Event Hubs, cliquez sur Stratégies d’accès partagé dans le menu de gauche.

  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.

    Stratégies d’accès partagé Event Hubs

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

    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 le hub d’événements dans le menu de gauche.

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

  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.

    Chaîne de connexion à un hub d’événements 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.

Étapes suivantes

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