MSAL Angular v2'den v3'e yükseltme

MSAL Angular v3, Angular için sarmalayıcımızı MSAL Browser’ın en son sürümüyle güncel hale getirir ve Angular 15, 16, 17, 18 ile rxjs 7 için yerleşik destek sunar.

Bu kılavuz, mevcut bir uygulamayı v2'den @azure/msal-angular v3'e geçirmek için gereken değişiklikleri gösterir.

v1'den @azure/msal-angular geçiş gerçekleştiriyorsanız, MSAL v2'ye geçiş yapmak için önce v1-v2 geçiş kılavuzuna bakın.

Tarayıcı desteği ve diğer önemli değişiklikler için lütfen MSAL Browser Geçiş Belgesi'ne de bakın.

Değişikliklerde uyum sorunları @azure/msal-angular@3

Başlatma İşlemi

Yeniden yönlendirme kullanan uygulamalar

MSAL v3.x artık uygulama nesnesini başlatmayı gerektiriyor. Başlatma, MsalRedirectComponent ve handleRedirectObservable API'sine yerleşik olarak eklenmiştir ve yeniden yönlendirme stratejileri uygulamış olan uygulamaların değişiklik yapması gerekmez. Uygulamanız tek başına bileşenler kullanıyorsa ek değişiklikler yapılması gerekebilir.

Uygulamanızdaki yeniden yönlendirmeleri işleme hakkında ayrıntılı bilgi için yeniden yönlendirme kılavuzuna bakın.

Açılan pencereleri kullanan uygulamalar

Başlatmanın MsalRedirectComponent ve handleRedirectObservable içine yerleşik olması nedeniyle, yalnızca açılır pencereleri kullanan uygulamaların da uygulama nesnesini başlatmak için ya MsalRedirectComponent önyüklemesini gerçekleştirmeleri ya da handleRedirectObservable işlevini bir kez elle çağırmaları gerekir.

Ayarlama ayrıntıları için yeniden yönlendirme kılavuzuna bakın.

allowNativeBroker bayrağı

Bayrak allowNativeBroker artık yapılandırmalarda varsayılan olarak açıktır. Bir B2C otoritesi kullanıyorsanız bunu şu şekilde kapatabilirsiniz:

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

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

MSAL Angular artık uygulamanızın aşağıdakiler kullanılarak oluşturulmasını gerektiriyor:

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

Bu değişiklik nedeniyle MSAL Angular v3, Angular ve RxJS'nin önceki sürümleriyle geriye dönük olarak uyumlu değildir ve uygulamanızı güncelleştirmeniz gerekebilir. Uygulamanızı Angular 15, 16, 17 veya 18'e güncelleştirmek için lütfen Angular Güncelleştirme Kılavuzu'nu izleyin.

MSAL Angular v2'de olduğu gibi, rxjs-compat gerekli değildir.

Samples

Aşağıdaki geliştirici örnekleri artık kullanılabilir:

Örnekler temel yapılandırmayı ve kullanımı gösterir ve artımlı olarak geliştirilip eklenebilir.

MSAL Angular v3 örneklerinin ve sunulan özelliklerin listesi için buraya bakın.

  • Last updated on