Partilhar via


Enviar eventos de cliente para Hubs de Eventos

Nota

O recurso de ouvinte de eventos está em visualização. O envio de eventos do cliente MQTT para o ouvinte de eventos ainda não é suportado.

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 o 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:

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.

Captura de ecrã a mostrar a adição de uma identidade atribuída pelo sistema no portal

Conceder uma Azure Event Hubs 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. Captura de tela da concessão de acesso ao namespace Hubs de Eventos

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

  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. Captura de ecrã a mostrar a seleção da identidade do serviço Web PubSub

Adicionar uma regra de ouvinte de eventos às suas configurações de 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 de hub existente, selecione ... no lado direito navegará até a mesma página de edição. Captura de ecrã das definições do Web PubSub

  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. Captura de ecrã a mostrar a definição das definições do hub

  3. 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 user e system eventos que você gostaria de ouvir. Por fim, selecione Confirmar quando tudo estiver concluído. Captura de tela da configuração do Ouvinte de Hubs de Eventos

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

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

  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. Captura de tela de um evento conectado impresso no aplicativo cliente consumidor dos Hubs de Eventos.Captura de tela mostrando a área do aplicativo cliente WebSocket para gerar um evento de usuário.

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.