Použití prohlížeče MSAL v javascriptových aplikacích

Knihovna MSAL pro JavaScript umožňuje klientským aplikacím v jazyce JavaScript ověřovat identitu uživatelů pomocí pracovních a školních účtů Microsoft Entra ID, osobních účtů Microsoft (MSA) a poskytovatelů sociálních identit, jako jsou Facebook, Google, LinkedIn, účty Microsoft atd., prostřednictvím služby Azure AD B2C. Umožňuje také vaší aplikaci získat tokeny pro přístup ke službám Microsoft Cloud, jako je Microsoft Graph.

Balíček @azure/msal-browser umožňuje autentizaci v jednostránkových aplikacích v JavaScriptu pomocí toku autorizačního kódu OAuth 2.0 s PKCE. Nepodporuje implicitní tok. Aktuální verze je MSAL.js v5.x. Pokud používáte starší verzi, přečtěte si příručky k migraci k upgradu.

Předpoklady

• @azure/msal-browser je určen k použití ve scénářích aplikací typu Single-Page Application.

• Než začnete používat @azure/msal-browser, budete muset zaregistrovat jednostránkovou aplikaci v Microsoft Entra ID, abyste získali platnou clientId pro konfiguraci a zaregistrovali trasy, na kterých bude vaše aplikace přijímat přesměrovaný provoz.

Klíčové funkce

Prohlížeč MSAL poskytuje pro jednostrákové aplikace následující možnosti:

• Přihlašování uživatelů pomocí místního okna nebo toků přesměrování
• Bezobslužné získání tokenů z mezipaměti nebo prostřednictvím aktualizace
• Podpora toků vyskakovacích oken pro Cross-Origin-Opener-Policy (COOP)
• Ověřování protokolu MCP (Model Context Protocol)
• Tokeny vázané na zařízení prostřednictvím zprostředkovatele platformy (WAM)
• Mezipaměť tokenů šifrovaná pomocí AES-GCM v localStorage
• Doklad o vlastnictví (PoP) tokeny
• Jednotné přihlašování napříč kartami a aplikacemi
• Vnořené ověřování aplikací (NAA) pro aplikace Microsoft 365

Instalace

Přes NPM

npm install @azure/msal-browser

Ukázky

Složkamsal-browser-samples obsahuje ukázkové aplikace pro naše knihovny.

Další pokyny ke spuštění ukázek najdete v README.md souboru složky VanillaJSTestApp2.0.

Pokročilejší ukázky podporované kurzem najdete v prostoru Azure Ukázky na GitHub:

• JavaScript SPA volání Express.js webového rozhraní API
• JavaScript SPA volající Microsoft Graph prostřednictvím webového rozhraní API v Express.js s využitím toku On-Behalf-Of
• Kurz nasazení pro Azure App Service a Azure Storage

Obaly frameworku

Pokud používáte architekturu, jako je Angular nebo React, může vás zajímat použití jedné z našich knihoven obálky:

• Angular: @azure/msal-angular (aktuální: v5.1.1)
• React: @azure/msal-react (aktuální: v5.0.6)

Další kroky

• Inicializace aplikace
• Konfigurace prohlížeče MSAL
• Přihlášení uživatelů