Actualización de MSAL Angular v2 a v3

MSAL Angular v3 actualiza nuestro contenedor para Angular con la versión más reciente de MSAL Browser y con compatibilidad inmediata con Angular 15, 16, 17, 18 y RxJS 7.

En esta guía se muestran los cambios necesarios para migrar una aplicación existente de @azure/msal-angular v2 a v3.

Si va a migrar de @azure/msal-angular v1, consulte primero la guía de migración de v1 a v2 para migrar a MSAL v2.

Consulte también la documentación de migración del explorador MSAL para obtener compatibilidad con el explorador y otros cambios clave.

Cambios importantes en @azure/msal-angular@3

Inicialización

Aplicaciones que usan redirecciones

MSAL v3.x ahora requiere inicializar el objeto de aplicación. La inicialización se ha integrado en la MsalRedirectComponent API y handleRedirectObservable , y las aplicaciones que han implementado estrategias de redireccionamiento no tienen que realizar cambios. Es posible que sea necesario realizar cambios adicionales si la aplicación usa componentes independientes.

Consulte la guía para redireccionamientos para más información sobre el control de redirecciones en la aplicación.

Aplicaciones que usan ventanas emergentes

Debido a que la inicialización está integrada en MsalRedirectComponent y handleRedirectObservable, las aplicaciones que solo usan ventanas emergentes también tendrán que o bien inicializar MsalRedirectComponent o llamar manualmente a handleRedirectObservable una vez para inicializar el objeto de la aplicación.

Consulte la guía sobre redireccionamientos para obtener detalles sobre la configuración.

El indicador allowNativeBroker

La allowNativeBroker marca ahora está activada de forma predeterminada en las configuraciones. Si está usando una autoridad B2C, puede desactivarla de la siguiente manera:

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

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

MSAL Angular ahora requiere que la aplicación esté compilada con:

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

Debido a este cambio, MSAL Angular v3 no es compatible con versiones anteriores de Angular y RxJS y es posible que tenga que actualizar la aplicación. Siga la Guía de actualización de Angular para actualizar la aplicación a Angular 15, 16, 17 o 18.

Al igual que con MSAL Angular v2, rxjs-compat no es necesario.

Samples

Ahora están disponibles los siguientes ejemplos para desarrolladores:

• Ejemplo de Angular 15
• Ejemplo de Angular 16
• Ejemplo de Angular 16 con B2C
• Ejemplo de Angular 16 mediante componentes independientes de Angular
• Ejemplo independiente de Angular 17
• Ejemplo independiente de Angular 18

Los ejemplos muestran la configuración y el uso básicos, y se pueden mejorar y agregar a incrementalmente.

Consulte aquí una lista de los ejemplos de MSAL Angular v3 y las características que se muestran.