Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
MSAL Angular v3 met à jour notre wrapper Angular avec la dernière version de MSAL Browser et offre une prise en charge prête à l'emploi d'Angular 15, 16, 17, 18 et rxjs 7.
Ce guide montre les modifications nécessaires pour migrer une application existante de @azure/msal-angular v2 vers v3.
Si vous effectuez une migration à partir de @azure/msal-angular v1, reportez-vous au guide de migration v1-v2 pour migrer vers MSAL v2.
Consultez également la documentation de migration du navigateur MSAL pour la prise en charge du navigateur et d’autres modifications clés.
Modifications radicales dans @azure/msal-angular@3
Initialisation
Applications utilisant des redirections
MSAL v3.x nécessite désormais l’initialisation de l’objet d’application. L’initialisation a été intégrée dans MsalRedirectComponent et l’API handleRedirectObservable, et les applications qui ont implémenté des stratégies de redirection n’ont pas à apporter de modifications. Des modifications supplémentaires peuvent être apportées si votre application utilise des composants autonomes.
Consultez le guide de redirection pour plus d’informations sur la gestion des redirections dans votre application.
Applications utilisant des fenêtres contextuelles
L’initialisation étant intégrée à MsalRedirectComponent et à handleRedirectObservable, les applications qui utilisent uniquement des fenêtres popup devront également soit initialiser le MsalRedirectComponent, soit appeler manuellement handleRedirectObservable une fois afin d’initialiser l’objet application.
Pour plus d’informations, consultez le guide de redirection .
Indicateur allowNativeBroker
L’indicateur allowNativeBroker est maintenant activé par défaut dans les configurations. Si vous utilisez une autorité B2C, vous pouvez la désactiver comme suit :
export function MSALInstanceFactory(): IPublicClientApplication {
return new PublicClientApplication({
auth: {
...
},
cache: {
...
},
system: {
allowNativeBroker: false, // Disables native brokering support
}
});
}
Angular 15, 16, 17, 18 et rxjs@7
MSAL Angular s’attend maintenant à ce que votre application soit générée avec :
-
@angular/core@15ou@angular/core@16ou@angular/core@17ou@angular/core@18 -
@angular/common@15ou@angular/common@16ou@angular/common@17ou@angular/common@18 rxjs@7
En raison de cette modification, MSAL Angular v3 n’est pas compatible avec les versions antérieures d’Angular et RxJS et vous devrez peut-être mettre à jour votre application. Suivez le Guide de mise à jour Angular pour mettre à jour votre application vers Angular 15, 16, 17 ou 18.
Comme avec MSAL Angular v2, rxjs-compat n’est pas obligatoire.
Échantillons
Les exemples de développeurs suivants sont désormais disponibles :
- Exemple Angular 15
- Exemple Angular 16
- Exemple Angular 16 utilisant B2C
- Exemple Angular 16 utilisant des composants autonomes Angular
- Exemple autonome Angular 17
- Exemple autonome Angular 18
Les exemples illustrent la configuration et l’utilisation de base, et peuvent être améliorés et ajoutés de manière incrémentielle.
Consultez ici pour obtenir la liste des exemples MSAL Angular v3 et des fonctionnalités illustrées.