Partilhar via

Obter um token de Microsoft Entra e utilizá-lo para enviar eventos para um hub de eventos

  • Artigo

Veja Autenticar a partir de uma aplicação para obter uma descrição geral da obtenção de um token de Microsoft Entra.

Este artigo dá-lhe um exemplo de como obter um token de Microsoft Entra que pode utilizar para enviar eventos e receber eventos a partir de um espaço de nomes dos Hubs de Eventos. Utiliza a ferramenta Postman para fins de teste.

Pré-requisitos

Registar a sua aplicação no Microsoft Entra ID

O primeiro passo é registar a sua aplicação no inquilino Microsoft Entra e anotar os valores do ID do inquilino, do ID do cliente e do segredo do cliente. Utilize estes valores mais recentemente ao testar a API REST com a ferramenta Postman.

  1. Inicie sessão no portal do Azure.

  2. Na barra de pesquisa, procure Microsoft Entra ID e selecione-a na lista pendente.

  3. Na página Microsoft Entra ID, selecione a ligação Registos de Aplicações no menu esquerdo e, em seguida, selecione + Novo registo na barra de ferramentas.

    Captura de ecrã a mostrar a página Registos de Aplicações com a ligação Novo registo selecionada.

  4. Introduza um nome para a aplicação e selecione Registar.

    Captura de ecrã a mostrar a página Registar aplicação.

  5. Na home page da aplicação, anote os valores de ID de Aplicação (cliente) e ID do Diretório (inquilino). Utiliza estes valores para obter um token de Microsoft Entra ID.

    Captura de ecrã a mostrar a home page com o ID do cliente e o ID do inquilino realçados.

  6. Agora, selecione Certificados & segredos no menu esquerdo e selecione + Novo segredo do cliente.

    Captura de ecrã a mostrar a página Certificados & Segredos.

  7. Introduza uma descrição, selecione quando o segredo irá expirar e selecione Adicionar.

    Captura de ecrã a mostrar a descrição, a hora de expiração e o botão Adicionar.

  8. Selecione o botão copiar junto ao valor do segredo na lista Segredos do cliente para copiar o valor para a área de transferência. Cole-o em algum lugar. Irá utilizá-lo mais tarde para obter um token do Microsoft Entra ID.

    Captura de ecrã a mostrar o botão do segredo do cliente.

Adicionar aplicação à função de Remetente de Dados dos Hubs de Eventos

Neste exemplo, estamos apenas a enviar mensagens para o hub de eventos, por isso, adicione a aplicação à função Hubs de Eventos do Azure Remetente de Dados.

  1. Na página Espaço de Nomes dos Hubs de Eventos , selecione Controlo de acesso no menu esquerdo e, em seguida, selecione Adicionar no mosaico Adicionar uma atribuição de função .

    Captura de ecrã a mostrar a página Controlo de Acesso.

  2. Na página Adicionar atribuição de função, selecione Hubs de Eventos do Azure Remetente de Dados para Função e selecione a sua aplicação (neste exemplo, ServiceBusRestClientApp) para o principal de serviço.

    Captura de ecrã a mostrar a adição da aplicação à função de Remetente de Dados Hubs de Eventos do Azure.

  3. Selecione Guardar na página Adicionar atribuição de função para guardar a atribuição de função.

Utilizar o Postman para obter o token de Microsoft Entra

  1. Inicie o Postman.

  2. Para o método, selecione GET.

  3. Para o URI, introduza https://login.microsoftonline.com/<TENANT ID>/oauth2/token. Substitua <TENANT ID> pelo valor de ID do inquilino que copiou anteriormente.

  4. No separador Cabeçalhos , adicione a chave Tipo de Conteúdo e application/x-www-form-urlencoded o valor.

    Captura de ecrã a mostrar o cabeçalho do tipo de conteúdo.

  5. Mude para o separador Corpo e adicione as seguintes chaves e valores.

    1. Selecione form-data.

    2. Adicione grant_type a chave e escreva client_credentials para o valor.

    3. Adicione client_id a chave e cole o valor do ID de cliente que anotou anteriormente.

    4. Adicione client_secret a chave e cole o valor do segredo do cliente que anotou anteriormente.

    5. Adicione resource a chave e escreva https://eventhubs.azure.net para o valor.

      Captura de ecrã a mostrar o corpo do pedido.

  6. Selecione Enviar para enviar o pedido para obter o token. Verá o token no resultado. Guarde o token (excluindo aspas duplas). Vai utilizá-lo mais tarde.

    Captura de ecrã a mostrar o token de acesso do Microsoft Entra.

Enviar um evento para o hub de eventos

  1. No Postman, abra um novo separador.

  2. Selecione POST para o método .

  3. Introduza URI no seguinte formato: https://<EVENT HUBS NAMESPACE NAME>.servicebus.windows.net/<QUEUE NAME>/messages. Substitua <EVENT HUBS NAMESPACE NAME> pelo nome do espaço de nomes dos Hubs de Eventos. Substitua <QUEUE NAME> pelo nome da fila.

  4. No separador Cabeçalhos , adicione os dois cabeçalhos seguintes.

    1. Adicione Authorization a chave e o valor para a mesma no seguinte formato: Bearer <TOKEN from Microsoft Entra ID>. Quando copiar/colar o token, não copie as aspas duplas entre aspas.

    2. Adicione Content-Type a chave e application/atom+xml;type=entry;charset=utf-8 como o valor para a mesma.

      Captura de ecrã do separador Cabeçalhos realçado no hub de eventos.

  5. No separador Corpo , selecione raw para o tipo de dados e introduza This is a message ou qualquer mensagem para o corpo.

    Captura de ecrã do evento de teste na vista Corpo não processado no hub de eventos.

  6. Selecione Enviar para enviar a mensagem para a fila. Verá o estado como Created com o código 201, conforme mostrado na imagem seguinte.

    Captura de ecrã a mostrar o estado com êxito.

  7. Na página espaço de nomes no portal do Azure, pode ver que as mensagens são publicadas na fila.

    Captura de ecrã a mostrar as mensagens publicadas na fila.

Consulte também

Consulte os seguintes artigos: