Configurar a coleção Postman para o Serviço de Créditos Ambientais (pré-visualização)
Importante
Algumas ou todas estas funcionalidades estão disponíveis como parte de uma versão de pré-visualização. O conteúdo e a funcionalidade estão sujeitos a alterações. Pode aceder ao ambiente de sandbox do Serviço de Créditos Ambientais (pré-visualização) para obter uma versão de avaliação de 30 dias. Para usar o Serviço de Créditos Ambientais (pré-visualização) num ambiente de produção, preencha o formulário de subscrição Serviço de Créditos Ambientais (pré-visualização).
Pode copiar a coleção do Postman e alterar os parâmetros conforme necessário.
Integrar Serviço de Créditos Ambientais (pré-visualização) como uma aplicação proprietária no seu inquilino do ID do Microsoft Entra
Para autenticar com o Serviço de Créditos Ambientais (pré-visualização), os utilizadores do seu diretório têm de apresentar um token de autenticação, particularmente um token Web JSON, com algumas afirmações necessárias. Estas afirmações irão ajudar o Serviço de Créditos Ambientais (pré-visualização) a identificar o acesso fornecido a um utilizador.
Nota
Como o Serviço de Créditos Ambientais (pré-visualização) é uma aplicação proprietária da Microsoft, não poderá eliminá-lo do seu inquilino depois de o implementar.
Verifique se tem acesso para implementar o Serviço de Créditos Ambientais (pré-visualização) no seu inquilino.
Navegue até ao Portal do Azure > ID do Microsoft Entra > Definições de utilizador e verifique a propriedade Os utilizadores podem registar aplicações. Se estiver definido como Não, contacte um dos administradores do inquilino do ID do Microsoft Entra para configurar o Serviço de Créditos Ambientais (pré-visualização) no inquilino.
Também poderá precisar desta permissão para registar qualquer cliente ou aplicações Web no inquilino, com base no cenário aplicável à sua equipa.
Siga os passos no Módulo Ligar ao PowerShell para Graph do ID do Microsoft Entra. Estes passos irão configurar o módulo do PowerShell do ID do Microsoft Entra e ligar ao inquilino do ID do Microsoft Entra através de uma identidade que tenha as permissões especificadas no primeiro passo.
Para implementar o Serviço de Créditos Ambientais (pré-visualização) no inquilino, utilize este comando PowerShell, especificando o módulo PowerShell do ID do Microsoft Entra:
New-AzureADServicePrincipal -AppId "b9b0ac19-f710-429d-b58e-dc3f73a330a9" -DisplayName "Environmental Credit Service"Depois de implementado o Serviço de Créditos Ambientais (pré-visualização) no inquilino, navegue para o Portal do Azure > ID do Microsoft Entra > Aplicações Empresariais > Escolher Aplicações Microsoft para o tipo Aplicação (e Aplicar). Procure o Serviço de Créditos Ambientais (pré-visualização) para visualizar a aplicação empresarial implementada.
Configurar a coleção do Postman
Para configurar a coleção do Postman para o Serviço de Créditos Ambientais (pré-visualização), siga este passo único para cada inquilino do ID do Microsoft Entra que utilize que interaja com o Serviço de Créditos Ambientais (pré-visualização):
Registe uma aplicação de cliente público no inquilino ao navegar para o Portal do Azure > ID do Microsoft Entra > Registos de aplicações > Novo registo. Introduza os seguintes valores:
- Nome: atribua um nome a apresentar destinado aos utilizadores.
- Tipos de conta suportados: escolha a opção Contas apenas neste diretório organizacional, porque a aplicação não irá autenticar as contas de utilizador fora deste inquilino.
- Neste caso, é esperado Sem URI de redirecionamento.
Selecione Autenticação. Em Definições avançadas, defina Tratar aplicação como um cliente público como Sim. Guardar as suas alterações. As aplicações cliente públicas permitem aos utilizadores fazer a autenticação utilizando fluxos de trabalho móveis ou de ambiente de trabalho, e recolher palavra-passe de texto simples utilizando um fluxo de trabalho de credenciais de palavra-passe do proprietário do recurso.
Selecione a secção Manifesto. No editor JSON, procure a propriedade accessTokenAcceptedVersion e defina o respetivo valor como 2. Selecione Guardar para aplicar as alterações.
Neste cenário, o cliente público tenta utilizar o token do utilizador com sessão iniciada para aceder às APIs do Serviço de Créditos Ambientais (pré-visualização). A aplicação tem de pedir a permissão delegada Application.ReadWrite conforme exposta pela aplicação empresarial Serviço de Créditos Ambientais (pré-visualização) registada na secção de pré-requisitos:
- Navegue para a aplicação registada, selecione Permissões da API e selecione Adicionar uma permissão.
- Selecione o separador APIs que a minha organização utiliza e procure a aplicação empresarial Serviço de Créditos Ambientais (pré-visualização) que foi implementada no inquilino durante os passos do pré-requisito.
- Selecione Permissões delegadas. As permissões delegadas requerem o consentimento do utilizador pontual para indicar que a aplicação pode utilizar o respectivo token para aceder ao recurso necessário. Como este cenário envolve o fluxo de trabalho não interativo, o consentimento tem de ser concedido antecipadamente pelo administrador do inquilino para as permissões delegadas necessárias.
Depois de configuradas as permissões delegadas, pode pedir o token de acesso de forma não interativa através dos detalhes fornecidos no Pedido de autorização.
O valor da propriedade de âmbito no pedido do token de acesso tem de ser igual ao âmbito Application.ReadWrite: https://ecs.mcfs.microsoft.com/Application.ReadWrite. A chamada para o ponto final do token pode ser iniciada antes de chegar a qualquer API de Serviço de Créditos Ambientais (pré-visualização).
Quando a autenticação estiver a funcionar, atualize as seguintes variáveis da coleção do Postman:
Defina as variáveis de ID de cliente para a propriedade ID da aplicação das aplicações cliente públicas registadas nos respetivos inquilinos do ID do Microsoft Entra, como descrito nos passos anteriores.
Atualize o nome de utilizador (e-mail) e a palavra-passe conforme necessário para as variáveis disponíveis na coleção Postman.
Consultar também
Descrição geral do Serviço de Créditos Ambientais (pré-visualização)
Glossário do Serviço de Créditos Ambientais (pré-visualização)
Descrição geral de referência da API para o Serviço de Créditos Ambientais (pré-visualização)
