Compartilhar via

Obter um token do Azure Active Directory (Azure AD) e usá-lo para enviar mensagens para uma fila do Barramento de Serviço

  • Artigo

Consulte Autenticar de um aplicativo para obter uma visão geral da obtenção de um token do Azure Active Directory (Azure AD).

Este artigo fornece um exemplo de como obter um token de Azure AD que você pode usar para enviar mensagens para um namespace do Barramento de Serviço. Ele usa a ferramenta Postman para fins de teste.

Pré-requisitos

Registrar o aplicativo no Azure AD

A primeira etapa é registrar o aplicativo com o locatário do Azure AD e anotar os valores de ID do locatário, ID do cliente e segredo do cliente. Você usará 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 Azure Active Directory e selecione-o na lista suspensa.

    Pesquise o Azure Active Directory e selecione-o

  3. Na página Azure Active Directory , selecione o link Registros de Aplicativo no menu à esquerda e, em seguida, selecione + Novo registro na barra de ferramentas.

    Alterne para a página Registros de aplicativo e selecione Novo registro

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

    Insira um nome e selecione Registrar

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

    Anote a ID do cliente e a ID do locatário

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

    Alterne para a página Certificados & Segredos e selecione Novo segredo do cliente

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

    Insira descrição, selecione hora de expiração e selecione 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. Você o usará mais tarde para obter um token de Azure AD.

    Copiar segredo do cliente

Adicionar aplicativo à função remetente de dados do Barramento de Serviço

Neste exemplo, estamos apenas enviando mensagens para a fila do Barramento de Serviço, portanto, adicione o aplicativo à função Remetente de Dados do Barramento de Serviço .

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

    Controle de acesso –> Adicionar uma atribuição de função

  2. Na página Adicionar atribuição de função, selecione Barramento de Serviço do Azure Remetente de Dados para Função e selecione seu aplicativo (neste exemplo, ServiceBusRestClientApp) para a entidade de serviço.

    Adicionar aplicativo à função remetente de dados do Barramento de Serviço do Azure

  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 de Azure AD

  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 .

    Adicionar cabeçalho de tipo de conteúdo

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

    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 a chave e cole o valor do segredo do cliente anotado anteriormente.

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

      Definir corpo para a solicitação

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

    Token de acesso do Azure AD

Enviar mensagens a uma fila

  1. No Postman, abra uma nova guia.

  2. Selecione POST para o método .

  3. Insira URI no seguinte formato: https://<SERVICE BUS NAMESPACE NAME>.servicebus.windows.net/<QUEUE NAME>/messages. Substitua <SERVICE BUS NAMESPACE NAME> pelo nome do namespace do Barramento de Serviço. 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 a ela no seguinte formato: Bearer <TOKEN from Azure AD>. Ao 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 do Tipo de Traço de Autorização e Conteúdo selecionado como Cabeçalhos na fila do Barramento de Serviço.

  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 da mensagem de teste na exibição Corpo bruto da fila do Barramento de Serviço.

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

    Êxito status

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

    As mensagens são postadas na fila

    Você também pode usar a Explorer do Barramento de Serviço (versão prévia) na página Fila do Barramento de Serviço, conforme mostrado na imagem a seguir para receber ou espiar mensagens.

    Receber mensagens usando o barramento de serviço Explorer

Consulte Também

Veja os artigos a seguir: