Frissítés MSAL Angular v2-ről v3-ra

Az MSAL Angular v3 naprakésszé teszi az Angularhoz készült burkolókönyvtárunkat az MSAL Browser legújabb verziójával, valamint beépített támogatást nyújt az Angular 15, 16, 17, 18 és az rxjs 7 számára.

Ez az útmutató bemutatja a meglévő alkalmazások v2-ről @azure/msal-angular v3-ra való migrálásához szükséges módosításokat.

Ha az 1. v1-ről @azure/msal-angular migrál, először tekintse meg a v1-v2 migrálási útmutatót , amely az MSAL v2-re való migrálást ismerteti.

Tekintse meg az MSAL böngésző migrálási dokumentumát is a böngésző támogatásához és egyéb kulcsmódosításokhoz.

Kompatibilitástörő változások a következőben: @azure/msal-angular@3

Inicializálás

Átirányításokat használó alkalmazások

Az MSAL v3.x használatához most inicializálni kell az alkalmazásobjektumot. Az inicializálást beépítették a MsalRedirectComponent és handleRedirectObservable API-ba, és az átirányítási stratégiát megvalósító alkalmazásoknak nem kell módosításokat végezniük. Előfordulhat, hogy további módosításokat kell végrehajtania, ha az alkalmazás különálló összetevőket használ.

Az átirányítások alkalmazáson belüli kezelésével kapcsolatos részletekért tekintse meg az átirányításokat ismertető útmutatót .

Előugró ablakokat használó alkalmazások

Mivel az inicializálás be van építve a MsalRedirectComponent és a handleRedirectObservable elembe, a kizárólag előugró ablakokat használó alkalmazásoknak is vagy el kell indítaniuk a MsalRedirectComponent-t, vagy egyszer manuálisan meg kell hívniuk a handleRedirectObservable-at az alkalmazásobjektum inicializálásához.

A beállítás részleteiért tekintse meg az átirányításokat ismertető útmutatót .

A allowNativeBroker jelölő

A allowNativeBroker jelölő alapértelmezés szerint be van kapcsolva a konfigurációkban. Ha B2C hitelesítési szolgáltatót használ, az alábbi módon kikapcsolhatja:

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

Angular 15, 16, 17, 18 és rxjs@7

Az MSAL Angular mostantól arra számít, hogy az alkalmazás a következőkkel lett felépítve:

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

A módosítás miatt az MSAL Angular v3 nem kompatibilis az Angular és az RxJS korábbi verzióival, ezért előfordulhat, hogy frissítenie kell az alkalmazást. Kövesse az Angular frissítési útmutatóját az alkalmazás Angular 15, 16, 17 vagy 18 verziójára való frissítéséhez.

Az MSAL Angular v2-hez rxjs-compat hasonlóan nem szükséges.

Samples

A következő fejlesztői minták érhetők el:

• Angular 15 példa
• Angular 16 minta
• Angular 16-os példa B2C-t használva
• Angular 16-os mintaprojekt Angular önálló összetevőket használva
• Angular 17 Standalone példa
• Angular 18 független példa

A minták alapszintű konfigurációt és használatot mutatnak be, és fejleszthetők és növekményesen bővíthetők.

Az MSAL Angular v3-minták és a bemutatott funkciók listáját itt találja.