Upgraden van MSAL Angular v2 naar v3

MSAL Angular v3 brengt onze Angular wrapper up-to-date met de nieuwste versie van MSAL Browser en met kant-en-klare ondersteuning voor Angular 15, 16, 17, 18 en rxjs 7.

In deze handleiding worden wijzigingen gedemonstreerd die nodig zijn voor het migreren van een bestaande toepassing van @azure/msal-angular v2 naar v3.

Als u migreert van @azure/msal-angular v1, raadpleegt u eerst de v1-v2-migratiehandleiding om naar MSAL v2 te migreren.

Zie ook het MSAL Browser Migration Doc voor browserondersteuning en andere belangrijke wijzigingen.

Belangrijke wijzigingen in @azure/msal-angular@3

Initialisatie

Toepassingen die omleidingen gebruiken

MSAL v3.x vereist nu het initialiseren van het toepassingsobject. Initialisatie is ingebouwd in de MsalRedirectComponent- en handleRedirectObservable-API, en toepassingen die redirectstrategieën hebben geïmplementeerd, hoeven geen wijzigingen aan te brengen. Mogelijk moeten er aanvullende wijzigingen worden aangebracht als uw toepassing zelfstandige onderdelen gebruikt.

Zie de handleiding voor omleidingen voor meer informatie over het verwerken van omleidingen in uw toepassing.

Toepassingen die pop-ups gebruiken

Omdat de initialisatie is ingebouwd in MsalRedirectComponent en handleRedirectObservable, moeten applicaties die alleen pop-ups gebruiken ook óf de MsalRedirectComponent bootstrappen óf handleRedirectObservable eenmaal handmatig aanroepen om het applicatieobject te initialiseren.

Zie de handleiding voor omleidingen voor het instellen van details.

De allowNativeBroker vlag

De allowNativeBroker vlag is nu standaard ingeschakeld in de configuraties. Als u een B2C-instantie gebruikt, kunt u deze als volgt uitschakelen:

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

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

MSAL Angular verwacht nu dat uw toepassing is gebouwd met:

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

Vanwege deze wijziging is MSAL Angular v3 niet achterwaarts compatibel met eerdere versies van Angular en RxJS en moet u mogelijk uw toepassing bijwerken. Volg de Angular-updatehandleiding om uw toepassing bij te werken naar Angular 15, 16, 17 of 18.

Net als bij MSAL Angular v2 is rxjs-compat dit niet vereist.

Samples

De volgende voorbeelden voor ontwikkelaars zijn nu beschikbaar:

De voorbeelden demonstreren de basisconfiguratie en het gebruik en kunnen incrementeel worden verbeterd en toegevoegd.

Zie hier voor een lijst met de MSAL Angular v3-voorbeelden en de functies die zijn gedemonstreerd.