Szybki start: Zaloguj się przy użyciu osadzonego uwierzytelniania natywnego

Dotyczy: Zielone kółko z białym znacznikiem wyboru, wskazujące, że poniższa zawartość ma zastosowanie do zewnętrznych dzierżaw. Zewnętrzne dzierżawy (dowiedz się więcej)

Sposób uwierzytelniania: Natywne uwierzytelnianie osadzone.

W tym przewodniku Szybki start skonfigurujesz przykład platformy React Next.js na potrzeby uwierzytelniania natywnego osadzonego przy użyciu biblioteki Microsoft Authentication Library (MSAL) dla języka JavaScript 5.29.1. Przepływ logowania przy użyciu adresu e-mail i hasła korzysta z niestandardowej domeny zweryfikowanej w dzierżawie z obsługą mechanizmu Cross-Origin Resource Sharing (CORS) na brzegu.

Important

Native Authentication API V2 jest w wersji zapoznawczej. Interfejs API Native Authentication V1 jest nadal ogólnie dostępny. Zapoznaj się z dodatkowymi warunkami użytkowania wersji zapoznawczych Microsoft Azure, aby zapoznać się z postanowieniami prawnymi mającymi zastosowanie do funkcji w wersji zapoznawczej.

Prerequisites

  • Zewnętrzny dzierżawca i publiczna aplikacja kliencka skonfigurowana do uwierzytelniania natywnego embedded. Ukończ „Konfigurowanie aplikacji”.
  • Niestandardowa domena zweryfikowana dla dzierżawy, identyfikator aplikacji i identyfikator GUID dzierżawy katalogu.
  • MECHANIZM CORS na krawędzi domeny niestandardowej skonfigurowanej dla źródła przeglądarki przykładu, http://localhost:3000. Zastosuj współużytkowany kontrakt serwera proxy dla źródeł, żądań preflight, nagłówków zestawu SDK oraz odpowiedzi o powodzeniu i błędach.
  • Konto klienta z adresem e-mail i hasłem. Jeśli zasady dzierżawcy wymagają uwierzytelniania wieloskładnikowego (MFA), przygotuj włączony mechanizm uwierzytelniania za pomocą wiadomości e-mail lub SMS na potrzeby tej przykładowej podróży.
  • Node.js 20.9.0 lub nowsze, npm, Git i edytor kodu.
  • Port 3000 jest dostępny dla aplikacji.

Pobieranie przykładu

Przykład zawiera ujednolicony moduł uruchamiania dla wersji 1 i V2. Użyj przypiętej wersji i wersji zestawu SDK poniżej, aby wykonać czynności opisane w tym przewodniku Szybki start:

  1. Sklonuj repozytorium, przełącz się na przykładową rewizję i otwórz jego aplikację React Next.js:

    git clone https://github.com/Azure-Samples/ms-identity-ciam-native-javascript-samples
    cd ms-identity-ciam-native-javascript-samples
    git checkout --detach 49c4e250a1e6eb97e2b813e9fce6670c996a2808
    cd typescript/native-auth/react-nextjs-sample
    
  2. Zainstaluj dokładną wersję zestawu SDK przy użyciu przykładowych zależności:

    npm install --save-exact "@azure/msal-browser@5.29.1"
    

Konfigurowanie aplikacji

Użyj https://<tenant-verified-custom-domain>/<tenant-GUID> zarówno dla autorytetu usługi, jak i bazy transportowej interfejsu API zestawu SDK na tej trasie edge. Zachowaj nieprzezroczyste bezwzględne linki HAL dla tego autorytetu bez zmian. Nie dodawaj klucza tajnego klienta do konfiguracji przeglądarki.

  1. Otwórz src/config/auth-config.ts.
  2. Zastąp Enter_the_Application_Id_Here element identyfikatorem aplikacji.
  3. Zastąp pełną wartość auth.authority ciągiem https://<tenant-verified-custom-domain>/<tenant-GUID>, podstawiając własną zweryfikowaną nazwę hosta i identyfikator GUID dzierżawy.
  4. Dodaj auth.knownAuthorities jako tablicę zawierającą zweryfikowaną nazwę hosta bez schematu lub ścieżki.
  5. Ustaw wymagany ciąg customAuth.authApiProxyUrl na tę samą pełną wartość authority https://<tenant-verified-custom-domain>/<tenant-GUID>. Uwzględnij identyfikator GUID dzierżawy w obu ustawieniach adresu URL zestawu SDK.
  6. Zapisz plik konfiguracji. Przykład w wersji 2 używa domyślnych zakresów zestawu SDK bez niestandardowych roszczeń. Wymagania uwierzytelniania wieloskładnikowego pochodzą z zasad tenanta, a nie z wybrania V2.

Uruchamianie aplikacji przykładowej

Uruchom aplikację z przykładowego katalogu. Ta konfiguracja krawędzi domeny niestandardowej nie używa lokalnego serwera proxy CORS przykładu:

  1. Uruchom aplikację:

    npm run dev
    
  2. Otwórz http://localhost:3000 w przeglądarce i wybierz pozycję V2. Pozostaw proces aplikacji uruchomiony podczas testowania.

Zaloguj testowego klienta

Użyj ujednoliconego modułu uruchamiania przykładu, aby przetestować tylko metody włączone dla bieżącej transakcji.

  1. Wprowadź testowy adres e-mail klienta i wybierz pozycję Zaloguj się.
  2. Jeśli usługa oferuje wiele metod pierwszego czynnika, wybierz metodę hasła. Wprowadź hasło, gdy pojawi się monit, i wybierz pozycję Zaloguj.
  3. Jeśli usługa żąda uwierzytelniania wieloskładnikowego, wybierz zwróconą wiadomość e-mail lub metodę SMS i wprowadź kod weryfikacyjny.
  4. Upewnij się, że przykład zgłasza ukończone logowanie. Nie ujawniaj tokenów na zrzutach ekranu, w dziennikach ani w danych wyjściowych pomocy technicznej.

Logowanie przy użyciu jednorazowego kodu dostępu używa konta klienta i przepływu użytkownika skonfigurowanego dla tej metody. Ten przewodnik Szybki start opisuje ścieżkę logowania przy użyciu adresu e-mail i hasła.

Czyszczenie sesji

Zakończ test lokalny bez usuwania konfiguracji dzierżawy udostępnionej.

Wylogowanie z przykładu nie powoduje zakończenia innych sesji aplikacji ani przeglądarki.

  1. Wyloguj się z aplikacji przykładowej i wyczyść interfejs użytkownika aplikacji związany z kontem.
  2. Zatrzymaj aplikację w jego terminalu.