Integrar o Azure Event Grid com Auth0

Este artigo descreve como conectar suas contas Auth0 e Azure criando um tópico de parceiro da Grade de Eventos.

Enviar eventos do Auth0 para a Grade de Eventos do Azure

Para enviar eventos Auth0 para o Azure:

1. Registe o fornecedor de recursos do Event Grid na sua subscrição do Azure.
2. Autorize o parceiro a criar um tópico de parceiro no seu grupo de recursos.
3. Solicite Auth0 para habilitar o fluxo de eventos para um tópico de parceiro configurando um tópico de parceiro Auth0 no Painel Auth0.
4. Ative o tópico do parceiro para que seus eventos comecem a fluir para o tópico do parceiro.
5. Inscreva-se em eventos.

Registrar o provedor de recursos do Event Grid

A menos que tenha usado o Event Grid antes, precisa de registar o fornecedor de recursos do Event Grid. Se já usaste a Grelha de Eventos antes, salta para a secção seguinte.

No portal do Azure, siga estes passos:

1. No menu à esquerda, selecione Assinaturas.

2. Selecione a subscrição que pretende usar para o Event Grid na lista de subscrições.

3. Na página de Subscrição , em Definições no menu esquerdo, selecione Fornecedores de Recursos.

4. Procure por Microsoft.EventGrid e confirme que o Status é NotRegistered.

5. Selecione Microsoft.EventGrid na lista de provedores.

6. Na barra de comandos, selecione Registar.

   

7. Atualize para se certificar de que o estado de Microsoft.EventGrid foi alterado para Registado.

   

Autorizar o parceiro a criar um tópico de parceiro

Tem de conceder o seu consentimento ao parceiro para criar tópicos de parceiros num grupo de recursos que designar. Esta autorização tem um prazo de validade. É eficaz para o período de tempo especificado entre 1 a 365 dias.

1. Inicie sessão no portal do Azure.

2. Na barra de pesquisa no topo, insira Configurações de Parceiros e selecione Configurações de Parceiros do Event Grid em Serviços nos resultados.

3. Na página Configurações de Parceiro da Grade de Eventos, selecione o botão Criar configuração de parceiro da Grade de Eventos na página (ou) selecione + Criar na barra de comandos.

   

4. Na página Criar Configuração de Parceiro, execute as seguintes etapas:

   1. Na seção Detalhes do Projeto, selecione a assinatura do Azure e o grupo de recursos onde você deseja permitir que o parceiro crie um tópico de parceiro.

   2. Na seção Autorizações de Parceiro, especifique um tempo de expiração padrão para autorizações de parceiro definidas nessa configuração.

   3. Para fornecer sua autorização para que um parceiro crie tópicos de parceiros no grupo de recursos especificado, selecione o link + Autorização de parceiro .

      

5. Na página Adicionar autorização de parceiro para criar recursos, você verá uma lista de parceiros verificados. Um parceiro verificado é um parceiro cuja identidade foi validada pela Microsoft. Siga estas etapas para autorizar Auth0 a criar tópico de parceiro.

   1. Selecione o parceiro verificado (Auth0, SAP, Tribal Group ou Microsoft Graph API) na lista de parceiros verificados.

   2. Especifique o tempo de expiração da autorização.

   3. selecione Adicionar.

      

      Importante

      Seu parceiro não poderá criar recursos (tópicos de parceiros) em sua assinatura do Azure após o tempo de expiração da autorização.

6. De volta à página Criar Configuração de Parceiro, verifique se o parceiro foi adicionado à lista de autorização de parceiro no final.

7. Selecione Rever + criar na parte inferior da página.

8. Na página Revisão, revise todas as configurações e selecione Criar para criar o registro de parceiro.

Configurar um tema de parceiro do Auth0

Parte do processo de integração é configurar o Auth0 para uso como fonte de eventos usando o Auth0 Dashboard.

1. Faça login no Painel de Controlo Auth0.
2. Navegue até Monitorização>.
3. Clique em + Criar fluxo de log.
4. Selecione Grade de Eventos do Azure e insira um nome exclusivo para seu novo fluxo.
5. Para ID de Assinatura, insira sua ID de assinatura do Azure.
6. Para Região do Azure, selecione a região do Azure na qual o grupo de recursos existe.
7. Em Grupo de Recursos, insira o nome do grupo de recursos.
8. Em Filtrar por Categoria de Evento, selecione Tudo ou filtrar tipos específicos de eventos.
9. Selecione a opção Usar um dia e hora específicos para iniciar a transmissão se quiser que o streaming comece em um dia e hora específicos.
10. Clique em Guardar.

Deverá ver o tópico de parceria no grupo de recursos que especificou. Ative o tópico do parceiro para que seus eventos comecem a fluir para o tópico do parceiro. Em seguida, inscreva-se em eventos.

Ativar um tópico de parceiro

1. Na barra de pesquisa do portal do Azure, procure e selecione Tópicos de Parceiros da Grade de Eventos.

2. Na página de Tópicos de Parceiros da Grelha de Eventos , selecione um tema de parceiro com o Estado de Ativação definido para Nunca Ativado.

   

3. Revise a mensagem de ativação e selecione Ativar na página ou na barra de comandos para ativar o tópico do parceiro antes do tempo de expiração mencionado na página.

   

4. Confirme se o status de ativação está definido como Ativado e, em seguida, crie assinaturas de eventos para o tópico do parceiro selecionando + Assinatura de Evento na barra de comandos.

   

Subscrever os eventos

Primeiro, crie um manipulador de eventos que manipule eventos do parceiro. Por exemplo, crie um hub de eventos, fila ou tópico do Service Bus ou uma função do Azure. Depois, crie uma subscrição de evento para o tópico parceiro usando o gestor de eventos que criou.

Criar um manipulador de eventos

Para testar o tema do teu parceiro, precisas de um gestor de eventos. Vai à tua subscrição do Azure e cria um serviço suportado como gestor de eventos, como uma Função do Azure. Por exemplo, veja o exemplo do Event Grid Viewer que pode usar como gestor de eventos através de webhooks.

Subscrever o tópico de parceiros

Subscrever o tópico de parceiro indica à Event Grid para onde deseja que os eventos do seu parceiro sejam entregues.

1. No portal Azure, na caixa de pesquisa, introduza Tópicos de Parceiros da Grelha de Eventos e depois selecione Tópicos de Parceiros da Grelha de Eventos.

2. Na página Event Grid Partner Topics, selecione o tópico do parceiro na lista.

   

3. Na página Tópico de Parceiro do Event Grid, selecione + Assinatura de Evento na barra de comandos.

   

4. Na página Criar Assinatura de Evento , execute as seguintes etapas:

   1. Insira um nome para a assinatura do evento.

   2. Em Filtrar para Tipos de Eventos, selecione os tipos de eventos que a sua subscrição recebe.

   3. Para Endpoint Type, selecione um serviço Azure (Azure Function, Storage Queues, Event Hubs, Service Bus Queue, Service Bus Topic ou Hybrid Connections), ou selecione webhook.

   4. Selecione o link Configurar um ponto de extremidade. Este exemplo utiliza um destino do Hubs de Eventos do Azure.

      

   5. Na página Selecionar Hub de Eventos, selecione configurações para o ponto de extremidade e selecione Confirmar Seleção.

      

   6. Agora, na página Criar Assinatura de Evento , selecione Criar.

      

Tente invocar qualquer uma das ações Auth0 que acionam um evento a ser publicado para ver o fluxo de eventos.

Verificar a integração

Para verificar se a integração está funcionando conforme o esperado:

1. Faça login no Painel Auth0.
2. Navegue até Monitorização>.
3. Clique no seu fluxo de Event Grid.
4. Uma vez no stream, clique na guia Saúde . O fluxo deve estar ativo e, desde que você não veja nenhum erro, o fluxo está funcionando.

Tentativas de entrega e novas tentativas

Os eventos Auth0 são entregues ao Azure por meio de um mecanismo de streaming. Cada evento é enviado à medida que é acionado em Auth0. Se a Grade de Eventos não puder receber o evento, a Auth0 tentará novamente até três vezes para entregar o evento. Caso contrário, Auth0 registrará a falha na entrega em seu sistema.

Próximos passos

• Tópico de Parceiro da Auth0
• Visão geral dos tópicos de parceiros
• Torne-se um parceiro da Grade de Eventos