Microsoft-autentiseringsbibliotek för JavaScript (MSAL.js)

Med Microsoft-autentiseringsbibliotek för JavaScript kan både JavaScript-program på klientsidan och serversidan autentisera användare med hjälp av Microsoft Entra ID för arbets- och skolkonton, Microsoft personliga konton (MSA) och sociala identitetsprovidrar som Facebook, Google, LinkedIn, Microsoft konton osv. via Azure AD B2C-tjänsten. Det gör också att din app kan hämta token för att få åtkomst till Microsoft Cloud tjänster som Microsoft Graph.

Kärnbibliotek och wrapperbibliotek

Mappen lib innehåller källkoden för MSAL.js bibliotek i aktiv utveckling. Du hittar också all information om hur du installerar biblioteken i respektive README.md filer.

• Microsoft-autentiseringsbibliotek för Node.js (v5.0.6): Ett Node.js-bibliotek som möjliggör autentisering och tokenförvärv med plattformen Microsoft Identity i JavaScript-program. Implementerar följande OAuth 2.0-protokoll och är OpenID-kompatibelt. Se källan på GitHub.

  • Bevilja auktoriseringskod med PKCE
  • Bevilja enhetskod
  • Bevilja uppdateringstoken
  • Bevilja klientautentiseringsuppgifter
  • Tyst flöde
  • Å uppdrag av Flow
  • Interaktivt flöde
  • Hanterad identitet

• Microsoft-autentiseringsbibliotek för JavaScript (v5.4.0): Ett webbläsarbaserat, ramverksoberoende webbläsarbibliotek som möjliggör autentisering och tokenförvärv med Microsoft identitetsplattformen i JavaScript-program. Implementerar OAuth 2.0-auktoriseringskodflödet med PKCE och är OpenID-kompatibelt. Se källan på GitHub.

• Stöd för intern autentisering i MSAL: MSAL JS tillhandahåller interna autentiserings-API:er som gör det möjligt för program att implementera en intern upplevelse med anpassningsbara flöden från slutpunkt till slutpunkt i sina webbprogram. Med inbyggd autentisering kan användaren helt anpassa användargränssnittet, inklusive designelement, logotypplacering och layout, vilket säkerställer ett konsekvent och varumärkesanpassat utseende. Den inbyggda autentiseringsfunktionen är tillgänglig för SPA:er i External ID för kunder

• Microsoft-autentiseringsbibliotek för React (v5.0.6): En omslutning av msal-browser-biblioteket för appar som använder React. Se källan på GitHub.

• Microsoft-autentiseringsbibliotek för Angular (v5.1.1): En omslutning av msal-browser-biblioteket för appar som använder Angular-ramverket. Se källan på GitHub.

• Microsoft-autentiseringstillägg för Node: Microsoft-autentiseringstillägg för Node erbjuder säkra mekanismer för klientprogram för att utföra cache-serialisering och beständighet mellan plattformar. Det ger ytterligare stöd till Microsoft-autentiseringsbibliotek för Node (MSAL).

Nyheter i v5

MSAL.js v5 introducerar flera viktiga funktioner:

• Stöd för Cross-Origin–Opener-Policy (COOP): Aktiverar popup-autentiseringsflöden i miljöer med strikta COOP-huvuden.
• MCP-autentisering (Model Context Protocol): Stöder autentiseringsflöden för AI-agent- och verktygsintegreringar.
• Inkapslad appautentisering (NAA): Aktiverar autentisering för appar som körs i Microsoft 365-värdappar med createNestablePublicClientApplication.
• localStorage AES-GCM kryptering: Krypterar tokencachen i localStorage med hjälp av AES-GCM för bättre säkerhet.
• Fabriksfunktioner: Använd createStandardPublicClientApplication eller createNestablePublicClientApplication för att initiera MSAL med asynkron konfiguration.
• WAM-integrering (Platform Broker): Aktivera Windows autentiseringshanteraren (WAM) asynkron autentisering via konfigurationsalternativetallowPlatformBroker.

Migreringsguider till MSAL JavaScript v5.x finns i:

• Migrering av MSAL Browser från v4 till v5
• Migrering av MSAL Node från v3 till v5
• MSAL Angular v4 till v5-uppgradering
• Migreringsguide för MSAL React

Bibliotek med långtidssupport

I följande tabell visas de aktiva versionerna och LTS-versionerna för varje MSAL.js bibliotek:

LTS-biblioteken, som finns på grenenmsal-lts, är inte längre i aktiv utveckling men får fortfarande stöd för kritiska felkorrigeringar för säkerhetsfel.

• Microsoft-autentiseringsbibliotek för JavaScript v2.x
• Microsoft Authentication Library för Node.js v1.x
• Microsoft-autentiseringsbibliotek för React v1.x
• Microsoft-autentiseringsbibliotek för Angular v2.x

Paketstruktur

Det finns ett antal olika paket som är avsedda för olika plattformar. Du kan se relationen mellan paket och olika autentiseringsflöden som de implementerar i paketstrukturen nedan.

Samples

code samples visar hur man använder Microsofts autentiseringsbibliotek för JavaScript med identitetsplattformen. Varje kodexempel innehåller en README.md fil som beskriver hur du skapar projektet (om tillämpligt) och kör exempelprogrammet.

En fullständig lista över exempel som riktar sig till JavaScript och andra språk, ramverk och plattformar finns i Microsofts identitetsplattform kodexempel.

För inbyggda autentiseringsfunktioner visar exempelapparna hur du använder intern autentisering i React- och Angular-webbprogram. Varje kodexempel innehåller en README.md fil som beskriver hur du skapar projektet och kör exempelprogrammet. Det aktuella interna autentiserings-API:et stöder inte resursdelning mellan ursprung (CORS), exempelappen körs med lokal proxy.

Paketversionshantering

Alla våra bibliotek följer semantisk versionshantering. Vi rekommenderar att du använder den senaste versionen av varje bibliotek för att säkerställa att du har de senaste säkerhetskorrigeringarna och felkorrigeringarna.

Säkerhetsrapportering

Om du hittar ett säkerhetsproblem med våra bibliotek eller tjänster kan du rapportera det till Microsoft Security Response Center (MSRC) med så mycket information som möjligt.