Een Event Hubs-connection string

  • Artikel

Als u wilt communiceren met een Event Hub in een naamruimte, hebt u een connection string nodig voor de naamruimte of de Event Hub. Als u een connection string naar de naamruimte van uw toepassing gebruikt, heeft de toepassing de opgegeven toegang (beheren, lezen of schrijven) tot alle Event Hubs in de naamruimte. Als u een connection string gebruikt voor de Event Hub, hebt u de opgegeven toegang tot die specifieke Event Hub.

De connection string voor een naamruimte bevat de volgende onderdelen:

  • Volledig gekwalificeerde domeinnaam van de Event Hubs-naamruimte die u hebt gemaakt (deze bevat de naam van de Event Hubs-naamruimte gevolgd door servicebus.windows.net)
  • Naam van de gedeelde toegangssleutel
  • Waarde van de gedeelde toegangssleutel

De connection string voor een naamruimte ziet er als volgt uit:

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

De connection string voor een Event Hub bevat een extra onderdeel. Dat is, EntityPath=<EventHubName>.

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

In dit artikel wordt beschreven hoe u een connection string naar een naamruimte of een specifieke Event Hub krijgt met behulp van de Azure Portal, PowerShell of CLI.

Azure Portal

Verbindingsreeks voor een naamruimte

  1. Meld u aan bij de Azure-portal.

  2. Selecteer Alle services in het navigatiemenu aan de linkerkant.

  3. Selecteer Event Hubs in de sectie Analyse .

  4. Selecteer uw Event Hub in de lijst met Event Hubs.

  5. Selecteer op de pagina Event Hubs-naamruimtede optie Beleid voor gedeelde toegang in het menu links.

  6. Selecteer een beleid voor gedeelde toegang in de lijst met beleidsregels. De standaardnaam is : RootManageSharedAccessPolicy. U kunt een beleid toevoegen met de juiste machtigingen (verzenden, luisteren) en dat beleid gebruiken.

    Beleid voor gedeelde toegang van Event Hubs

  7. Selecteer de kopieerknop naast het veld Verbindingsreeks-primaire sleutel .

    Event Hubs - connection string ophalen

Verbindingsreeks voor een specifieke Event Hub in een naamruimte

Deze sectie bevat stappen voor het ophalen van een connection string naar een specifieke Event Hub in een naamruimte.

  1. Selecteer op de pagina Event Hubs-naamruimte de Event Hub in het onderste deelvenster.

  2. Selecteer op de pagina Event Hubs-exemplaarde optie Beleid voor gedeelde toegang in het menu links.

  3. Er is geen standaardbeleid gemaakt voor een Event Hub. Maak een beleid met de toegang Beheren, Verzenden of Luisteren .

  4. Selecteer het beleid in de lijst.

  5. Selecteer de kopieerknop naast het veld Verbindingsreeks-primaire sleutel .

    Verbindingsreeks met een specifieke Event Hub.

Azure PowerShell

U kunt de Get-AzEventHubKey gebruiken om de connection string voor het specifieke beleid/de specifieke regel op te halen.

Hier volgt een voorbeeldopdracht om de connection string voor een naamruimte op te halen. MyAuthRuleName is de naam van het beleid voor gedeelde toegang. Voor een naamruimte is er een standaard: RootManageSharedAccessKey.

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

Hier volgt een voorbeeldopdracht om de connection string voor een specifieke Event Hub in een naamruimte op te halen:

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

Hier volgt een voorbeeldopdracht om de connection string op te halen voor een Event Hub in een Geo-DR-cluster, dat een alias heeft.

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

Azure CLI

Hier volgt een voorbeeldopdracht om de connection string voor een naamruimte op te halen. MyAuthRuleName is de naam van het beleid voor gedeelde toegang. Voor een naamruimte is er een standaardnaamruimte: RootManageSharedAccessKey

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

Hier volgt een voorbeeldopdracht om de connection string voor een specifieke Event Hub in een naamruimte op te halen:

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

Hier volgt een voorbeeldopdracht om de connection string op te halen voor een Event Hub in een Geo-DR-cluster, dat een alias heeft.

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

Zie Azure CLI voor Event Hubs voor meer informatie over Azure CLI-opdrachten voor Event Hubs.

Volgende stappen

U kunt meer informatie over Event Hubs vinden via de volgende koppelingen: