Configurar a coleção Postman para o Serviço de Crédito Ambiental (versão preliminar)
Importante
Algumas ou todas estas funcionalidades estão disponíveis como parte de uma versão preliminar. O conteúdo e a funcionalidade estão sujeitos a alterações. Você pode acessar o ambiente de área restrita do Serviço de Crédito Ambiental (versão preliminar) para fazer uma avaliação de 30 dias. Para usar o Serviço de Crédito Ambiental (versão preliminar) em um ambiente de produção, preencha o Formulário de inscrição do Serviço de Crédito Ambiental (versão preliminar).
Você pode copiar a coleção Postman e alterar os parâmetros, conforme necessário.
Integrar ao Serviço de Crédito Ambiental (versão preliminar) como um aplicativo primário em seu locatário do Microsoft Entra ID
Para autenticar com o Serviço de Crédito Ambiental (versão preliminar), os usuários de seu diretório devem apresentar um token de autenticação, particularmente um token Web JSON, com algumas declarações necessárias. Essas declarações ajudarão o Serviço de Crédito Ambiental (versão preliminar) a identificar o acesso fornecido a um usuário.
Observação
Como o Serviço de Crédito Ambiental (versão preliminar) é um aplicativo de terceiros da Microsoft, você não poderá excluí-lo de seu locatário depois que implantá-lo.
Verifique se você tem acesso para implantar Serviço de Crédito Ambiental (versão preliminar) em seu locatário.
Navegue até Portal do Azure > Microsoft Entra ID > Configurações do usuário e verifique a propriedade Os usuários podem registrar aplicativos. Se ela estiver definida como Não, contate um dos administradores de locatário do Microsoft Entra ID para configurar o Serviço de Crédito Ambiental (versão preliminar) de seu locatário.
Você também pode precisar dessa permissão para registrar qualquer cliente ou aplicativo Web em seu locatário, com base no cenário aplicável para sua equipe.
Siga as etapas em Conectar com o módulo PowerShell for Graph do Microsoft Entra ID. Essas etapas configurarão o módulo do PowerShell do Microsoft Entra ID e se conectarão ao seu locatário do Microsoft Entra ID usando uma identidade que tenha as permissões especificadas na primeira etapa.
Para implantar o Serviço de Crédito Ambiental (versão preliminar) em seu locatário, use este comando do PowerShell, especificando seu módulo do PowerShell do Microsoft Entra ID:
New-AzureADServicePrincipal -AppId "00001111-aaaa-2222-bbbb-3333cccc4444" -DisplayName "Environmental Credit Service"Depois que o Serviço de Crédito Ambiental (versão preliminar) for implantado em seu locatário, navegue até Portal do Azure > Microsoft Entra ID > Aplicativos Empresariais > Escolher Aplicativos Microsoft para o tipo de Aplicativo (e Aplicar). Pesquise por Serviço de Crédito Ambiental (versão preliminar) para visualizar o aplicativo empresarial implantado.
Configurar a coleção Postman
Para configurar a coleção Postman para o Serviço de Crédito Ambiental (versão preliminar), siga esta etapa única para cada locatário do Microsoft Entra ID que você usa que interagiria com o Serviço de Crédito Ambiental (versão preliminar):
Registre um aplicativo de cliente público no locatário navegando até Portal do Azure > Microsoft Entra ID > Registros de aplicativos > Novo registro. Insira os seguintes valores:
- Nome: Forneça um nome de exibição válido para o usuário.
- Tipos de conta suportados: Escolha a opção Contas somente neste diretório organizacional, porque o aplicativo não autenticará contas de usuários fora deste locatário.
- Nenhum URI de redirecionamento é esperado neste caso.
Selecione Autenticação. Em Configurações avançadas, defina Tratar aplicativo como um cliente público como Sim. Salve suas alterações. Os aplicativos clientes públicos permitem que os usuários se autentiquem usando fluxos de trabalho móveis ou de desktop e coletem senhas de texto sem formatação usando um fluxo de trabalho de credencial de senha do proprietário do recurso.
Selecione a seção Manifesto. No editor JSON, procure a propriedade accessTokenAcceptedVersion e defina seu valor como 2. Selecione Salvar para aplicar as alterações.
Nesse cenário, o cliente público tenta usar o token do usuário conectado para acessar as APIs do Serviço de Crédito Ambiental (versão preliminar). O aplicativo deve solicitar a permissão delegada Application.ReadWrite conforme exposto pelo aplicativo empresarial Serviço de Crédito Ambiental (versão preliminar) registrado na seção de pré-requisito:
- Navegue até o aplicativo registrado, selecione Permissões de API e escolha Adicionar uma permissão.
- Selecione a guia APIs que minha organização usa e procure o aplicativo empresarial Serviço de Crédito Ambiental (versão preliminar) que foi implantado no locatário durante as etapas de pré-requisito.
- Selecione Permissões delegadas. As permissões delegadas exigem consentimento único do usuário para indicar que o aplicativo pode usar seu token para acessar o recurso necessário. Como esse cenário envolve um fluxo de trabalho não interativo, o consentimento precisa ser concedido antecipadamente pelo administrador do locatário para as permissões delegadas necessárias.
Após a configuração das permissões delegadas, você pode solicitar o token de acesso de forma não interativa usando os detalhes fornecidos na Solicitação de autorização.
O valor da propriedade do escopo na solicitação de token de acesso deve ser igual ao escopo Application.ReadWrite: https://ecs.mcfs.microsoft.com/Application.ReadWrite. A chamada para o ponto de extremidade de token pode ser iniciada antes de atingir qualquer API do Serviço de Crédito Ambiental (versão preliminar).
Depois que a autenticação estiver funcionando, atualize as seguintes variáveis de coleção do Postman:
Defina as variáveis de ID do cliente para a propriedade ID do aplicativo dos aplicativos clientes públicos registrados nos respectivos locatários do Microsoft Entra ID, conforme descrito nas etapas anteriores.
Atualize o nome de usuário (email) e a senha, 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 (versão preliminar)
Glossário do Serviço de Crédito Ambiental (versão preliminar)
Visão geral da referência da API para o Serviço de Crédito Ambiental (versão preliminar)
