Enviar eventos de cliente para Hubs de Eventos
Nota
O recurso de ouvinte de eventos está em visualização.
Descrição geral
Se quiser ouvir os eventos do cliente sem expor um ponto de extremidade acessível publicamente, você pode configurar uma regra de "ouvinte de eventos" com um ponto de extremidade do hub de eventos e um filtro para especificar os tipos de eventos a que se refere. Você pode configurar vários ouvintes de eventos ao mesmo tempo. O serviço Web PubSub notifica todos os ouvintes de eventos relacionados em paralelo quando um evento de cliente chega.
Este tutorial mostra como autorizar seu serviço Web PubSub a se conectar a Hubs de Eventos e como adicionar uma regra de ouvinte de eventos às configurações de serviço.
O serviço Web PubSub usa a ID do Microsoft Entra com identidade gerenciada para se conectar a Hubs de Eventos. Portanto, você deve habilitar a identidade gerenciada do serviço e certificar-se de que ele tenha permissões adequadas para se conectar a Hubs de Eventos. Você pode conceder a função de remetente de Dados dos Hubs de Eventos do Azure interna à identidade gerenciada para que ela tenha permissões suficientes.
Para configurar um ouvinte de Hubs de Eventos, você precisa:
- Enviar eventos de cliente para Hubs de Eventos
Configurar um ouvinte de eventos
Adicionar uma identidade gerenciada ao seu serviço Web PubSub
Encontre o seu serviço Azure Web PubSub a partir do portal do Azure. Navegue até Identidade. Para adicionar uma identidade atribuída ao sistema, na guia Sistema atribuído, alterne Status para Ativado. Selecione Guardar. Para obter mais informações sobre identidades gerenciadas, consulte Identidades gerenciadas no Azure Web PubSub.
Conceder uma Azure Event Hubs Data sender função à identidade gerenciada
Encontre seu recurso de Hubs de Eventos do Azure no portal do Azure. Você pode optar por conceder a função no nível de namespace dos Hubs de Eventos ou no nível da entidade. As etapas a seguir escolhem o nível do namespace.
Navegue até Controle de acesso. Selecione Adicionar atribuição de função.
Selecione a função Remetente de Dados dos Hubs de Eventos do Azure na guia Função . Em seguida, selecione Avançar.
Na guia Membros, escolha atribuir acesso à identidade gerenciada. Selecione Selecionar membros para selecionar seu serviço Web PubSub. Em seguida, você pode Revisar + atribuir sua atribuição de função.
Adicionar uma regra de ouvinte de eventos às suas configurações de serviço
Encontre o seu serviço a partir do portal do Azure. Navegue até Configurações. Em seguida, selecione Adicionar para configurar o ouvinte de eventos. Para uma configuração de hub existente, selecione ... no lado direito navegará até a mesma página de edição.
Em seguida, na página de edição abaixo, você precisa configurar o nome do hub e selecionar Adicionar para adicionar um ouvinte de eventos.
Na página Configurar ouvinte de eventos, primeiro configure um ponto de extremidade do hub de eventos. Você pode selecionar Selecionar Hub de Eventos em sua assinatura para selecionar ou inserir diretamente o namespace totalmente qualificado e o nome do hub de eventos. Em seguida, selecione
useresystemos eventos que você gostaria de ouvir. Por fim, selecione Confirmar quando tudo estiver concluído.
Teste sua configuração com demonstração ao vivo
Abra este aplicativo Web Cliente Consumidor de Hubs de Eventos, insira a cadeia de conexão Hubs de Eventos para se conectar a um hub de eventos como consumidor. Se você obtiver a cadeia de conexão Hubs de Eventos de um recurso de namespace de Hubs de Eventos em vez de uma instância de hub de eventos, precisará especificar o nome do hub de eventos. Este cliente consumidor do hub de eventos está conectado com o modo que lê apenas novos eventos; os eventos publicados antes não são vistos aqui. Você pode alterar o modo de conexão do cliente consumidor para ler todos os eventos disponíveis no ambiente de produção.
Use este aplicativo Web WebSocket Client para gerar eventos de cliente. Se você configurou para enviar um evento do sistema para esse hub de eventos, deverá ser capaz de ver um evento
connectedimpressoconnectedno cliente consumidor dos Hubs de Eventos depois de se conectar ao serviço Web PubSub com êxito. Você também pode gerar um evento de usuário com o aplicativo.
Próximos passos
Neste artigo, você aprendeu como os ouvintes de eventos funcionam e como configurar um ouvinte de eventos com um ponto de extremidade do hub de eventos. Para saber o formato de dados enviado aos Hubs de Eventos, leia a especificação a seguir.