Obter um token do Azure Active Directory (Azure AD) e utilizá-lo para enviar mensagens para uma fila do Service Bus

Veja Autenticar a partir de uma aplicação para obter uma descrição geral da obtenção de um token do Azure Active Directory (Azure AD).

Este artigo dá-lhe um exemplo de como obter um token de Azure AD que pode utilizar para enviar mensagens para um espaço de nomes do Service Bus. Utiliza a ferramenta Postman para fins de teste.

Pré-requisitos

• Siga as instruções do Início Rápido: utilize portal do Azure para criar uma fila do Service Bus para criar um espaço de nomes do Service Bus e uma fila no espaço de nomes.
• Transfira e instale a aplicação de ambiente de trabalho do Postman .

Registar a sua aplicação com Azure AD

O primeiro passo é registar a sua aplicação com o inquilino Azure AD e anotar os valores do ID do inquilino, do ID do cliente e do segredo do cliente. Irá utilizar 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 Azure Active Directory e selecione-o na lista pendente.

   

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

   

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

   

5. Na home page da aplicação, anote os valores de ID de Aplicação (cliente) e ID do Diretório (inquilino). Irá utilizar estes valores para obter um token de Azure AD.

   

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

   

7. Introduza uma descrição, selecione quando o segredo irá expirar e selecione 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 Azure AD.

   

Adicionar aplicação à função de Remetente de Dados do Service Bus

Neste exemplo, estamos apenas a enviar mensagens para a fila do Service Bus, por isso, adicione a aplicação à função Remetente de Dados do Service Bus .

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

   

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

   

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

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.

   

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://servicebus.azure.net para o valor.

      

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

   

Enviar mensagens para uma fila

1. No Postman, abra um novo separador.

2. Selecione POST para o método .

3. Introduza URI no seguinte formato: https://<SERVICE BUS NAMESPACE NAME>.servicebus.windows.net/<QUEUE NAME>/messages. Substitua <SERVICE BUS NAMESPACE NAME> pelo nome do espaço de nomes do Service Bus. 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 Azure AD>. 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.

      

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

   

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.

   

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

   

   Também pode utilizar o Service Bus Explorer (pré-visualização) na página Fila do Service Bus , conforme mostrado na imagem seguinte para receber ou pré-visualizar mensagens.

   

Consulte também

Consulte os seguintes artigos:

• Autenticar a partir de uma aplicação
• Plataforma de identidades da Microsoft e fluxo de código de autorização OAuth 2.0