Compartilhar via

Assinar eventos publicados por um parceiro com Grade de Eventos do Azure

  • Artigo

Este artigo descreve as etapas para assinar eventos originados em um sistema de propriedade de ou gerenciado por um parceiro (SaaS, Enterprise Resource Planning (ERP), etc).

Importante

Se você não estiver familiarizado com o recurso Eventos de Parceiros, consulte a Visão geral de Eventos de Parceiros para entender a lógica das etapas neste artigo.

Etapas de alto nível

Estas são as etapas que um assinante precisa executar para receber eventos de um parceiro.

  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 ao parceiro para habilitar o fluxo de eventos para um tópico de parceiro.
  4. Ative o tópico do parceiro para que os eventos comecem a fluir para o tópico de parceiro.
  5. Assinar eventos.

Registrar o provedor de recursos da Grade de Eventos

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

No portal do Azure, siga as etapas abaixo:

  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, selecione Provedores de recursos na seção Configurações no menu à esquerda.

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

  5. Selecione Microsoft.EventGrid na lista de provedores.

  6. Selecione Registrar na barra de comandos.

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

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

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

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.

Importante

Para obter uma posição 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 parceiro) em sua assinatura do Azure após o tempo de expiração da autorização.

O exemplo a seguir mostra a maneira de criar um recurso de configuração de parceiro que contém a autorização do parceiro. Você deve identificar o parceiro fornecendo a ID de registro do parceiro ou o nome do parceiro. Ambos podem ser obtidos com seu parceiro, mas apenas um deles é necessário. Para sua conveniência, os exemplos a seguir deixam um tempo de expiração de exemplo no formato UTC.

Portal do Azure

  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.

    Captura de tela mostrando as configurações do parceiro da Grade de Eventos com a lista de configurações do parceiro 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 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.

      Captura de tela mostrando a página para Criar configuração do parceiro com o link de autorização do parceiro selecionado.

  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. Você pode selecionar um parceiro verificado e selecionar o botão Adicionar na parte inferior para dar ao parceiro a autorização para adicionar um tópico de parceiro no grupo de recursos. Essa autorização é efetiva até o tempo de expiração.

    Você também tem a opção de autorizar um parceiro não verificado. A menos que o parceiro seja uma entidade que você conhece bem, por exemplo, uma organização dentro de sua empresa, é altamente incentivado que você trabalhe apenas com parceiros verificados. Se o parceiro ainda não tiver sido verificado, incentive-os a serem verificados solicitando que entrem em contato com a equipe da Grade de Eventos em askgrid@microsoft.com.

    1. Para autorizar um parceiro verificado:

      1. Selecione o parceiro na lista.

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

      3. selecione Adicionar.

        Captura de tela para conceder a um parceiro verificado a autorização para criar recursos em seu grupo de recursos.

    2. Para autorizar um parceiro não verificado, selecione Autorizar parceiro não verificado e siga estas etapas:

      1. Insira a ID de registro do parceiro. Você precisa pedir essa ID ao seu parceiro.

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

      3. Selecione Adicionar.

        Captura de tela para conceder a um parceiro não verificado a autorização para criar recursos em seu grupo de recursos.

        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.

    Captura de tela mostrando a página para Criar configuração do parceiro com autorização do parceiro que você acabou de adicionar.

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

Solicitar ao parceiro para habilitar o fluxo de eventos para um tópico de parceiro

Aqui está a lista de parceiros e um link para enviar uma solicitação para habilitar o fluxo de eventos para um tópico de parceiro.

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

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

  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.

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

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

Assinar eventos

Primeiro, crie um manipulador de eventos que processa os eventos do parceiro. Por exemplo, crie um hub de eventos, fila ou tópico de Barramento de Serviço 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 seu tópico de parceiro, você precisará de um manipulador de eventos. Acesse sua assinatura do Azure e crie um serviço que seja compatível como um manipulador de eventos, como uma Função do Azure. Para obter um exemplo, consulte o exemplo do Visualizador de Grade de Eventos que você pode usar como manipulador de eventos por meio de webhooks.

Assinar o 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, digite Tópicos de parceiro da Grade de Eventos na caixa de pesquisa e selecione Tópicos de 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.

    Captura de tela mostrando a seleção de um tópico de parceiro na página Tópicos de parceiro da Grade de Eventos.

  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.

    Imagem mostrando a seleção do botão Adicionar Assinatura de Evento na página Tópico de Parceiro da Grade de Eventos.

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

    4. Selecione o link Configurar um ponto de extremidade. Neste exemplo, vamos usar destino ou ponto de extremidade de 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 as configurações para o ponto de extremidade e selecione Confirmar seleção.

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

    6. Agora, na página Criar assinatura de evento, selecione Criar.

      Captura de tela mostrando a página Criar Assinatura de Evento com configurações de exemplo.

Conteúdo relacionado

Para obter mais informações, consulte os seguintes artigos sobre o recurso Eventos do Parceiro: