Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Dotyczy:
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:
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-sampleZainstaluj 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.
- Otwórz
src/config/auth-config.ts. - Zastąp
Enter_the_Application_Id_Hereelement identyfikatorem aplikacji. - Zastąp pełną wartość
auth.authorityciągiemhttps://<tenant-verified-custom-domain>/<tenant-GUID>, podstawiając własną zweryfikowaną nazwę hosta i identyfikator GUID dzierżawy. - Dodaj
auth.knownAuthoritiesjako tablicę zawierającą zweryfikowaną nazwę hosta bez schematu lub ścieżki. - Ustaw wymagany ciąg
customAuth.authApiProxyUrlna tę samą pełną wartość authorityhttps://<tenant-verified-custom-domain>/<tenant-GUID>. Uwzględnij identyfikator GUID dzierżawy w obu ustawieniach adresu URL zestawu SDK. - 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:
Uruchom aplikację:
npm run devOtwórz
http://localhost:3000w 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.
- Wprowadź testowy adres e-mail klienta i wybierz pozycję Zaloguj się.
- Jeśli usługa oferuje wiele metod pierwszego czynnika, wybierz metodę hasła. Wprowadź hasło, gdy pojawi się monit, i wybierz pozycję Zaloguj.
- Jeśli usługa żąda uwierzytelniania wieloskładnikowego, wybierz zwróconą wiadomość e-mail lub metodę SMS i wprowadź kod weryfikacyjny.
- 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.
- Wyloguj się z aplikacji przykładowej i wyczyść interfejs użytkownika aplikacji związany z kontem.
- Zatrzymaj aplikację w jego terminalu.