Compartilhar via

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

  • Artigo

Consulte Autenticar de um aplicativo para obter uma visão geral da obtenção de um token de Microsoft Entra.

Este artigo fornece um exemplo de como obter um token Microsoft Entra que você pode usar para enviar eventos e receber eventos de um namespace dos Hubs de Eventos. Ele usa a ferramenta Postman para fins de teste.

Pré-requisitos

Registrar seu aplicativo com Microsoft Entra ID

A primeira etapa é registrar seu aplicativo com o locatário Microsoft Entra e anotar os valores da ID do locatário, da ID do cliente e do segredo do cliente. Você usa esses valores mais recentes ao testar a API REST usando a ferramenta Postman.

  1. Entre no portal do Azure.

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

  3. Na página Microsoft Entra ID, selecione o link Registros de Aplicativo no menu à esquerda e selecione + Novo registro na barra de ferramentas.

    Captura de tela mostrando a página Registros de Aplicativo com Novo link de registro selecionado.

  4. Insira um nome para o aplicativo e selecione Registrar.

    Captura de tela mostrando a página Registrar aplicativo.

  5. Na home page do aplicativo, anote os valores da ID do aplicativo (cliente) e da ID do diretório (locatário). Você usa esses valores para obter um token de Microsoft Entra ID.

    Captura de tela mostrando a home page com a ID do cliente e a ID do locatário realçadas.

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

    Captura de tela mostrando a página Certificados & Segredos.

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

    Captura de tela mostrando a descrição, a hora de expiração e o botão Adicionar.

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

    Captura de tela mostrando o botão de segredo do cliente.

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

Neste exemplo, estamos enviando apenas mensagens para o hub de eventos, portanto, adicione o aplicativo à função Hubs de Eventos do Azure Remetente de Dados.

  1. Na página Namespace dos Hubs de Eventos , selecione Controle de acesso no menu à esquerda e, em seguida, selecione Adicionar no bloco Adicionar uma atribuição de função .

    Captura de tela mostrando a página Controle 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 seu aplicativo (neste exemplo, ServiceBusRestClientApp) para a entidade de serviço.

    Captura de tela mostrando a adição do aplicativo à função Hubs de Eventos do Azure Remetente de Dados.

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

Usar o Postman para obter o token Microsoft Entra

  1. Inicie o Postman.

  2. Para o método , selecione GET.

  3. Para o URI, insira https://login.microsoftonline.com/<TENANT ID>/oauth2/token. Substitua <TENANT ID> pelo valor da ID do locatário copiado anteriormente.

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

    Captura de tela mostrando o cabeçalho do tipo conteúdo.

  5. Alterne para a guia Corpo e adicione as seguintes chaves e valores.

    1. Selecione form-data.

    2. Adicione grant_type chave e digite client_credentials para o valor.

    3. Adicione client_id a chave e cole o valor da ID do cliente anotada anteriormente.

    4. Adicione client_secret chave e cole o valor do segredo do cliente anotado anteriormente.

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

      Captura de tela mostrando o corpo da solicitação.

  6. Selecione Enviar para enviar a solicitação para obter o token. Você vê o token no resultado. Salve o token (excluindo aspas duplas). Você a usará mais tarde.

    Captura de tela mostrando o token de acesso de Microsoft Entra.

Enviar um evento para o hub de eventos

  1. No Postman, abra uma nova guia.

  2. Selecione POST para o método .

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

  4. Na guia Cabeçalhos , adicione os dois cabeçalhos a seguir.

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

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

      Captura de tela da guia Cabeçalhos enfatizada no hub de eventos.

  5. Na guia Corpo , selecione bruto para o tipo de dados e insira This is a message ou qualquer mensagem para o corpo.

    Captura de tela do evento de teste no modo de exibição Corpo bruto no hub de eventos.

  6. Selecione Enviar para enviar a mensagem para a fila. Você vê o status como Created com o código 201, conforme mostrado na imagem a seguir.

    Captura de tela mostrando o status bem-sucedido.

  7. Na página do namespace no portal do Azure, você pode ver que as mensagens são postadas na fila.

    Captura de tela mostrando as mensagens postadas na fila.

Consulte Também

Veja os artigos a seguir: