Microsoft Authentication Library für JavaScript (MSAL.js)

Die Microsoft Authentication Library für JavaScript ermöglicht sowohl clientseitigen als auch serverseitigen JavaScript-Anwendungen die Authentifizierung von Benutzern mithilfe von Microsoft Entra ID für Geschäfts- und Schulkonten, Microsoft persönlichen Konten (MSA) und identitätsanbietern für soziale Netzwerke wie Facebook, Google, LinkedIn, Microsoft Konten usw. über Azure AD B2C-Dienst. Außerdem ermöglicht es Ihrer App, Token für den Zugriff auf Microsoft Cloud Dienste wie Microsoft Graph abzurufen.

Kern- und Wrapperbibliotheken

Der lib Ordner enthält den Quellcode für MSAL.js Bibliotheken in der aktiven Entwicklung. Außerdem finden Sie alle Details zum Installieren der Bibliotheken in den jeweiligen README.md Dateien.

• Microsoft-Authentifizierungsbibliothek für Node.js (v5.0.6): Eine Node.js-Bibliothek, die die Authentifizierung und den Tokenerwerb mit der Microsoft Identity Platform in JavaScript-Anwendungen ermöglicht. Implementiert die folgenden OAuth 2.0-Protokolle und ist OpenID-kompatibel. Informationen finden Sie in der Quelle auf GitHub.

  • Autorisierungscode-Grant mit PKCE
  • Gerätecodeerteilung
  • Aktualisierungstokenerteilung
  • Client-Anmeldeinformationsgewährung
  • Stiller Fluss
  • On-behalf-of Flow
  • Interaktiver Fluss
  • Verwaltete Identität

• Microsoft Authentication Library für JavaScript (v5.4.0): Eine browserbasierte, frameworkunabhängige Browserbibliothek, die den Authentifizierungs- und Tokenerwerb mit der Microsoft Identity Platform in JavaScript-Anwendungen ermöglicht. Implementiert den OAuth 2.0-Autorisierungscodefluss mit PKCE und ist OpenID-kompatibel. Informationen finden Sie in der Quelle auf GitHub.

• Native Authentifizierungsunterstützung in MSAL: MSAL JS bietet native Authentifizierungs-APIs, mit denen Anwendungen eine systemeigene Erfahrung mit end-to-End anpassbaren Flüssen in ihren Webanwendungen implementieren können. Mit der nativen Authentifizierung kann der Benutzer die Benutzeroberfläche vollständig anpassen, einschließlich Designelemente, Logoplatzierung und Layout, um ein einheitliches und markenbasiertes Aussehen sicherzustellen. Die native Authentifizierungsfunktion ist für SPAs in External ID for customers verfügbar.

• Microsoft-Authentifizierungsbibliothek für React (v5.0.6): Ein Wrapper der msal-browser-Bibliothek für Apps mit React. Informationen finden Sie in der Quelle auf GitHub.

• Microsoft Authentication Library für Angular (v5.1.1): Ein Wrapper der Msal-Browser-Bibliothek für Apps mit Angular-Framework. Informationen finden Sie in der Quelle auf GitHub.

• Microsoft Authentication Extensions for Node: Die Microsoft Authentication Extensions for Node bieten sichere Mechanismen, mit denen Clientanwendungen plattformübergreifende Tokencache-Serialisierung und -persistenz ermöglichen können. Sie bietet zusätzliche Unterstützung für die Microsoft-Authentifizierungsbibliothek für Node (MSAL).

Neuerungen in v5

MSAL.js v5 führt mehrere wichtige Features ein:

• Cross-Origin-Opener-Policy (COOP)-Unterstützung: Ermöglicht Authentifizierungsabläufe in Pop-ups in Umgebungen mit strengen COOP-Headern.
• McP-Authentifizierung (Model Context Protocol): Unterstützt Authentifizierungsflüsse für KI-Agent- und Toolintegrationen.
• Geschachtelte App-Authentifizierung (NAA): Ermöglicht die Authentifizierung für Apps, die in Microsoft 365-Hostanwendungen unter Verwendung von createNestablePublicClientApplication ausgeführt werden.
• localStorage AES-GCM Verschlüsselung: Verschlüsselt den Tokencache in localStorage mithilfe von AES-GCM zur Verbesserung der Sicherheit.
• Factoryfunktionen: Verwenden Sie createStandardPublicClientApplication oder createNestablePublicClientApplication, um MSAL mit asynchroner Konfiguration zu initialisieren.
• Plattformbroker(WAM)-Integration: Aktivieren Sie Windows Authentication Manager (WAM)-Brokerauthentifizierung über die allowPlatformBroker Konfigurationsoption.

Migrationshandbücher zu MSAL JavaScript v5.x finden Sie unter:

• MSAL Browser v4 zu v5-Migration
• MSAL Node v3 zu v5-Migration
• MSAL Angular v4 auf v5-Upgrade
• MSAL React-Migrationshandbuch

Bibliotheken im langfristigen Support (Long-Term Support, LTS)

Die folgende Tabelle zeigt die aktiven und LTS-Versionen für jede MSAL.js-Bibliothek:

Die LTS-Bibliotheken, die im msal-lts-Branch gehostet werden, werden nicht mehr aktiv weiterentwickelt, erhalten aber weiterhin Support für kritische Sicherheitskorrekturen.

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

Paketstruktur

Es gibt eine Reihe verschiedener Pakete, die für verschiedene Plattformen vorgesehen sind. Sie können die Beziehung zwischen Paketen und verschiedenen Authentifizierungsflüssen sehen, die sie in der folgenden Paketstruktur implementieren.

Beispiele

Die code samples zeigen die Verwendung der Microsoft-Authentifizierungsbibliotheken für JavaScript mit der Identitätsplattform. Jedes Codebeispiel enthält eine README.md Datei, die beschreibt, wie das Projekt erstellt wird (falls zutreffend), und die Beispielanwendung ausführen.

Eine vollständige Liste der Beispiele für JavaScript und andere Sprachen, Frameworks und Plattformen finden Sie in den Microsoft Identity Platform Codebeispielen.

Für systemeigene Authentifizierungsfeatures veranschaulichen die Beispiel-Apps , wie die systemeigene Authentifizierung in React- und Angular-Webanwendungen verwendet wird. Jedes Codebeispiel enthält eine README.md Datei, die beschreibt, wie das Projekt erstellt und die Beispielanwendung ausgeführt wird. Die aktuelle systemeigene Authentifizierungs-API unterstützt keine cross-Origin Resource Sharing (CORS), die Beispiel-App wird mit lokalem Proxy ausgeführt.

Paketversionsverwaltung

Alle unsere Bibliotheken folgen der semantischen Versionsverwaltung. Es wird empfohlen, die neueste Version jeder Bibliothek zu verwenden, um sicherzustellen, dass Sie über die neuesten Sicherheitspatches und Fehlerbehebungen verfügen.

Sicherheitsberichte

Wenn Sie ein Sicherheitsproblem mit unseren Bibliotheken oder Diensten finden, melden Sie es dem Microsoft Security Response Center (MSRC) mit möglichst vielen Details.