Impostare la raccolta Postman per Servizio di credito ambientale (anteprima)

Puoi copiare la raccolta Postman e modificare i parametri se necessario.

Eseguire l'onboarding di Servizio di credito ambientale (anteprima) come applicazione proprietaria nel tenant di Microsoft Entra ID

Per eseguire l'autenticazione con Servizio di credito ambientale (anteprima), gli utenti della tua directory devono presentare un token di autenticazione, in particolare un token Web JSON, con alcune attestazioni obbligatorie. Queste attestazioni aiuteranno Servizio di credito ambientale (anteprima) a identificare l'accesso fornito a un utente.

1. Verifica di disporre dell'accesso per distribuire Servizio di credito ambientale (anteprima) nel tenant.

   Passa a Portale di Azure > Microsoft Entra ID > Impostazioni utente e verifica la proprietà Gli utenti possono registrare le applicazioni. Se è impostata su No, contatta uno degli amministratori del tenant di Microsoft Entra ID per configurare Servizio di credito ambientale (anteprima) nel tuo tenant.

2. Potresti anche aver bisogno di questa autorizzazione per registrare qualsiasi client o app Web nel tuo tenant, in base allo scenario applicabile per il tuo team.

3. Segui i passaggi in Connettersi al modulo PowerShell for Graph di Microsoft Entra ID. Questi passaggi configureranno il modulo PowerShell di Microsoft Entra ID ed eseguiranno la connessione al tuo tenant di Microsoft Entra ID utilizzando un'identità che dispone delle autorizzazioni specificate nel primo passaggio.

4. Per distribuire Servizio di credito ambientale (anteprima) nel tuo tenant, usa questo comando PowerShell, specificando il tuo modulo PowerShell di Microsoft Entra ID:

      New-AzureADServicePrincipal -AppId "00001111-aaaa-2222-bbbb-3333cccc4444" -DisplayName "Environmental Credit Service"
   

5. Dopo che Servizio di credito ambientale (anteprima) è stato distribuito nel tuo tenant, vai a Portale di Azure > Microsoft Entra ID > Applicazioni aziendali > Scegli applicazioni Microsoft per il tipo di applicazione (e applica). Cerca Servizio di credito ambientale (anteprima) per visualizzare l'app aziendale distribuita.

Configurare la raccolta Postman

Per impostare la raccolta Postman per Servizio di credito ambientale (anteprima), segui questo passaggio una tantum per ogni tenant di Microsoft Entra ID che utilizzi che interagirebbe con Servizio di credito ambientale (anteprima):

1. Registra un'applicazione client pubblica nel tenant accedendo a Portale di Azure > Microsoft Entra ID > Registrazioni app > Nuova registrazione. Immettere i valori seguenti:

   • Nome: Inserisci un nome visualizzato valido per l'utente.
   • Tipi di account supportati: seleziona l'opzione Solo account in questa directory organizzativa, perché l'app non autenticherà gli account utente al di fuori di questo tenant.
   • In questo caso non è previsto alcun URI di reindirizzamento.

2. Seleziona Autenticazione. In Impostazioni avanzate, imposta Gestire l'applicazione come client pubblico su Sì. Salva le modifiche. Le applicazioni client pubbliche consentono agli utenti di autenticarsi utilizzando flussi di lavoro mobili o desktop e raccogliere password in testo semplice utilizzando un flusso di lavoro delle credenziali della password del proprietario della risorsa.

3. Seleziona la sezione Manifesto. Nell'editor JSON, cerca la proprietà accessTokenAcceptedVersion e impostane il valore su 2. Seleziona Salva per applicare le modifiche.

4. In questo scenario, il client pubblico tenta di utilizzare il token dell'utente connesso per accedere alle API di Servizio di credito ambientale (anteprima). L'applicazione deve richiedere l'autorizzazione delegata Application.ReadWrite come esposto dall'app aziendale Servizio di credito ambientale (anteprima) registrata nella sezione dei prerequisiti:

   1. Passa all'applicazione registrata, seleziona Autorizzazioni API, quindi seleziona Aggiungi un'autorizzazione.
   2. Seleziona la scheda API utilizzate dalla mia organizzazione e cerca l'app aziendale Servizio di credito ambientale (anteprima) che è stata distribuita nel tenant durante i passaggi preliminari.
   3. Seleziona Autorizzazioni delegate. Le autorizzazioni delegate richiedono il consenso dell'utente una tantum per indicare che l'applicazione può usare il proprio token per accedere alla risorsa richiesta. Poiché questo scenario prevede un flusso di lavoro non interattivo, il consenso deve essere concesso in anticipo dal tenant amministratore per le autorizzazioni delegate richieste.

Dopo aver impostato le autorizzazioni delegate, puoi richiedere il token di accesso in modo non interattivo utilizzando i dettagli forniti in Richiesta di autorizzazione.

Il valore per la proprietà dell'ambito nella richiesta del token di accesso deve essere uguale all'ambito Application.ReadWrite: https://ecs.mcfs.microsoft.com/Application.ReadWrite. La chiamata per l'endpoint del token può essere avviata prima di accedere a qualsiasi API di Servizio di credito ambientale (anteprima).

Una volta che l'autenticazione funziona, aggiorna le seguenti variabili della raccolta Postman:

1. Imposta le variabili ID client sulla proprietà ID applicazione delle applicazioni client pubbliche registrate nei rispettivi tenant di Microsoft Entra ID, come descritto nei passaggi precedenti.

2. Aggiorna il nome utente (e-mail) e la password secondo necessità per le variabili disponibili nella raccolta Postman.

Informazioni correlate

Panoramica del servizio di credito ambientale (anteprima)
Glossario del servizio di credito ambientale (anteprima)
Panoramica di riferimento API per il servizio di credito ambientale (anteprima)