Event Hubs 연결 문자열 가져오기

  • 아티클

네임스페이스의 이벤트 허브와 통신하려면 네임스페이스 또는 이벤트 허브에 대한 연결 문자열이 필요합니다. 애플리케이션의 네임스페이스에 대한 연결 문자열을 사용하는 경우 애플리케이션에는 네임스페이스의 모든 이벤트 허브에 대한 액세스 권한(관리, 읽기 또는 쓰기)이 제공됩니다. 이벤트 허브에 대한 연결 문자열을 사용하는 경우 해당 이벤트 허브에 대한 액세스 권한이 제공됩니다.

네임스페이스에 대한 연결 문자열에 포함되는 구성 요소는 다음과 같습니다.

  • 만든 Event Hubs 네임스페이스의 정규화된 도메인 이름(Event Hubs 네임스페이스 이름 뒤에 servicebus.windows.net이 포함됨)
  • 공유 액세스 키의 이름
  • 공유 액세스 키의 값

네임스페이스에 대한 연결 문자열은 다음과 같습니다.

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

이벤트 허브에 대한 연결 문자열에는 추가 구성 요소가 있습니다. 그것은 바로 EntityPath=<EventHubName>입니다.

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

이 문서에서는 Azure Portal, PowerShell 또는 CLI를 사용하여 네임스페이스 또는 특정 이벤트 허브에 대한 연결 문자열을 가져오는 방법을 보여줍니다.

Azure Portal

네임스페이스에 대한 연결 문자열

  1. Azure 포털에 로그인합니다.

  2. 왼쪽 탐색 메뉴에서 모든 서비스를 선택합니다.

  3. Analytics 섹션에서 Event Hubs를 선택합니다.

  4. 이벤트 허브 목록에서 해당 이벤트 허브를 선택합니다.

  5. Event Hubs 네임스페이스 페이지의 왼쪽 메뉴에서 공유 액세스 정책을 선택합니다.

  6. 정책 목록에서 공유 액세스 정책을 선택합니다. 기본 정책의 이름은 RootManageSharedAccessPolicy입니다. 적절한 권한(보내기, 수신 대기)으로 정책을 추가하고 해당 정책을 사용할 수 있습니다.

    Event Hubs shared access policies

  7. 연결 문자열 기본 키 필드 옆에 있는 복사 단추를 선택합니다.

    Event Hubs - get connection string

네임스페이스의 특정 이벤트 허브에 대한 연결 문자열

이 섹션에서는 네임스페이스의 특정 이벤트 허브에 대한 연결 문자열을 가져오는 단계를 설명합니다.

  1. Event Hubs 네임스페이스 페이지의 아래쪽 창에서 이벤트 허브를 선택합니다.

  2. Event Hubs 인스턴스 페이지의 왼쪽 메뉴에서 공유 액세스 정책을 선택합니다.

  3. 이벤트 허브에 대해 만들어진 기본 정책이 없습니다. 관리, 보내기 또는 수신 대기 액세스 권한이 있는 정책을 만듭니다.

  4. 목록에서 정책을 선택합니다.

  5. 연결 문자열 기본 키 필드 옆에 있는 복사 단추를 선택합니다.

    Connection string to a specific event hub.

Azure PowerShell

Get-AzEventHubKey를 사용하여 특정 정책/규칙에 대한 연결 문자열을 가져올 수 있습니다.

다음은 네임스페이스에 대한 연결 문자열을 가져오는 샘플 명령입니다. MyAuthRuleName은 공유 액세스 정책의 이름입니다. 네임스페이스의 경우 기본값은 RootManageSharedAccessKey입니다.

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

다음은 네임스페이스 내의 특정 이벤트 허브에 대한 연결 문자열을 가져오는 샘플 명령입니다.

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

다음은 별칭이 있는 Geo-DR 클러스터의 이벤트 허브에 대한 연결 문자열을 가져오는 샘플 명령입니다.

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

Azure CLI

다음은 네임스페이스에 대한 연결 문자열을 가져오는 샘플 명령입니다. MyAuthRuleName은 공유 액세스 정책의 이름입니다. 네임스페이스의 경우 기본값은 RootManageSharedAccessKey입니다.

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

다음은 네임스페이스 내의 특정 이벤트 허브에 대한 연결 문자열을 가져오는 샘플 명령입니다.

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

다음은 별칭이 있는 Geo-DR 클러스터의 이벤트 허브에 대한 연결 문자열을 가져오는 샘플 명령입니다.

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

Event Hubs에 대한 Azure CLI 명령과 관련된 자세한 내용은 Event Hubs용 Azure CLI를 참조하세요.

다음 단계

Event Hubs에 대한 자세한 내용은 다음 링크를 참조하세요.