Meningkatkan dari MSAL Angular v2 ke v3

MSAL Angular v3 menjadikan wrapper Angular kami selaras dengan versi terbaru MSAL Browser, serta menghadirkan dukungan siap pakai untuk Angular 15, 16, 17, 18, dan RxJS 7.

Panduan ini akan menunjukkan perubahan yang diperlukan untuk memigrasikan aplikasi yang ada dari @azure/msal-angular v2 ke v3.

Jika Anda bermigrasi dari @azure/msal-angular v1, silakan lihat panduan migrasi v1-v2 terlebih dahulu untuk bermigrasi ke MSAL v2.

Lihat juga Dokumen Migrasi Browser MSAL untuk dukungan browser dan perubahan kunci lainnya.

Memutus perubahan dalam @azure/msal-angular@3

Inisialisasi

Aplikasi yang menggunakan pengalihan

MSAL v3.x sekarang memerlukan inisialisasi objek aplikasi. Inisialisasi telah terintegrasi ke dalam API MsalRedirectComponent dan handleRedirectObservable, dan aplikasi yang telah menerapkan strategi pengalihan tidak perlu melakukan perubahan. Perubahan tambahan mungkin perlu dilakukan jika aplikasi Anda menggunakan komponen mandiri.

Lihat panduan untuk mengalihkan detail tentang penanganan pengalihan di aplikasi Anda.

Aplikasi yang menggunakan popup

Karena inisialisasi yang dibangun ke dalam MsalRedirectComponent dan handleRedirectObservable, aplikasi yang hanya menggunakan popup juga harus bootstrap MsalRedirectComponent atau panggil handleRedirectObservable secara manual sekali untuk menginisialisasi objek aplikasi.

Lihat panduan tentang pengalihan untuk detail penyiapan.

Bendera allowNativeBroker

Bendera allowNativeBroker sekarang diaktifkan secara default dalam konfigurasi. Jika Anda menggunakan otoritas B2C, Anda dapat menonaktifkannya sebagai berikut:

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

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

MSAL Angular sekarang mengharapkan bahwa aplikasi Anda dibangun dengan:

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

Karena perubahan ini, MSAL Angular v3 tidak kompatibel dengan versi Angular dan RxJS yang lebih lama dan Anda mungkin perlu memperbarui aplikasi Anda. Ikuti Panduan Pembaruan Sudut untuk memperbarui aplikasi Anda ke Angular 15, 16, 17, atau 18.

Seperti halnya MSAL Angular v2, rxjs-compat tidak diperlukan.

Sampel

Sampel pengembang berikut sekarang tersedia:

Sampel menunjukkan konfigurasi dan penggunaan dasar, dan dapat ditingkatkan dan ditambahkan ke secara bertahap.

Lihat di sini untuk daftar sampel MSAL Angular v3 dan fitur yang ditunjukkan.

  • Last updated on