Az MSAL Browser használata JavaScript-alkalmazásokban

A JavaScripthez készült MSAL-kódtár lehetővé teszi az ügyféloldali JavaScript-alkalmazások számára a felhasználók hitelesítését Microsoft Entra ID munkahelyi és iskolai fiókok, Microsoft személyes fiókok (MSA) és közösségi identitásszolgáltatók, például Facebook, Google, LinkedIn, Microsoft fiókok stb. használatával Azure AD-n keresztül B2C szolgáltatás. Emellett lehetővé teszi, hogy az alkalmazás tokeneket szerezzen be a Microsoft Cloud szolgáltatások, például a Microsoft Graph eléréséhez.

A @azure/msal-browser csomag engedélyezi a hitelesítést egyoldalas JavaScript-alkalmazásokban az OAuth 2.0 engedélyezési kódfolyamat és a PKCE használatával. Nem támogatja az implicit folyamatot. Az aktuális verzió MSAL.js v5.x. Ha régebbi verziót használ, tekintse meg a frissítéshez szükséges migrálási útmutatókat .

Prerequisites

• @azure/msal-browser arra szolgál, hogy egylapos alkalmazások esetén használják.

• A @azure/msal-browser használata előtt regisztrálnia kell egy egyoldalas alkalmazást a Microsoft Entra ID-ben, hogy a konfigurációhoz érvényes clientId kapjon, valamint regisztrálnia kell azokat az útvonalakat, amelyeken az alkalmazás fogadja az átirányítási forgalmat.

Legfontosabb funkciók

Az MSAL Browser az alábbi képességeket biztosítja az egyoldalas alkalmazásokhoz:

• Felhasználók bejelentkezése előugró vagy átirányítási folyamatokkal
• Tokenek beszerzése felhasználói beavatkozás nélkül gyorsítótárból vagy frissítés útján
• A Cross-Origin-Opener-Policy (COOP) felugró ablakos folyamatainak támogatása
• Modellkörnyezeti protokoll (MCP) hitelesítése
• Eszközhöz kötött tokenek platformközvetítőn (WAM) keresztül
• AES-GCM-mel titkosított tokengyorsítótár a localStorage-ban
• Birtoklást igazoló (PoP-)tokenek
• Egyszeri bejelentkezés lapok és alkalmazások között
• Beágyazott alkalmazáshitelesítés (NAA) Microsoft 365 alkalmazásokhoz

Telepítés

NPM-en keresztül

npm install @azure/msal-browser

Samples

A msal-browser-samples mappa könyvtárainkhoz készült mintalkalmazásokat tartalmaz.

A minták futtatására vonatkozó további utasítások a README.md VanillaJSTestApp2.0 mappa fájljában találhatók.

Az oktatóanyaggal támogatott fejlettebb minták a Azure Minták területen találhatók a GitHub:

• Express.js webes API-t hívó JavaScript SPA
• JavaScript SPA, amely meghatalmazásos folyamat használatával hívja meg a Microsoft Graphot egy Express.js webes API-n keresztül
• Üzembe helyezési oktatóanyag Azure App Service és Azure Storage

Keretrendszerburkolók

Ha olyan keretrendszert használ, mint az Angular vagy a React, akkor az egyik burkolókódtárat érdemes használnia:

• Angular: @azure/msal-angular (jelenlegi: v5.1.1)
• React: @azure/msal-react (aktuális: 5.0.6-os verzió)

Következő lépések

• Az alkalmazás inicializálása
• MSAL böngésző konfigurálása
• Felhasználók bejelentkezése