Opsætte Postman-samlingen til Tjeneste til miljøkredit (forhåndsversion)
Vigtige oplysninger
Nogle eller alle af disse funktioner, der er angivet i dette emne, er tilgængelige som del af en forhåndsversion. Indholdet og funktionerne kan ændres. Du kan få adgang til Tjeneste til miljøkredit (forhåndsversion)-sandkassemiljø til en 30 dages prøveversion. Hvis du vil bruge Tjeneste til miljøkredit (forhåndsversion) i et produktionsmiljø, skal du udfylde tilmeldingsformularen for Tjeneste til miljøkredit (forhåndsversion).
Du kan kopiere Postman-samlingen og ændre parametrene efter behov.
Onboarde Tjeneste til miljøkredit (forhåndsversion) som førstepartsprogram i din Microsoft Entra ID-lejer
For at blive godkendt med Tjeneste til miljøkredit (forhåndsversion) skal brugere fra dit bibliotek præsentere et godkendelsestoken, især et JSON-webtoken, med nogle obligatoriske krav. Disse krav hjælper Tjeneste til miljøkredit (forhåndsversion) med at identificere den adgang, der gives til en bruger.
Bemærk!
Da Tjeneste til miljøkredit (forhåndsversion) er et Microsoft-førstepartsprogram, kan du ikke slette det fra lejeren, når det er installeret.
Kontrollér, at du har adgang til at installere Tjeneste til miljøkredit (forhåndsversion) i lejeren.
Naviger til Azure Portal > Microsoft Entra ID > Brugerindstillinger og tjek for egenskaben Brugere kan registrere applikationer. Hvis den er angivet til Nej, skal du kontakte en af Microsoft Entra ID-lejeradministratorne for at konfigurere Tjeneste til miljøkredit (forhåndsversion) i lejeren.
Du skal muligvis også bruge denne tilladelse til at registrere eventuelle klient- eller webapps i din lejer, afhængigt af det relevante scenarie for dit team.
Følg trinene i Opret forbindelse til Microsoft Entra ID PowerShell for Graph-modulet. Disse trin konfigurerer Microsoft Entra ID PowerShell-modulet og opretter forbindelse med din Microsoft Entra ID-lejer ved hjælp af en identitet, der har de tilladelser, der er angivet i det første trin.
Hvis du vil installere Tjeneste til miljøkredit (forhåndsversion) i lejeren, skal du bruge denne PowerShell-kommando og angive dit Microsoft Entra ID PowerShell-modul:
New-AzureADServicePrincipal -AppId "00001111-aaaa-2222-bbbb-3333cccc4444" -DisplayName "Environmental Credit Service"Når Tjeneste til miljøkredit (forhåndsversion) er installeret i din lejer, skal du navigere til Azure Portal > Microsoft Entra ID > Virksomhedsprogrammer > Vælg Microsoft-programmer som programtype (og anvend den). Søg efter Tjeneste til miljøkredit (forhåndsversion) for at visualisere den installerede virksomhedsapp.
Konfigurere Postman-samlingen
Hvis du vil konfigurere Postman-samlingen til Tjeneste til miljøkredit (forhåndsversion), skal du følge dette engangstrin for alle de Microsoft Entra ID-lejere, du bruger, og som skal interagere med Tjeneste til miljøkredit (forhåndsversion):
Registrer en offentlig klientapplikation i lejeren ved at navigere til Azure Portal > Microsoft Entra ID > Appregistreringer > Ny registrering. Angiv følgende værdier:
- Navn: Angiv et gyldigt brugervendt visningsnavn.
- Understøttede kontotyper: Vælg indstillingen Kun konti i denne organisationsmappe, da appen ikke godkender brugerkonti uden for denne lejer.
- Der forventes ingen omdirigerings-URI i dette tilfælde.
Vælg Godkendelse. Angiv Behandl program som en offentlig klient til Ja i Avancerede indstillinger. Gem dine ændringer. Offentlige klientprogrammer giver brugere mulighed for at godkende ved hjælp af arbejdsprocesser på mobilenheder eller stationære computere og indsamle adgangskoder i almindelig tekst ved hjælp af en arbejdsproces med legitimationsoplysningerne til en ressourceejer.
Vælg sektionen Manifest. Søg efter egenskaben accessTokenAcceptedVersion i JSON-editoren, og angiv værdien til 2. Vælg Gem for at anvende ændringerne.
I dette scenarie forsøger den offentlige klient at bruge tokenet for den bruger, der er logget på, til at få adgang til API'er til Tjeneste til miljøkredit (forhåndsversion). Programmet skal anmode om den delegerede tilladelse Application.ReadWrite, som vises i virksomhedsappen Tjeneste til miljøkredit (forhåndsversion), der er registreret i den nødvendige sektion:
- Naviger til det registrerede program, vælg API-tilladelser, og vælg derefter Tilføj en tilladelse.
- Vælg fanen API'er, som min organisation bruger, og søg efter virksomhedsappen Tjeneste til miljøkredit (forhåndsversion), der blev installeret i lejeren under de nødvendige trin.
- Vælg Delegerede tilladelser. Uddelegerede tilladelser kræver engangsbrugerens samtykke for at angive, at programmet kan bruge deres token til at få adgang til den påkrævede ressource. Da dette scenarie omfatter ikke-interaktive arbejdsprocesser, skal lejeradministratoren på forhånd give sit samtykke til de påkrævede uddelegerede tilladelser.
Når de uddelegerede tilladelser er konfigureret, kan du uden interaktion anmode om adgangstokenet ved hjælp af oplysningerne i Anmodning om godkendelse.
Værdien for egenskabsomfanget i adgangstoken-anmodningen skal være lig med omfanget Application.ReadWrite: https://ecs.mcfs.microsoft.com/Application.ReadWrite. Opkaldet til token-slutpunktet kan startes, før du vælger en API til Tjeneste til miljøkredit (forhåndsversion).
Når godkendelsen fungerer, skal du opdatere følgende variabler for Postman-samlingen:
Indstil klient-id-variablerne til applikations-id-egenskaben for de offentlige klientapplikationer, der er registreret i de respektive Microsoft Entra ID-lejere, som beskrevet i de foregående trin.
Opdater brugernavnet (mailen) og adgangskoden efter behov for de tilgængelige variabler i Postman-samlingen.
Relaterede oplysninger
Oversigt over Miljøkredittjeneste (forhåndsversion) Oversigt
over Ordliste
over Miljøkredittjeneste (forhåndsversion) Oversigt over API-reference for Miljøkredittjeneste (forhåndsversion)
