Event Hubs에 클라이언트 이벤트 보내기
참고 항목
이벤트 수신기 기능은 미리 보기 상태입니다.
개요
공개적으로 액세스할 수 있는 엔드포인트를 노출하지 않고 클라이언트 이벤트를 수신 대기하려는 경우, 이벤트 허브 엔드포인트를 사용하여 ‘이벤트 수신기’ 규칙 및 이와 관련된 이벤트 종류를 지정하는 필터를 구성할 수 있습니다. 여러 이벤트 수신기를 동시에 구성할 수 있습니다. Web PubSub 서비스는 클라이언트 이벤트가 발생할 때 모든 관련 이벤트 수신기에 병렬로 알립니다.
이 자습서에서는 Event Hubs에 연결할 수 있도록 Web PubSub 서비스에 권한을 부여하는 방법과 서비스 설정에 이벤트 수신기 규칙을 추가하는 방법을 보여 줍니다.
Web PubSub 서비스는 관리 ID로 Microsoft Entra ID를 사용하여 Event Hubs에 연결합니다. 따라서 서비스의 관리 ID를 사용하도록 설정하고 Event Hubs에 연결할 수 있는 적절한 권한이 있는지 확인해야 합니다. 관리 ID에 기본 제공 Azure Event Hubs 데이터 보낸 사람 역할을 부여하여 충분한 권한을 보유하도록 할 수 있습니다.
Event Hubs 수신기를 구성하려면 다음을 수행해야 합니다.
이벤트 수신기 구성
Web PubSub 서비스에 관리 ID 추가
Azure Portal에서 Azure Web PubSub 서비스를 찾습니다. ID로 이동합니다. 시스템이 할당한 ID를 추가하려면 시스템 할당 탭에서 상태를 켜기로 전환합니다. 저장을 선택합니다. 관리 ID에 대한 자세한 내용은 Azure Web PubSub의 관리 ID를 참조하세요.
관리 ID에 Azure Event Hubs Data sender 역할 부여
Azure Portal에서 Azure Event Hubs 리소스를 찾습니다. Event Hubs 네임스페이스 수준 또는 엔터티 수준에서 역할을 부여하도록 선택할 수 있습니다. 다음 단계에서는 네임스페이스 수준을 선택합니다.
Access Control로 이동합니다. 역할 할당 추가를 선택합니다.
역할 탭에서 Azure Event Hubs 데이터 보낸 사람 역할을 선택한 후 다음을 선택합니다.
구성원 탭에서 관리 ID에 대한 액세스 권한을 할당하도록 선택합니다. 구성원 선택을 선택하여 Web PubSub 서비스를 선택합니다. 그런 다음 역할 할당을 검토 + 할당할 수 있습니다.
서비스 설정에 이벤트 수신기 규칙 추가
Azure Portal에서 서비스를 찾습니다. 설정으로 이동합니다. 그런 다음 추가를 선택하여 이벤트 수신기를 구성합니다. 기존 허브 구성의 경우 오른쪽의 ...를 선택하면 동일한 편집 페이지로 이동합니다.
그런 다음 아래 편집 페이지에서 허브 이름을 구성하고 추가를 선택하여 이벤트 수신기를 추가해야 합니다.
이벤트 수신기 구성 페이지에서 먼저 이벤트 허브 엔드포인트를 구성합니다. 선택할 구독에서 이벤트 허브 선택을 선택하거나, 정규화된 네임스페이스와 이벤트 허브 이름을 직접 입력할 수 있습니다. 그런 다음 수신 대기하려는
user및system이벤트를 선택합니다. 마지막으로 모든 작업이 완료되면 확인을 선택합니다.
라이브 데모를 사용하여 구성 테스트
이 Event Hubs 소비자 클라이언트 웹앱을 열고 Event Hubs 연결 문자열을 입력하여 이벤트 허브에 소비자로 연결합니다. 이벤트 허브 인스턴스 대신 Event Hubs 네임스페이스 리소스에서 Event Hubs 연결 문자열을 가져오는 경우 이벤트 허브 이름을 지정해야 합니다. 이 이벤트 허브 소비자 클라이언트는 새 이벤트만 읽는 모드와 연결됩니다. 이전에 게시된 이벤트는 여기에 표시되지 않습니다. 소비자 클라이언트 연결 모드를 변경하면 프로덕션 환경에서 사용 가능한 모든 이벤트를 읽을 수 있습니다.
이 WebSocket 클라이언트 웹앱을 사용하여 클라이언트 이벤트를 생성합니다.
connected시스템 이벤트를 해당 이벤트 허브로 보내도록 구성한 경우, Web PubSub 서비스에 성공적으로 연결한 후 Event Hubs 소비자 클라이언트에서 인쇄된connected이벤트를 볼 수 있어야 합니다. 앱으로 사용자 이벤트를 생성할 수도 있습니다.
다음 단계
이 문서에서는 이벤트 수신기가 작동하는 방식과 이벤트 허브 엔드포인트로 이벤트 수신기를 구성하는 방법을 알아보았습니다. Event Hubs로 전송되는 데이터 형식을 알아보려면 다음 사양을 참조하세요.