Upgrade z MSAL Angular v2 na v3

MSAL Angular v3 aktualizuje náš obal pro Angular na nejnovější verzi MSAL Browser a přináší také podporu pro Angular 15, 16, 17, 18 a RxJS 7 ihned po instalaci.

Tato příručka předvede změny potřebné k migraci existující aplikace z @azure/msal-angular verze 2 na verzi 3.

Pokud migrujete z @azure/msal-angular verze 1, nejprve si projděte průvodce migrací v1-v2 a proveďte migraci na MSAL v2.

Informace o podpoře prohlížeče a dalších klíčových změnách najdete také v dokumentu migrace prohlížeče MSAL .

Zásadní změny v @azure/msal-angular@3

Inicializace

Aplikace využívající přesměrování

MSAL v3.x nyní vyžaduje inicializaci objektu aplikace. Inicializace byla integrována do rozhraní API MsalRedirectComponent a handleRedirectObservable a aplikace, které implementovaly strategie přesměrování, nemusí provádět žádné změny. Pokud vaše aplikace používá samostatné komponenty, může být potřeba provést další změny.

Podrobnosti o zpracování přesměrování ve vaší aplikaci najdete v průvodci přesměrováním.

Aplikace používající automaticky otevírané okno

Vzhledem k tomu, že je inicializace integrována do MsalRedirectComponent a handleRedirectObservable, budou aplikace, které používají pouze vyskakovací okna, muset buď spustit MsalRedirectComponent, nebo jednou ručně zavolat handleRedirectObservable, aby se inicializoval objekt aplikace.

Podrobnosti o nastavení najdete v průvodci přesměrováním .

Příznak allowNativeBroker

Příznak allowNativeBroker je teď ve výchozím nastavení v konfiguracích zapnutý. Pokud používáte autoritu B2C, můžete ji vypnout následujícím způsobem:

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

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

MSAL Angular teď očekává, že vaše aplikace je sestavená pomocí:

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

Kvůli této změně msAL Angular v3 není zpětně kompatibilní se staršími verzemi Angular a RxJS a možná budete muset aktualizovat aplikaci. Postupujte podle Průvodce aktualizací Angular a aktualizujte aplikaci na Angular 15, 16, 17 nebo 18.

Stejně jako u MSAL Angular v2 rxjs-compat se nevyžaduje.

Ukázky

Nyní jsou k dispozici následující ukázky pro vývojáře:

• Angular 15 sample
• Angular 16 sample
• Ukázka Angular 16 s využitím B2C
• Ukázka Angular 16 pomocí samostatných komponent Angular
• Angular 17 – samostatná ukázka
• Angular 18 Standalone Sample

Ukázky demonstrují základní konfiguraci a využití a mohou být vylepšeny a přidány postupně.

Seznam ukázek MSAL Angular v3 a předvedených funkcí najdete zde.