Korzystanie z przeglądarki MSAL w aplikacjach JavaScript

Biblioteka MSAL dla języka JavaScript umożliwia aplikacjom JavaScript po stronie klienta uwierzytelnianie użytkowników przy użyciu kont służbowych Microsoft Entra ID, kont osobistych Microsoft (MSA) i dostawców tożsamości społecznościowych, takich jak Facebook, Google, LinkedIn, konta Microsoft itp. za pośrednictwem usługi Azure AD Usługa B2C. Umożliwia również aplikacji uzyskiwanie tokenów dostępu do usług Microsoft Cloud, takich jak Microsoft Graph.

Pakiet @azure/msal-browser umożliwia uwierzytelnianie w jednostronicowych aplikacjach JavaScript przy użyciu przepływu kodu autoryzacji OAuth 2.0 z użyciem PKCE. Nie obsługuje ona niejawnego przepływu. Bieżąca wersja to MSAL.js v5.x. Jeśli używasz starszej wersji, zapoznaj się z przewodnikami migracji w celu uaktualnienia.

Wymagania wstępne

• @azure/msal-browser jest przeznaczony do użycia w scenariuszach aplikacji jednostronicowych.

• Przed użyciem @azure/msal-browser należy zarejestrować aplikację jednostronicową w Microsoft Entra ID, aby uzyskać prawidłową clientId konfigurację, oraz zarejestrować trasy, na których aplikacja będzie akceptować ruch przekierowania.

Kluczowe funkcje

Przeglądarka MSAL oferuje następujące możliwości dla aplikacji jednostronicowych:

• Logowanie użytkownika za pomocą wyskakującego okna lub przekierowania
• Uzyskiwanie tokenów w trybie dyskretnym z pamięci podręcznej lub za pośrednictwem odświeżania
• Obsługa przepływów wyskakujących okien w Cross-Origin-Opener-Policy (COOP)
• Uwierzytelnianie protokołu MCP (Model Context Protocol)
• Tokeny powiązane z urządzeniem za pośrednictwem brokera platformy (WAM)
• Pamięć podręczna tokenów zaszyfrowana algorytmem AES-GCM w localStorage
• Tokeny dowodu posiadania (PoP)
• Logowanie jednokrotne na kartach i aplikacjach
• Zagnieżdżone uwierzytelnianie aplikacji (NAA) dla aplikacji Microsoft 365

Instalacja

Przez NPM

npm install @azure/msal-browser

Przykłady

Folder msal-browser-samples zawiera przykładowe aplikacje dla naszych bibliotek.

Więcej instrukcji dotyczących uruchamiania przykładów można znaleźć w README.md pliku w folderze VanillaJSTestApp2.0.

Bardziej zaawansowane przykłady oparte na samouczku można znaleźć w obszarze przykłady Azure w GitHub:

• JavaScript SPA wywołujący internetowy interfejs API Express.js
• Aplikacja SPA JavaScript wywołująca Microsoft Graph za pośrednictwem internetowego interfejsu API Express.js przy użyciu przepływu On-Behalf-Of
• Samouczek wdrażania dla Azure App Service i Azure Storage

Otoki struktury

Jeśli używasz frameworka, takiego jak Angular lub React, może Cię zainteresować skorzystanie z jednej z naszych bibliotek opakowujących:

• Angular: @azure/msal-angular (obecnie: v5.1.1)
• React: (current:@azure/msal-react v5.0.6)

Następne kroki

• Inicjowanie aplikacji
• Konfigurowanie przeglądarki MSAL
• Logowanie użytkowników