Postavljanje kolekcije Postman za Uslugu za okolišno kreditiranje (pretpregled)
Važno
Neke ili sve te funkcije dostupne su kao dio izdanja za pretpregled. Sadržaj i funkcionalnost podložni su promjenama. Možete pristupiti okruženju za testiranje usluge kredita za okoliš (pretpregled) za 30-dnevno probno razdoblje. Da biste koristili uslugu kreditiranja za okoliš (pretpregled) u proizvodnom okruženju, ispunite obrazac za prijavu na uslugu kredita za okoliš (pretpregled).
Možete kopirati zbirku Postman i po potrebi promijeniti parametre.
Onboard Environmental Credit Service (pretpregled) kao aplikacija prve strane u vašem Microsoft Entra ID klijentu
Da bi provjerili autentičnost pomoću usluge kredita za okoliš (pretpregled), korisnici iz vašeg direktorija moraju predočiti token za provjeru autentičnosti, posebno JSON web token, s nekim potrebnim zahtjevima. Ove tvrdnje pomoći će Kreditnoj službi za zaštitu okoliša (pretpregled) da identificira pristup koji se pruža korisniku.
Napomena
Budući da je Environmental Credit Service (pretpregled) Microsoftova aplikacija prve strane, ne možete je izbrisati iz klijenta nakon implementacije.
Provjerite imate li pristup implementaciji usluge okolišnih kredita (pretpregled) u svom klijentu.
Idite na Korisničke postavke > Microsoft Entra ID-a > portala Azure i provjerite svojstvo Korisnici mogu registrirati aplikacije. Ako je postavljena na Ne, obratite se jednom od administratora klijenta ID-a Microsoft Entra da biste postavili uslugu okolišnih kredita (pretpregled) u svom klijentu.
Možda će vam trebati i ta dozvola za registraciju bilo kojeg klijenta ili web-aplikacije u vašem klijentu, na temelju primjenjivog scenarija za vaš tim.
Slijedite korake u odjeljku Povezivanje s modulom Microsoft Entra ID PowerShell for Graph. Ovi koraci će postaviti Microsoft Entra ID PowerShell modul i povezati se s vašim Microsoft Entra ID klijentom pomoću identiteta koji ima dozvole navedene u prvom korak.
Da biste implementirali uslugu kredita za okoliš (pretpregled) u svom klijentu, upotrijebite ovu naredbu PowerShell navodeći Microsoft Entra modul PowerShell ID-a:
New-AzureADServicePrincipal -AppId "b9b0ac19-f710-429d-b58e-dc3f73a330a9" -DisplayName "Environmental Credit Service"
Nakon što se usluga okolišnih kredita (pretpregled) implementira u vašem klijentu, idite na Azure ID > Microsoft Entra ID > Enterprise Applications > Odaberite Microsoftove aplikacije za vrstu aplikacije (i primijeni). Potražite Uslugu okolišnih kredita (pretpregled) da biste vizualizirali implementiranu poslovnu aplikaciju.
Postavljanje zbirke Postman
Da biste postavili zbirku Postman za uslugu kredita za okoliš (pretpregled), slijedite ovaj jednokratni korak za svakog Microsoft Entra ID klijenta kojeg koristite, a koji bi stupio u interakciju s uslugom kredita za okoliš (pretpregled):
Registrirajte javnu klijentsku aplikaciju u klijentu tako da odete na Azure Portal ID > Microsoft Entra > Registracije > aplikacije Nova registracija. Unesite sljedeće vrijednosti:
- Naziv: dodijelite valjano zaslonsko ime za korisnika.
- Podržane vrste računa: odaberite mogućnost Računi samo u ovom direktoriju tvrtke ili ustanove jer aplikacija neće autorizirati korisničke račune izvan ovog klijenta.
- U ovom slučaju ne očekuje se URI preusmjeravanja.
Odaberite Provjera autentičnosti. U Naprednim postavkama postavite Tretiraj aplikaciju kao javnog klijenta na Da. Spremite promjene. Javne klijentske aplikacije omogućuju korisnicima provjeru autentičnosti pomoću tijekova rada za mobilne ili stolna računala i prikupljanje lozinki otvorenog teksta pomoću tijeka rada vjerodajnica lozinke vlasnika resursa.
Odaberite odjeljak Manifest . U uređivaču JSON potražite svojstvo accessTokenAcceptedVersion i postavite njegovu vrijednost na 2. Odaberite Spremi da biste primijenili promjene.
U ovom scenariju javni klijent pokušava upotrijebiti token prijavljenog korisnika za pristup API-jima usluge okolišnih kredita (pretpregled). Aplikacija mora zatražiti delegiranu dozvolu Application.ReadWrite koju je izložila poslovna aplikacija Environmental Credit Service (pretpregled) registrirana u odjeljku preduvjeta:
- Idite do registrirane aplikacije, odaberite API dozvole, a zatim odaberite Dodaj dozvolu.
- Odaberite karticu API-ji koje koristi moja tvrtka ili ustanova i potražite poslovnu aplikaciju Environmental Credit Service (pretpregled) koja je implementirana u klijentu tijekom preduvjetnih koraka.
- Odaberite Delegirane dozvole. Delegirane dozvole zahtijevaju jednokratni pristanak korisnika da bi se naznačilo da aplikacija može koristiti njihov token za pristup potrebnom resursu. Budući da ovaj scenarij uključuje neinteraktivni tijek rada, administrator klijenta mora unaprijed dati pristanak za potrebne delegirane dozvole.
Nakon postavljanja delegiranih dozvola možete neinteraktivno zatražiti pristupni token pomoću pojedinosti navedenih u zahtjevu za autorizaciju.
Vrijednost svojstva opsega u zahtjevu za pristupni token mora biti jednaka opsegu Application.ReadWrite : https://ecs.mcfs.microsoft.com/Application.ReadWrite
. Poziv za krajnja točka tokena može se pokrenuti prije nego što pogodite bilo koji API usluge okolišnih kredita (pretpregled).
Nakon što provjera autentičnosti radi, ažurirajte sljedeće varijable zbirke Postman:
Postavite varijable ID-a klijenta na svojstvo ID-a aplikacije javnih klijentskih aplikacija registriranih u odgovarajućim Microsoft Entra klijentskim klijentima, kao što je opisano u prethodnim koracima.
Ažurirajte korisničko ime (e-poštu) i lozinku prema potrebi za dostupne varijable u zbirci Postman.
Pogledajte
Pregled
Službe za kreditiranje za okoliš (pretpregled) Pregled referentnih
referenci API-ja Službe za kreditiranje okoliša (pretpregled) za Službu za kreditiranje okoliša (pretpregled)