Szybki przewodnik: zalogowanie użytkowników w przykładowej aplikacji CLI Node.js

Dotyczy: Użytkownicy platformy Workforce Najemcy zewnętrzni (dowiedzieć się więcej)

W tym przewodniku szybkiego startu, korzystasz z przykładowej aplikacji interfejsu wiersza polecenia Node (CLI) do logowania użytkowników w zewnętrznej dzierżawie. Przykładowa aplikacja używa biblioteki Microsoft Authentication Library for Node (MSAL Node) do obsługi uwierzytelniania.

Warunki wstępne

• Visual Studio Code lub innego edytora kodu.
• Node.js.
• Zewnętrzny najemca. Aby go utworzyć, wybierz jedną z następujących metod:
  • (Zalecane) Użyj rozszerzenia Microsoft Entra External ID do skonfigurowania zewnętrznego klienta bezpośrednio w Visual Studio Code.
  • Utwórz nowego najemcę zewnętrznego w centrum administracyjnym Microsoft Entra.
• Zarejestruj nową aplikację w centrum administracyjnym usługi Microsoft Entra, skonfigurowaną tylko dla kont w tym katalogu organizacyjnym. Aby uzyskać więcej informacji, zobacz Rejestrowanie aplikacji . Zapisz następujące wartości na stronie Przegląd aplikacji do późniejszego użycia:
  • Identyfikator aplikacji (klienta)
  • Identyfikator katalogu (klienta)
• Dodaj następujące identyfikatory URI przekierowania przy użyciu konfiguracji platformy aplikacje mobilne i desktopowe. Aby uzyskać więcej informacji, zobacz How to add a redirect URI in your application (Jak dodać identyfikator URI przekierowania w aplikacji ).
  • Niestandardowe adresy URL przekierowania: http://localhost
• Skojarz aplikację z przepływem użytkownika w centrum administracyjnym firmy Microsoft Entra. Ten przepływ użytkownika może być używany w wielu aplikacjach. Aby uzyskać więcej informacji, zobacz Tworzenie przepływów użytkowników rejestracji samoobsługowej dla aplikacji w dzierżawach zewnętrznych i Dodawanie aplikacji do przepływów użytkowników.

Włącz przepływy klientów publicznych

Aby zidentyfikować aplikację jako klienta publicznego, wykonaj następujące kroki:

1. W obszarze Zarządzajwybierz Uwierzytelnianie.

2. W obszarze Ustawienia zaawansowanedla Zezwalaj na przepływy klientów publicznychwybierz pozycję Tak.

3. Wybierz Zapisz, aby zapisać zmiany.

Sklonuj lub pobierz przykładową aplikację CLI Node.js

Aby uzyskać przykładową aplikację, możesz ją sklonować z usługi GitHub lub pobrać jako plik .zip.

• Aby sklonować przykład, otwórz wiersz polecenia i przejdź do miejsca, w którym chcesz utworzyć projekt, a następnie wprowadź następujące polecenie:

  git clone https://github.com/Azure-Samples/ms-identity-ciam-javascript-tutorial.git
  

• pobierz plik .zip. Wyodrębnij go do ścieżki pliku, w której długość nazwy jest mniejsza niż 260 znaków.

Konfiguruj przykładową aplikację interfejsu wiersza polecenia Node.js

Aby skonfigurować aplikację kliencką (Node.js aplikacja typu CLI) do korzystania ze szczegółów rejestracji aplikacji Microsoft Entra, otwórz projekt w środowisku IDE i wykonaj następujące kroki:

1. Otwórz aplikację i plik\authConfig.js.

2. Znajdź element zastępczy:

   • Enter_the_Application_Id_Here i zastąp istniejącą wartość identyfikatorem aplikacji (clientId) aplikacji node-cli-app skopiowaną z centrum administracyjnego firmy Microsoft Entra.
   • Enter_the_Tenant_Subdomain_Here i zastąp ją poddomeną Katalog (dzierżawa). Jeśli na przykład podstawowa domena najemcy to contoso.onmicrosoft.com, użyj contoso. Jeśli nie masz nazwy dzierżawy, dowiedz się, jak uzyskać dostęp do szczegółów dzierżawy

Uruchom i przetestuj przykładową aplikację CLI Node.js

Teraz możesz przetestować przykładową aplikację CLI Node.js.

1. W terminalu uruchom następujące polecenie:

   cd 1-Authentication\6-sign-in-node-cli-app\App
   npm start
   

2. Przeglądarka zostanie otwarta automatycznie i powinna zostać wyświetlona strona podobna do następującej:

   

3. Na stronie logowania wpisz adres e-mail . Jeśli nie masz konta, wybierz pozycję Nie masz konta? Załóż konto, co rozpocznie przepływ rejestracji.

4. Jeśli wybierzesz opcję rejestracji, po wypełnieniu adresu e-mail, jednorazowego kodu dostępu, nowego hasła i dodatkowych szczegółów konta, ukończ cały przepływ rejestracji. Po ukończeniu przepływu rejestracji i logowania zostanie wyświetlona strona podobna do poniższego zrzutu ekranu:

   

5. Wróć do terminalu i zapoznaj się z informacjami o uwierzytelnianiu, w tym deklaracjami tokenu identyfikacyjnego.

Powiązana zawartość

• Logowanie użytkowników we własnej aplikacji wiersza poleceń Node.js.
• Włącz resetowanie haseł.
• Dostosuj domyślne znakowanie.