Upgrade von MSAL Angular v2 auf v3

MSAL Angular v3 bringt unseren Angular-Wrapper auf den neuesten Stand der aktuellen Version von MSAL Browser und bietet sofortige Unterstützung für Angular 15, 16, 17, 18 und RxJS 7.

In diesem Handbuch werden Änderungen veranschaulicht, die zum Migrieren einer vorhandenen Anwendung von @azure/msal-angular v2 zu v3 erforderlich sind.

Wenn Sie von @azure/msal-angular v1 migrieren, lesen Sie zuerst das v1-v2-Migrationshandbuch , um zu MSAL v2 zu migrieren.

Weitere Informationen finden Sie im MSAL-Browsermigrationsdokument für die Browserunterstützung und andere wichtige Änderungen.

Unterbrechen von Änderungen in @azure/msal-angular@3

Initialisierung

Anwendungen, die Umleitungen verwenden

MSAL v3.x erfordert jetzt die Initialisierung des Anwendungsobjekts. Die Initialisierung wurde in die MsalRedirectComponent- und handleRedirectObservable-API integriert, und Anwendungen, die Umleitungsstrategien implementiert haben, müssen keine Änderungen vornehmen. Möglicherweise müssen zusätzliche Änderungen vorgenommen werden, wenn Ihre Anwendung eigenständige Komponenten verwendet.

Ausführliche Informationen zum Umgang mit Umleitungen in Ihrer Anwendung finden Sie in der Anleitung.

Anwendungen mit Popups

Da die Initialisierung in MsalRedirectComponent und handleRedirectObservable integriert ist, müssen Anwendungen, die nur Popups verwenden, entweder das MsalRedirectComponent bootstrappen oder handleRedirectObservable einmal manuell aufrufen, um das Anwendungsobjekt zu initialisieren.

Einzelheiten zur Einrichtung finden Sie im Leitfaden zu Weiterleitungen.

Die allowNativeBroker Kennzeichnung

Das allowNativeBroker Flag ist jetzt standardmäßig in den Konfigurationen aktiviert. Wenn Sie eine B2C-Autorität verwenden, können Sie sie wie folgt deaktivieren:

export function MSALInstanceFactory(): IPublicClientApplication {
    return new PublicClientApplication({
        auth: {
            ...
        },
        cache: {
            ...
        },
        system: {
            allowNativeBroker: false, // Disables native brokering support
        }
    });
}

Angular 15, 16, 17, 18 und rxjs@7

MSAL Angular setzt jetzt voraus, dass Ihre Anwendung mit Folgendem erstellt wird:

• @angular/core@15 oder @angular/core@16 oder @angular/core@17 oder @angular/core@18
• @angular/common@15 oder @angular/common@16 oder @angular/common@17 oder @angular/common@18
• rxjs@7

Aufgrund dieser Änderung ist MSAL Angular v3 nicht abwärtskompatibel mit früheren Versionen von Angular und RxJS, und Möglicherweise müssen Sie Ihre Anwendung aktualisieren. Bitte folgen Sie dem Angular Update Guide , um Ihre Anwendung auf Angular 15, 16, 17 oder 18 zu aktualisieren.

Wie bei MSAL Angular v2 ist rxjs-compat nicht erforderlich.

Beispiele

Die folgenden Entwicklerbeispiele sind jetzt verfügbar:

• Angular 15-Beispiel
• Angular 16-Beispiel
• Angular 16-Beispiel mit B2C
• Angular 16-Beispiel mit eigenständigen Angular-Komponenten
• Eigenständiges Angular 17-Beispiel
• Eigenständiges Angular 18-Beispiel

Die Beispiele veranschaulichen die grundlegende Konfiguration und Verwendung und können inkrementell verbessert und hinzugefügt werden.

Hier finden Sie eine Liste der MSAL Angular v3-Beispiele und der gezeigten Features.