Integrar o Grade de Eventos do Azure com o Auth0

Este artigo descreve como conectar suas contas do Auth0 e do Azure ao criar um partner topic do Event Grid.

Enviar eventos do Auth0 para a Grade de Eventos do Azure

Para enviar eventos do Auth0 para o Azure:

1. Registre o provedor de recursos da Grade de Eventos com sua assinatura do Azure.
2. Autorize o parceiro a criar um tópico de parceiro em seu grupo de recursos.
3. Solicite o Auth0 para habilitar o fluxo de eventos para um tópico de parceiro configurando um tópico de parceiro do Auth0 no Painel do Auth0.
4. Ative o tópico do parceiro para que os eventos comecem a fluir para o tópico do parceiro.
5. Assinar eventos.

Registrar o provedor de recursos do Event Grid

A menos que você tenha usado a Grade de Eventos antes, será necessário registrar o provedor de recursos da Grade de Eventos. Se você usou a Grade de Eventos antes, pule para a próxima seção.

No portal do Azure, siga estas etapas:

1. No menu à esquerda, selecione Assinaturas.

2. Selecione a assinatura que você deseja usar para a Grade de Eventos na lista de assinaturas.

3. Na página Assinatura , em Configurações no menu à esquerda, selecione Provedores de recursos.

4. Pesquise por Microsoft.EventGrid e confirme que o Status é Não registrado.

5. Selecione Microsoft.EventGrid na lista de provedores.

6. Na barra de comandos, selecione Registrar.

   

7. Atualize para garantir que o status de Microsoft.EventGrid foi alterado para Registrado.

   

Autorizar o parceiro a criar um tópico de parceiro

Você deve conceder seu consentimento ao parceiro para criar tópicos de parceiro em um grupo de recursos que você designar. Essa autorização tem um tempo de expiração. Ela é eficaz para o período de tempo especificado entre 1 e 365 dias.

1. Entre no portal do Azure.

2. Na barra de pesquisa na parte superior, insira Configurações de parceiro e selecione Configurações de parceiro da Grade de Eventos em Serviços nos resultados.

3. Na página Configurações do parceiro da Grade de Eventos, selecione Criar botão de configuração do 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 em que 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 as autorizações de parceiro definidas nessa configuração.

   3. Para fornecer sua autorização para um parceiro criar tópicos de parceiro 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. Parceiro verificado é um parceiro cuja identidade foi validada pela Microsoft. Siga estas etapas para autorizar o Auth0 a criar um tópico de parceiro.

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

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

   3. selecione Adicionar.

      

      Importante

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

6. Na página Criar configuração de parceiro, verifique se o parceiro foi adicionado à lista de autorização do parceiro na parte inferior.

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

8. Na página Examinar, examine todas as configurações e selecione Criar para criar o registro do parceiro.

Configurar um tópico de parceiro do Auth0

Parte do processo de integração é configurar o Auth0 para uso como uma origem de evento usando o Painel do Auth0.

1. Faça logon no Painel do Auth0.
2. Navegue até Monitoramento>Fluxos.
3. Clique em + Criar Fluxo de logs.
4. Selecione Grade de Eventos do Azure e insira um nome exclusivo para o novo fluxo.
5. Em ID da assinatura, insira a ID de sua assinatura do Azure.
6. Em 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 Todos ou filtre para tipos específicos de eventos.
9. Selecione Usar um dia e hora específicos para iniciar o fluxo a partir da opção se você deseja que o streaming comece em um dia e hora específicos.
10. Clique em Salvar.

Você deve ver o tópico do parceiro no grupo de recursos especificado. Ative o tópico do parceiro para que os eventos comecem a fluir para o tópico do parceiro. Em seguida, assine eventos.

Ativar um tópico de parceiro

1. Na barra de pesquisa do portal do Azure, pesquise e selecione Tópicos de parceiro na Grade de Eventos.

2. Na página Tópicos do Parceiro da Grade de Eventos , selecione um tópico de parceiro com o Estado de Ativação definido como Nunca Ativado.

   

3. Examine a mensagem de ativação e selecione Ativar na página ou na barra de comandos para ativar o tópico de 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 evento para o tópico do parceiro selecionando + Assinatura de evento na barra de comandos.

   

Assinar eventos

Primeiro, crie um manipulador de eventos que processa os eventos do parceiro. Por exemplo, crie um hub de eventos, uma fila do Barramento de Serviço, um tópico ou uma função do Azure. Em seguida, crie uma assinatura de evento para o tópico do parceiro usando o manipulador de eventos que você criou.

Criar um manipulador de eventos

Para testar o tópico do seu parceiro, você precisa de um manipulador de eventos. Acesse sua assinatura de Azure e crie um serviço com suporte como um manipulador de eventos, como uma função Azure. Para obter um exemplo, consulte o exemplo do Visualizador da Grade de Eventos que você pode usar como um manipulador de eventos por meio de webhooks.

Inscrever-se no tópico do parceiro

A assinatura do tópico do parceiro informa à Grade de Eventos onde você deseja que os eventos de parceiro sejam entregues.

1. No portal do Azure, na caixa de pesquisa, insira Tópicos do Parceiro da Grade de Eventos e selecione Tópicos do Parceiro da Grade de Eventos.

2. Na página Tópicos de parceiro da Grade de Eventos, selecione o tópico de parceiro na lista.

   

3. Na página Tópico de parceiro da Grade de Eventos para o tópico de parceiro, selecione + Assinatura de evento na barra de comandos.

   

4. Na página Criar Assinatura de Eventos, faça o seguinte:

   1. Insira um nome para a assinatura de evento.

   2. Em Filtrar para Tipos de Eventos, selecione os tipos de eventos que a assinatura recebe.

   3. Para Tipo de ponto de extremidade, selecione um serviço do Azure (Função do Azure, Filas de Armazenamento, Hubs de Eventos, Fila de Barramento de Serviço, Tópico de Barramento de Serviço, Conexões Híbridas etc.) ou selecione o webhook.

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

      

   5. Na página Selecionar hub de eventos, selecione as 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 disparam 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 logon no Painel do Auth0.
2. Navegue até Monitoramento>Fluxos.
3. Clique no fluxo da Grade de Eventos.
4. No fluxo, clique na guia Integridade. 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 conforme é disparado em Auth0. Se a grade de eventos não puder receber o evento, o Auth0 tentará entregar o evento até três vezes. Caso contrário, o Auth0 registrará a falha de entrega em seu sistema.

Próximas etapas

• Tópico de parceiro do Auth0
• Visão geral dos tópicos de parceiros
• Torne-se um parceiro do Event Grid