Enviar eventos de cliente para Hubs de Eventos

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 em paralelo todos os ouvintes do evento em causa quando ocorre um evento de cliente.

Este tutorial mostra-lhe como autorizar o seu serviço Web PubSub a ligar-se ao Event Hubs e como adicionar uma regra de escuta de eventos às definições do serviço.

O serviço Web PubSub utiliza o Microsoft Entra ID com identidade gerida para estabelecer ligação ao Event Hubs. 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. Pode conceder a função incorporada Remetente de Dados dos Hubs de Eventos do Azure à identidade gerida para que tenha permissões suficientes.

Para configurar um ouvinte de Hubs de Eventos, você precisa:

• Enviar eventos de cliente para Hubs de Eventos
  • Descrição geral
  • Configurar um ouvinte de eventos
    • Adicionar uma identidade gerenciada ao seu serviço Web PubSub
    • Conceder uma Hubs de Eventos do Azure Data sender função à identidade gerenciada
    • Adicione uma regra de detetor de eventos às definições do serviço
  • Teste sua configuração com demonstração ao vivo
  • Passos seguintes

Configurar um ouvinte de eventos

Adicionar uma identidade gerenciada ao seu serviço Web PubSub

Encontre o seu serviço Azure Web PubSub no 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 Hubs de Eventos do Azure Data sender função à identidade gerenciada

1. 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.

2. Navegue até Controle de acesso. Selecione Adicionar atribuição de função.

3. Selecione a função Remetente de Dados dos Hubs de Eventos do Azure na guia Função . Em seguida, selecione Avançar.

4. 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 escuta de eventos às definições do seu serviço

1. 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 existente do concentrador, selecionar ... do lado direito irá levá-lo para a mesma página de edição.

2. 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.

3. Na página Configurar Escuta 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 user e system eventos que você gostaria de ouvir. Por fim, selecione Confirmar quando tudo estiver concluído.

Teste sua configuração com demonstração ao vivo

1. Abra esta aplicação Web Cliente Consumidor do Event Hubs, introduza a cadeia de ligação do Event Hubs para ligar a um Event Hub como consumidor. Se obtiver a cadeia de ligação do Event Hubs a partir de um recurso de espaço de nomes do Event Hubs, em vez de uma instância de hub de eventos, terá de 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.

2. Use este aplicativo Web WebSocket Client para gerar eventos de cliente. Se você configurou para enviar um evento connected do sistema para esse hub de eventos, deverá ser capaz de ver um evento impresso connected no 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, aprendeu como os detetores de eventos funcionam e como configurar um detetor de eventos com um ponto final de um Event Hub. Para saber o formato de dados enviado aos Hubs de Eventos, leia a especificação a seguir.