Partilhar via


Integrar a Grade de Eventos do Azure com Auth0

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

Nota

Consulte os códigos de tipo de evento Auth0 para obter uma lista completa dos eventos suportados por Auth0

Enviar eventos do Auth0 para a Grade de Eventos do Azure

Para enviar eventos 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 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 da Grade de Eventos

A menos que você já tenha usado a Grade de Eventos antes, precisará registrar o provedor de recursos da Grade de Eventos. Se já utilizou a Grelha de Eventos antes, avance para a secção seguinte.

No portal do Azure, execute as seguintes etapas:

  1. No menu à esquerda, selecione Assinaturas.

  2. Selecione a subscrição que pretende utilizar para a Grelha de Eventos na lista de subscrições.

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

  4. Procure Microsoft.EventGrid e confirme se o Status não está registrado.

  5. Selecione Microsoft.EventGrid na lista de provedores.

  6. Selecione Registrar na barra de comandos.

    Imagem mostrando o registro do provedor Microsoft.EventGrid com a assinatura do Azure.

  7. Atualize para verificar se o status de Microsoft.EventGrid foi alterado para Registrado.

    Imagem mostrando o registro bem-sucedido do provedor Microsoft.EventGrid com a assinatura do Azure.

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.

Importante

Para uma postura de segurança maior, especifique o tempo mínimo de expiração que oferece ao parceiro tempo suficiente para configurar seus eventos para fluir para a Grade de Eventos e provisionar o tópico do parceiro. 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.

Nota

A Grade de Eventos começou a aplicar verificações de autorização para criar tópicos de parceiros por volta de 30 de junho de 2022.

  1. Inicie sessão no portal do Azure.

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

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

    Captura de tela mostrando a página Configurações de Parceiros da Grade de Eventos com a lista de configurações de parceiros e o link para criar um registro de parceiro.

  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 .

      Captura de tela mostrando a página Criar Configuração de Parceiro com o link Autorização de Parceiro selecionado.

  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 o Auth0 a criar um 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.

      Captura de ecrã a mostrar a página que lhe permite conceder a um parceiro verificado a autorização para criar recursos no seu grupo de recursos.

      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 na parte inferior.

  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 tópico de parceiro 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 Auth0.
  2. Navegue até Fluxos de monitoramento>.
  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 Usar um dia e hora específicos para iniciar o fluxo a partir da opção se quiser que o streaming comece em um dia e hora específicos.
  10. Clique em Guardar.

Você deve ver o tópico de parceiro no grupo de recursos especificado. 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.

Captura de ecrã a mostrar o tópico do parceiro na lista.

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 Tópicos de Parceiros da Grade de Eventos , selecione o tópico do parceiro na lista.

    Captura de ecrã que mostra a seleção de um tópico de parceiro na página Tópicos de Parceiros da Grelha de Eventos.

  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.

    Captura de tela mostrando a seleção do botão Ativar na barra de comandos ou 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.

    Captura de tela mostrando o estado de ativação de um tópico de parceiro como **Ativado**.

Subscrever eventos

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

Criar um manipulador de eventos

Para testar o tópico do parceiro, você precisará de um manipulador de eventos. Aceda à sua subscrição do Azure e crie um serviço suportado como um manipulador de eventos, como uma Função do Azure. Para obter um exemplo, consulte Exemplo de Visualizador de Grade de Eventos que você pode usar como um manipulador de eventos por meio de webhooks.

Subscrever o tópico de parceiros

Subscrever o tópico de parceiro indica à Grelha de Eventos onde pretende que os eventos do seu parceiro sejam entregues.

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

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

    Captura de ecrã a mostrar a seleção de um tópico de parceiro na página Tópicos de Parceiros da Grelha de Eventos.

  3. Na página Tópico do Parceiro da Grade de Eventos do tópico do parceiro, selecione + Assinatura do Evento na barra de comandos.

    Captura de ecrã a mostrar a seleção do botão Adicionar Subscrição de Evento na página Tópico do Parceiro da Grelha de Eventos.

  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 sua assinatura receberá.

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

    4. Clique no link Selecionar um ponto de extremidade . Neste exemplo, vamos usar o destino ou o ponto de extremidade dos Hubs de Eventos do Azure.

      Captura de tela mostrando a configuração de um ponto de extremidade para uma assinatura de evento.

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

      Captura de tela mostrando a configuração de um ponto de extremidade de Hubs de Eventos.

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

      Captura de ecrã a mostrar a página Criar Subscrição de Eventos com exemplos de configurações.

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é Fluxos de monitoramento>.
  3. Clique no fluxo da sua Grade de Eventos.
  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