Migrieren von JavaScript-Single-Page-Webanwendungen vom impliziten Genehmigungsflow zum Autorisierungscodeflow

Die Microsoft Authentication Library für JavaScript (MSAL.js) v2.0 unterstützt den Autorisierungscodefluss mit PKCE und CORS für Single-Page-Anwendungen auf der Microsoft Identity Platform. Führen Sie die Schritte in den folgenden Abschnitten aus, um Ihre MSAL.js 1.x-Anwendung, die den impliziten Grant verwendet, zu MSAL.js 2.0+ (nachfolgend 2.x) und zum Autorisierungscodefluss mit PKCE zu migrieren.

MSAL.js 2.x verbessert MSAL.js 1.x, indem der Autorisierungscodefluss im Browser anstelle des impliziten Genehmigungsflusses unterstützt wird. MSAL.js 2.x unterstützt nicht den impliziten Fluss.

Schritte bei der Migration

Um Ihre Anwendung auf MSAL.js 2.x und den Authentifizierungscodefluss zu aktualisieren, gibt es drei primäre Schritte:

  1. Ändern Sie die Umleitungs-URI(s) Ihrer App-Registrierung von der Web-Plattform zur Single-Page-Anwendungs-Plattform.
  2. Aktualisieren Sie Ihren Code von MSAL.js 1.x auf 2.x.
  3. Deaktivieren Sie die implizite Genehmigung in Ihrer App-Registrierung, wenn alle Anwendungen, die die Registrierung gemeinsam nutzen, auf MSAL.js 2.x und den Autorisierungscodeflow mit PKCE aktualisiert wurden.

In den folgenden Abschnitten werden die einzelnen Schritte ausführlicher beschrieben.

Wechseln der Umleitungs-URIs auf die SPA-Plattform

Tip

Die Schritte in diesem Artikel können je nach Dem Portal, von dem Sie beginnen, geringfügig variieren.

Wenn Sie ihre vorhandene App-Registrierung für Ihre Anwendungen weiterhin verwenden möchten, verwenden Sie die Microsoft Entra Admin Center, um die Umleitungs-URIs der Registrierung auf die SPA-Plattform zu aktualisieren. Dadurch wird der Autorisierungscodefluss mit PKCE- und CORS-Unterstützung für Apps aktiviert, die die Registrierung verwenden (Sie müssen den Code Ihrer Anwendung weiterhin auf MSAL.js v2.x aktualisieren).

Führen Sie die folgenden Schritte für App-Registrierungen aus, die derzeit mit Webplattformumleitungs-URIs konfiguriert sind:

  1. Melden Sie sich beim Microsoft Entra Admin Center an.

  2. Navigieren Sie zu Identity>Applications>App-Registrierungen, wählen Sie Ihre Anwendung und dann Authentifizierung aus.

  3. Wählen Sie in der Webplattformkachel unter Umleitungs-URIs das Warnbanner aus, das angibt, dass Sie Ihre URIs migrieren sollten.

  4. Wählen Sie nur die Umleitungs-URIs aus, deren Anwendungen MSAL.js 2.x verwenden, und wählen Sie dann "Konfigurieren" aus.

Diese Umleitungs-URIs sollten nun auf der Kachel der Plattform für die Einzelseitenanwendung angezeigt werden und zeigen, dass CORS-Unterstützung mit dem Autorisierungscodefluss und PKCE für diese URIs aktiviert ist.

Sie können auch eine neue App-Registrierung erstellen , anstatt die Umleitungs-URIs in Ihrer vorhandenen Registrierung zu aktualisieren.

Aktualisieren des Codes auf MSAL.js 2.x

In MSAL 1.x haben Sie eine Anwendungsinstanz erstellt, indem Sie eine UserAgentApplication wie folgt initialisieren:

// MSAL 1.x
import * as msal from "msal";

const msalInstance = new msal.UserAgentApplication(config);

Initialisieren Sie in MSAL 2.x stattdessen ein [PublicClientApplication][msal-js-publicclientapplication]:

// MSAL 2.x
import * as msal from "@azure/msal-browser";

const msalInstance = new msal.PublicClientApplication(config);

Eine vollständige exemplarische Vorgehensweise zum Hinzufügen von MSAL 2.x zu Ihrer Anwendung finden Sie im Lernprogramm: Anmelden von Benutzern und Aufrufen der Microsoft Graph-API aus einer JavaScript-Einzelseiten-App (SPA) mithilfe des Authentifizierungscodeflusses.

Weitere Änderungen, die Sie möglicherweise an Ihrem Code vornehmen müssen, finden Sie im Migrationshandbuch zu GitHub.

Einstellungen für den Implicit Grant deaktivieren

Nachdem Sie alle Produktionsanwendungen, die diese App-Registrierung und ihre Client-ID verwenden, auf MSAL 2.x und den Autorisierungscodefluss aktualisiert haben, sollten Sie die Einstellungen für die implizite Genehmigung unter dem Menü Authentication der App-Registrierung deaktivieren.

Wenn Sie die Einstellungen für die implizite Genehmigung in der App-Registrierung deaktivieren, wird der implizite Genehmigungsflow für alle Anwendungen, die die Registrierung verwenden, und die zugehörige Client-ID deaktiviert.

Deaktivieren Sie den impliziten Genehmigungsfluss nicht, bevor Sie alle Ihre Anwendungen auf MSAL.js 2.x und die [PublicClientApplication][msal-js-publicclientapplication] aktualisiert haben.

Nächste Schritte

Weitere Informationen zum Autorisierungscodefluss, einschließlich der Unterschiede zwischen impliziten und Authentifizierungscodeflüssen, finden Sie im Microsoft Identity Platform- und OAuth 2.0-Autorisierungscodefluss.

Wenn Sie tiefer in die Entwicklung von JavaScript-Single-Page-Anwendungen auf der Microsoft Identity Platform eintauchen möchten, kann Ihnen die mehrteilige Artikelreihe Szenario: Single-Page-Anwendung den Einstieg erleichtern.