MSAL Angular v2에서 v3으로 업그레이드

MSAL Angular v3는 Angular용 래퍼를 최신 버전의 MSAL Browser에 맞춰 업데이트했으며, Angular 15, 16, 17, 18 및 rxjs 7을 기본적으로 지원합니다.

이 가이드에서는 기존 애플리케이션을 v2에서 @azure/msal-angular v3으로 마이그레이션하는 데 필요한 변경 내용을 보여 줍니다.

v1에서 @azure/msal-angular 마이그레이션하는 경우 먼저 v1-v2 마이그레이션 가이드 를 참조하여 MSAL v2로 마이그레이션하세요.

브라우저 지원 및 기타 주요 변경 내용은 MSAL 브라우저 마이그레이션 문서 도 참조하세요.

주요 변경 내용 @azure/msal-angular@3

초기화

리디렉션을 사용하는 애플리케이션

이제 MSAL v3.x에서 애플리케이션 개체를 초기화해야 합니다. 초기화는 MsalRedirectComponent 및 handleRedirectObservable API에 내장되었으므로, 리디렉션 전략을 구현한 애플리케이션은 변경할 필요가 없습니다. 애플리케이션이 독립 실행형 구성 요소를 사용하는 경우 추가 변경이 필요할 수 있습니다.

애플리케이션에서 리디렉션 처리에 대한 자세한 내용은 리디렉션 가이드 를 참조하세요.

팝업을 사용하는 애플리케이션

초기화가 MsalRedirectComponent 및 handleRedirectObservable에 내장되어 있으므로, 팝업만 사용하는 애플리케이션도 애플리케이션 객체를 초기화하기 위해 MsalRedirectComponent를 부트스트랩하거나 handleRedirectObservable를 수동으로 한 번 호출해야 합니다.

설정 세부 정보는 리디렉션 가이드 를 참조하세요.

allowNativeBroker 플래그

allowNativeBroker 이제 구성에서 플래그가 기본적으로 켜져 있습니다. B2C 권한 부여 기관을 사용하는 경우 다음과 같이 사용 안 함으로 설정할 수 있습니다.

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

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

MSAL Angular는 이제 애플리케이션이 다음과 같이 빌드된 것으로 예상합니다:

  • @angular/core@15, @angular/core@16, @angular/core@17 또는 @angular/core@18
  • @angular/common@15, @angular/common@16, @angular/common@17 또는 @angular/common@18
  • rxjs@7

이 변경으로 인해 MSAL Angular v3는 이전 버전의 Angular 및 RxJS와 호환되지 않으며 애플리케이션을 업데이트해야 할 수 있습니다. Angular 업데이트 가이드에 따라 애플리케이션을 Angular 15, 16, 17 또는 18로 업데이트하세요.

MSAL Angular v2 rxjs-compat 와 마찬가지로 필요하지 않습니다.

샘플

이제 다음 개발자 샘플을 사용할 수 있습니다.

샘플은 기본 구성 및 사용량을 보여 줍니다. 개선되어 증분 방식으로 추가될 수 있습니다.

MSAL Angular v3 샘플 및 설명된 기능 목록은 여기 를 참조하세요.

  • 에 마지막으로 업데이트됨