Enviar eventos de cliente aos Hubs de Eventos
Observação
O recurso de ouvinte de eventos está em versão prévia. Ainda não há suporte para o envio de eventos de clientes MQTT para o ouvinte de eventos.
Visão geral
Se você quiser escutar eventos de cliente sem expor um ponto de extremidade publicamente acessível, poderá configurar uma regra de "ouvinte de eventos" com um ponto de extremidade do hub de eventos e um filtro para especificar a quais tipos de eventos ele se refere. Você pode configurar vários ouvintes de eventos ao mesmo tempo. O serviço Web PubSub notifica todos os ouvintes de eventos em paralelo quando um evento de cliente é recebido.
Este tutorial mostra como autorizar seu serviço Web PubSub a se conectar aos Hubs de Eventos e como adicionar uma regra de ouvinte de eventos às configurações de serviço.
O serviço Web PubSub usa o Microsoft Entra ID com identidade gerenciada para se conectar aos Hubs de Eventos. Portanto, você deve habilitar a identidade gerenciada do serviço e verificar se ela tem permissões adequadas para se conectar aos Hubs de Eventos. Você pode conceder a função interna remetente de dados dos Hubs de Eventos do Azure à identidade gerenciada para que ela tenha permissões suficientes.
Para configurar um ouvinte dos Hubs de Eventos, você precisa:
- Enviar eventos de clientes para os Hubs de Eventos
Configurar ouvinte de eventos
Adicionar uma identidade gerenciada ao serviço Web PubSub
Localize o serviço Azure Web PubSub do portal do Azure. Navegue até Identidade. Para adicionar uma identidade atribuída pelo sistema, na guia Atribuída pelo sistema, alterne o Status para Ativado. Selecione Salvar. Para saber mais sobre as identidades gerenciadas, confira Identidades gerenciadas no Azure Web PubSub.
Conceder uma função Azure Event Hubs Data sender à identidade gerenciada
Localize seu recurso dos Hubs de Eventos do Azure no portal do Azure. Você pode optar por conceder a função no nível do namespace ou da entidade dos Hubs de Eventos. As etapas a seguir escolhem o nível do namespace.
Navegue até o 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, opte por atribuir acesso à Identidade gerenciada. Selecione Selecionar membros para selecionar o serviço Web PubSub. Em seguida, você pode Examinar + atribuir a atribuição de função.
Adicionar uma regra de ouvinte de eventos às configurações de serviço
Localize seu serviço no portal do Azure. Procure Configurações. Em seguida, selecione Adicionar para configurar o ouvinte de eventos. Para uma configuração de hub existente, selecionar ... no lado direito navegará para a mesma página de edição.
Em seguida, na página de edição abaixo, você precisará 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 escolher Selecionar Hub de Eventos na assinatura para selecionar ou inserir diretamente o namespace totalmente qualificado e o nome do hub de eventos. Em seguida, selecione os eventos
useresystemque você gostaria de escutar. Por fim, selecione Confirmar quando tudo estiver concluído.
Testar a configuração com uma demonstração dinâmica
Abra este aplicativo Web Cliente do Consumidor dos Hubs de Eventos e insira a cadeia de conexão dos Hubs de Eventos para se conectar a um hub de eventos como consumidor. Se você receber a cadeia de conexão dos Hubs de Eventos de um recurso de namespace dos Hubs de Eventos em vez de uma instância do hub de eventos, precisará especificar o nome do hub de eventos. Esse cliente consumidor do hub de eventos está conectado com o modo que lê apenas novos eventos; os eventos publicados anteriormente 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 Cliente WebSocket para gerar eventos de cliente. Se você tiver configurado para enviar o evento do sistema
connectedpara esse hub de eventos, poderá ver um eventoconnectedimpresso 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óximas etapas
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 conhecer o formato de dados enviado aos Hubs de Eventos, leia a especificação a seguir.