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 "00001111-aaaa-2222-bbbb-3333cccc4444" -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: forneça uma nome a apresentar válida voltada para o utente.
- Tipos de conta suportados: escolha a opção Contas apenas neste diretório organizacional, porque o aplicativo não autenticará contas de utente fora desse locatário.
- Nenhum URI de redirecionamento é esperado neste caso.
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.
Informações relacionadas
Visão geral
do Serviço de Crédito Ambiental (pré-visualização) Glossário
do Serviço de Crédito Ambiental (pré-visualização) Visão geral da referência da API para o Serviço de Crédito Ambiental (pré-visualização)
