Przygotowywanie dzierżawy zewnętrznej do wywoływania interfejsu API w aplikacji internetowej Node.js
Dotyczy:
Dzierżawcy siły roboczej — dzierżawcy zewnętrzni 
(dowiedz się więcej)
W tym artykule przygotujesz dzierżawę zewnętrzną do autoryzacji. Ten artykuł jest pierwszą częścią czteroczęściowego przewodnika.
Warunek wstępny
Wykonaj kroki opisane w artykule Samouczek: przygotowywanie dzierżawy zewnętrznej do logowania użytkowników w aplikacji internetowej Node.js. Po ukończeniu tego samouczka zarejestrujesz aplikację w dzierżawie klienta i masz aplikację internetową, która loguje użytkowników. Ta aplikacja internetowa jest określana jako aplikacja kliencka. Rozszerzysz tę aplikację w celu wywołania chronionego internetowego interfejsu API.
Wykonaj kroki opisane w artykule Samouczek: zabezpieczanie ASP.NET internetowego interfejsu API zarejestrowanego w dzierżawie zewnętrznej. Po ukończeniu tego samouczka zarejestrujesz internetowy interfejs API w dzierżawie klienta, który uwidacznia uprawnienia interfejsu API i publikuje role aplikacji. Masz również zabezpieczony internetowy interfejs API. Ten internetowy interfejs API jest wywoływany z aplikacji internetowej klienta.
Konfigurowanie oświadczenia tokenu idtyp [opcjonalnie]
Tokeny zwracane przez tożsamość firmy Microsoft są mniejsze, aby zapewnić optymalną wydajność przez klientów, którzy ich żądają. W związku z tym kilka oświadczeń nie jest już obecnych w tokenie domyślnie i musi zostać poproszonych o podanie w szczególności dla poszczególnych aplikacji. W przypadku tej aplikacji dołączasz opcjonalne oświadczenie idtyp , aby ułatwić interfejsowi API sieci Web określenie, czy token jest tokenem aplikacji, czy tokenem aplikacji i tokenu użytkownika. Mimo że można użyć kombinacji oświadczeń scp i ról w tym samym celu, użycie oświadczenia idtyp jest najprostszym sposobem, aby poinformować token aplikacji i token użytkownika od siebie. Na przykład wartość tego oświadczenia to aplikacja , gdy token jest tokenem tylko dla aplikacji.
Aby skonfigurować opcjonalne oświadczenie idtypu , wykonaj następujące czynności:
Na stronie Rejestracje aplikacji, dla której chcesz skonfigurować opcjonalne oświadczenie, takie jak ciam-client-app, aby otworzyć stronę Przegląd.
W obszarze Zarządzanie wybierz pozycję Konfiguracja tokenu.
Wybierz Dodaj opcjonalne roszczenie.
W obszarze Typ tokenu wybierz pozycję Dostęp.
Wybierz opcjonalny identyfikator oświadczenia.
Wybierz pozycję Dodaj , aby zapisać zmiany.
Udzielanie uprawnień interfejsu API do aplikacji internetowej
Z wymagań wstępnych aplikacja kliencka została zarejestrowana w dzierżawie klienta. Zarejestrowano również aplikację internetowego interfejsu API w swoich klientach. Teraz musisz udzielić uprawnień interfejsu API do aplikacji klienckiej:
Na stronie Rejestracje aplikacji wybierz utworzoną aplikację (np. ciam-client-app), aby otworzyć stronę Przegląd.
W obszarze Zarządzanie wybierz pozycję Uprawnienia interfejsu API.
W obszarze Skonfigurowane uprawnienia wybierz pozycję Dodaj uprawnienie.
Wybierz kartę Interfejsy API używane przez moją organizację.
Na liście interfejsów API wybierz interfejs API, taki jak ciam-ToDoList-api.
Wybierz opcję Delegowane uprawnienia .
Z listy uprawnień wybierz pozycję ToDoList.Read, ToDoList.ReadWrite (w razie potrzeby użyj pola wyszukiwania).
Wybierz przycisk Dodaj uprawnienia.
W tym momencie przypisano uprawnienia poprawnie. Jednak ponieważ dzierżawa jest dzierżawą klienta, użytkownicy odbiorcy sami nie mogą wyrazić zgody na te uprawnienia. Aby rozwiązać ten problem, administrator musi wyrazić zgodę na te uprawnienia w imieniu wszystkich użytkowników w dzierżawie:
Wybierz pozycję Udziel zgody administratora dla <swojej nazwy> dzierżawy, a następnie wybierz pozycję Tak.
Wybierz pozycję Odśwież, a następnie sprawdź, czy w obszarze Stan dla obu uprawnień jest wyświetlana wartość Przyznane dla <nazwy> dzierżawy.
Z listy Skonfigurowane uprawnienia wybierz uprawnienia ToDoList.Read i ToDoList.ReadWrite, pojedynczo, a następnie skopiuj pełny identyfikator URI uprawnienia do późniejszego użycia. Pełny identyfikator URI uprawnień wygląda podobnie do
api://{clientId}/{ToDoList.Read}lubapi://{clientId}/{ToDoList.ReadWrite}.
Następny krok
Następnie dowiedz się, jak przygotować aplikację internetową i interfejs API.