MSAL Angular v3 brings our Angular wrapper up-to-date with the latest version of MSAL Browser, and with out-of-the-box support for Angular 15, 16, 17, 18 and rxjs 7.
This guide will demonstrate changes needed to migrate an existing application from @azure/msal-angular v2 to v3.
If you are migrating from @azure/msal-angular v1, please refer to the v1-v2 migration guide first to migrate to MSAL v2.
Please also see the MSAL Browser Migration Doc for browser support and other key changes.
MSAL v3.x now requires initializing the application object. Initialization has been built into the MsalRedirectComponent and handleRedirectObservable API, and applications that have implemented redirect strategies do not have to make changes. Additional changes may need to be made if your application is using standalone components.
See the guide to redirects for details on handling redirects in your application.
Due to initialization being built into MsalRedirectComponent and handleRedirectObservable, applications that only use popups will also have to either bootstrap the MsalRedirectComponent or call handleRedirectObservable manually once to initialize the application object.
See the guide to redirects for set up details.
MSAL Angular now expects that your application is built with:
@angular/core@15or@angular/core@16or@angular/core@17or@angular/core@18@angular/common@15or@angular/common@16or@angular/common@17or@angular/common@18rxjs@7
Due to this change, MSAL Angular v3 is not backwards compatible with earlier versions of Angular and RxJS and you may need to update your application. Please follow the Angular Update Guide to update your application to Angular 15, 16, 17 or 18.
As with MSAL Angular v2, rxjs-compat is not required.
The following developer samples are now available:
- Angular 15 sample
- Angular 16 sample
- Angular 16 sample using B2C
- Angular 16 sample using Angular standalone components
- Angular 17 Standalone Sample
- Angular 18 Standalone Sample
The samples demonstrates basic configuration and usage, and may be improved and added to incrementally.
See here for a list of the MSAL Angular v3 samples and the features demonstrated.