Udostępnij za pośrednictwem


Konfigurowanie kolekcji Postman dla Usługi kredytowania na cele ekologiczne (wersja zapoznawcza)

Microsoft Cloud for Sustainability Tech Summit w listopadzie 2024 r.

Ważne

Niektóre lub wszystkie te funkcje są dostępne w wersji zapoznawczej. Zawartość i funkcjonalność mogą ulec zmianie. 30-dniowa wersja próbna umożliwia dostęp do środowiska piaskownicy Usługi kredytowania na cele ekologiczne (wersja zapoznawcza). Aby używać usługi kredytowania na cele ekologiczne (wersja zapoznawcza) w środowisku produkcyjnym, wypełnij formularza tworzenia konta Usługi kredytowania na cele ekologiczne (wersja zapoznawcza).

Możesz skopiować kolekcję Postman i zmienić parametry, jeśli to konieczne.

Włączanie usługi kredytowania na cele ekologiczne (wersja zapoznawcza) jako aplikacji własnej w dzierżawie Microsoft Entra

Aby uwierzytelnić się w Usłudze kredytowania na cele ekologiczne (wersja zapoznawcza), użytkownicy z twojego katalogu muszą przedstawić token uwierzytelniający, w szczególności token internetowy JSON, zawierający pewne wymagane żądania. Te oświadczenia pomogą Usłudze kredytowania na cele ekologiczne (wersja zapoznawcza) w identyfikacji dostępu udzielonego użytkownikowi.

Uwaga

Ponieważ Usługa kredytowania na cele ekologiczne (wersja zapoznawcza) jest aplikacją firmy Microsoft, nie można jej usunąć z dzierżawy po wdrożeniu.

  1. Sprawdź, czy masz dostęp do wdrażania usługi kredytowania na cele ekologiczne (wersja zapoznawcza) w swojej dzierżawie.

    Przejdź do portalu Azure Portal > Microsoft Entra ID > Ustawienia użytkownika i sprawdź właściwość Użytkownicy mogą rejestrować aplikacje. Jeśli jest ustawiona na Nie, skontaktuj się z jednym z administratorów dzierżawy Microsoft Entra, aby skonfigurować usługę kredytowania na cele ekologiczne (wersja zapoznawcza) w swojej dzierżawie.

  2. Uprawnienie to może być również potrzebne do rejestracji aplikacji klienckich lub internetowych w dzierżawie, zgodnie ze scenariuszem obowiązującym w twoim zespole.

  3. Postępuj zgodnie z instrukcjami w Połączenie z modułem Microsoft Entra PowerShell dla wykresów. Te kroki pozwolą skonfigurować moduł Microsoft Entra PowerShell i połączyć się z użytkownika dzierżawą Microsoft Entra przy użyciu tożsamości, która ma uprawnienia określone w pierwszym kroku.

  4. Aby wdrożyć usługę kredytowania na cele ekologiczne (wersja zapoznawcza) w swojej dzierżawie, użyj tego polecenia PowerShell, określając swój moduł Microsoft Entra PowerShell:

       New-AzureADServicePrincipal -AppId "b9b0ac19-f710-429d-b58e-dc3f73a330a9" -DisplayName "Environmental Credit Service"
    
  5. Po wdrożeniu usługi kredytowania na cele ekologiczne (wersja zapoznawcza) w twojej dzierżawie, przejdź do Azure Portal > Microsoft Entra > Aplikacje dla przedsiębiorstw > Wybierz Aplikacje Microsoft jako typ aplikacji (i Zastosuj). Wyszukaj Usługa kredytowania na cele ekologiczne (wersja zapoznawcza), aby obejrzeć wdrożoną aplikację przedsiębiorstwa.

Konfigurowanie kolekcji Postman

Aby skonfigurować kolekcję Postman dla Usługa kredytowania na cele ekologiczne (wersja zapoznawcza), wykonaj tę jednorazową czynność dla każdej używanej dzierżawy Microsoft Entra, która będzie współdziałać z Usługą kredytowania na cele ekologiczne (wersja zapoznawcza):

  1. Zarejestruj publiczną aplikację kliencką w dzierżawie, przechodząc do Azure Portal > Microsoft Entra > Rejestracje aplikacji > Nowa rejestracja. Wprowadź następujące wartości:

    • Nazwa: Podaj prawidłową wyświetlaną nazwę użytkownika.
    • Obsługiwane typy kont: wybierz opcję Konta tylko w tym katalogu organizacyjnym, ponieważ aplikacja nie będzie uwierzytelniać kont użytkowników spoza tej dzierżawy.
    • W tym przypadku nie jest oczekiwany identyfikator URI przekierowania.
  2. Wybierz Uwierzytelnianie. W Ustawieniach zaawansowanych ustaw Traktuj aplikację jako klienta publicznego na Tak. Zapisz zmiany. Publiczne aplikacje klienckie pozwalają użytkownikom uwierzytelniać się za pomocą przepływów pracy na urządzeniach przenośnych lub stacjonarnych oraz zbierać hasła jawne za pomocą przepływu pracy uwierzytelniającej z hasłem właściciela zasobów.

  3. Wybierz sekcję Manifest. W edytorze JSON wyszukaj właściwość accessTokenAcceptedVersion i ustaw jej wartość na 2. Wybierz Zapisz, aby zastosować zmiany.

  4. W tym scenariuszu klient publiczny próbuje użyć tokena zalogowanego użytkownika, aby uzyskać dostęp do interfejsów API Usługi kredytowania na cele ekologiczne (wersja zapoznawcza). Wniosek musi zawierać prośbę o Application.ReadWrite zezwolenie delegowane przez aplikację Usługa kredytowania na cele ekologiczne (wersja zapoznawcza) zarejestrowaną w sekcji warunków wstępnych:

    1. Przejdź do zarejestrowanej aplikacji, wybierz Uprawnienia API i wybierz Dodaj uprawnienie.
    2. Wybierz zakładkę API, których używa moja organizacja i wyszukaj aplikację przedsiębiorstwa Usługa kredytowania na cele ekologiczne (wersja zapoznawcza), która została wdrożona w dzierżawie podczas wykonywania czynności wstępnych.
    3. Wybieranie delegowanych uprawnień. Uprawnienia delegowane wymagają jednorazowej zgody użytkownika, aby wskazać, że aplikacja może użyć jego tokena do uzyskania dostępu do wymaganego zasobu. Ponieważ ten scenariusz dotyczy nieinteraktywnego przepływu pracy, zgoda musi być udzielona z góry przez administratora dzierżawy dla wymaganych delegowanych uprawnień.

Po skonfigurowaniu delegowanych uprawnień możesz nieinteraktywnie poprosić o token dostępu, używając szczegółów podanych w Wniosek o autoryzację.

Wartość właściwości zakresu w żądaniu tokenu dostępu musi być równa zakresowi Application.ReadWrite: https://ecs.mcfs.microsoft.com/Application.ReadWrite. Wywołanie punktu końcowego tokena może zostać zainicjowane przed wejściem do jakiegokolwiek interfejsu API Usługa kredytowania na cele ekologiczne (wersja zapoznawcza).

Gdy uwierzytelnianie działa, zaktualizuj następujące zmienne kolekcji Postman:

  1. Ustaw zmienne identyfikatora klienta na właściwość identyfikatora aplikacji publicznych aplikacji klienckich zarejestrowanych w odpowiednich dzierżawach Microsoft Entra, zgodnie z opisem w poprzednich krokach.

  2. Zaktualizuj nazwę użytkownika (e-mail) i hasło zgodnie z wymaganiami dla zmiennych dostępnych w kolekcji Postman.

Omówienie
Usługi kredytowania na cele ekologiczne (wersja zapoznawcza) Słownik
Usługi kredytowania na cele ekologiczne (wersja zapoznawcza) Omówienie interfejsu API dla Usługi kredytowania na cele ekologiczne (wersja zapoznawcza)