Konfigurera Postman-insamlingen för tjänsten Miljökrediter (förhandsversion)
Microsoft Cloud for Sustainability - Kostnadsfri utvärderingsversion
Viktigt
Några eller alla dessa funktioner ingår som en del av en förhandsversion. Innehållet och funktionerna kan komma att ändras. Du kan få åtkomst till Begränsat läge för tjänsten Miljökrediter (förhandsversion) i en 30-dagars utvärderingsversion. Om du vill använda tjänsten Miljökrediter (förhandsversion) i en produktionsmiljö slutför du registreringsformuläret för tjänsten Miljökrediter (förhandsversion).
Du kan kopiera Postman-samlingen och ändra parametrarna efter behov.
Registrera tjänsten Miljökrediter (förhandsversion) som ett förstapartsprogram i din Microsoft Entra ID-klientorganisation
För autentisering med tjänsten Miljökrediter (förhandsversion) måste användare i katalogen visa en autentiseringstoken, särskilt en JSON-webbtoken, med vissa obligatoriska anspråk. Dessa krav hjälper tjänsten Miljökrediter (förhandsversion) att identifiera åtkomsten som beviljats till en användare.
Anteckning
Eftersom tjänsten Miljökrediter (förhandsversion) är ett program från en första part från Microsoft kan du inte ta bort den från klientorganisationen när du har distribuerat den.
Kontrollera att du har åtkomst till att distribuera tjänsten Miljökrediter (förhandsversion) i klientorganisationen.
Navigera till Azure Portal > Microsoft Entra ID > Användarinställningar och leta efter egenskapen Användare kan registrera program. Om denna har angetts till Nej kontaktar du någon av Microsoft Entra ID-klientorganisationens administratörer för att konfigurera tjänsten Miljökrediter (förhandsversion) i din klientorganisation.
Du kan också behöva den här behörigheten för att registrera klient- eller webbappar i din klientorganisation, baserat på vilket scenario som gäller för ditt team.
Följ stegen i Anslut till Microsoft Entra ID PowerShell for Graph-modulen. Dessa steg kommer att konfigurera Microsoft Entra ID PowerShell-modulen och ansluta till din Microsoft Entra ID-klientorganisation som använder en identitet med de behörigheter som anges i det första steget.
Om du vill distribuera tjänsten Miljökrediter (förhandsversion) i klientorganisationen använder du detta PowerShell-kommando och anger din Microsoft Entra ID PowerShell-modul:
New-AzureADServicePrincipal -AppId "b9b0ac19-f710-429d-b58e-dc3f73a330a9" -DisplayName "Environmental Credit Service"När tjänsten Miljökrediter (förhandsversion) har distribuerats i din klientorganisation går du till Azure-portalen > Microsoft Entra ID > Företagsprogram > Välj Microsoft-program för programtyp (och Verkställ). Sök efter tjänsten Miljökrediter (förhandsversion) och visualisera det distribuerade företagsprogrammet.
Konfigurera Postman-samlingen
För att konfigurera Postman-ansamlingen för tjänsten Miljökrediter (förhandsversion), följ detta engångssteg för varje Microsoft Entra ID-klientorganisation som du använder och som interagerar med tjänsten Miljökrediter (förhandsversion):
Registrera ett offentligt klientprogram i klientorganisationen genom att navigera till Azure Portal > Microsoft Entra ID > Appregistreringar > Ny registrering. Ange följande värden:
- Namn: Ange en giltig användarriktad visningsnamn.
- Kontotyper som stöds: Välj alternativet endast konton i organisationskatalogen eftersom appen inte autentiserar användarkonton utanför den här klientorganisationen.
- Ingen omdirigerings-URI förväntas i detta fall.
Välj Autentisering. I Avancerade inställningar anger du Behandla programmet som en offentlig klient till Ja. Spara dina ändringar. Med offentliga klientprogram kan användare autentisera med hjälp av arbetsflöden för mobila och datorflöden och samla in lösenord för oformaterad text med hjälp av ett inloggningsarbetsflöde med resursägare.
Välj avsnittet Manifest. Sök efter egenskapen i JSON-redigeraren accessTokenAcceptedVersion och ange värdet till 2. Välj Spara för att införa ändringarna.
I det här scenariot försöker den offentliga klienten använda den inloggade användarens token för att komma åt tjänsten Miljökrediters (förhandsversion) API:er. Programmet måste begära att få den delegerade behörigheten Application.ReadWrite som visas av företagsappen, tjänsten Miljökrediter (förhandsversion) i avsnittet Förutsättningar:
- Navigera till det registrerade programmet, välj API-behörigheter och välj sedan Lägg till en behörighet.
- Välj fliken API:er som min organisation använder och sök efter företagsprogrammet, tjänsten Miljökrediter (förhandsversion) som distribuerades i klientorganisationen under villkorsstegen.
- Välj delegerade behörigheter. Delegerade behörigheter kräver att användaren en gång godkänner att ange att programmet kan använda sina tokens för att få åtkomst till den begärda resursen. Eftersom det här scenariot omfattar ett icke-interaktivt arbetsflöde måste medgivandet ges i förväg av klientorganisationen för administratör för de delegerade behörigheter som krävs.
När de delegerade behörigheterna har ställts in kan du begära åtkomsttoken icke-interaktiv med hjälp av informationen i auktoriseringsbegäran.
Värdet för omfattningsegenskapen i åtkomsttoken-begäran måste vara lika med Application.ReadWrite omfattning: https://ecs.mcfs.microsoft.com/Application.ReadWrite. Anropet för tokenslutpunkt kan startas innan du trycker på något API för tjänsten Miljökrediter (förhandsversion).
När autentiseringen har fungerar uppdaterar du följande Postman-samlingsvariabler:
Konfigurera klient-ID-variablerna till egenskapen för program-ID för de offentliga klientprogram som registrerats i respektive Microsoft Entra ID-klientorganisation(er) enligt beskrivningen i föregående steg.
Uppdatera användarnamnet (e-postmeddelandet) och lösenordet efter behov för de tillgängliga variablerna i Postman-samlingen.
Se även
Översikt över tjänsten Miljökrediter (förhandsversion)Ordlista för tjänsten Miljökrediter (förhandsversion)Översikt över API-referens för tjänsten Miljökrediter (förhandsversion)
