Atualizando do MSAL Angular v2 para v3

O MSAL Angular v3 atualiza nossa biblioteca de integração do Angular para a versão mais recente do MSAL Browser e oferece suporte imediato ao Angular 15, 16, 17, 18 e ao RxJS 7.

Este guia demonstrará as alterações necessárias para migrar um aplicativo existente da @azure/msal-angular v2 para a v3.

Se você estiver migrando do @azure/msal-angular v1, consulte primeiro o guia de migração da v1 para a v2 para migrar para o MSAL v2.

Consulte também o Documento de Migração do Navegador MSAL para obter suporte ao navegador e outras alterações importantes.

Alterações significativas em @azure/msal-angular@3

Inicialização

Aplicativos usando redirecionamentos

A MSAL v3.x agora requer a inicialização do objeto de aplicativo. A inicialização foi incorporada à MsalRedirectComponent API e handleRedirectObservable os aplicativos que implementaram estratégias de redirecionamento não precisam fazer alterações. Alterações adicionais podem precisar ser feitas se o aplicativo estiver usando componentes autônomos.

Consulte o guia para redirecionamentos para obter detalhes sobre como lidar com redirecionamentos em seu aplicativo.

Aplicativos usando pop-ups

Devido ao fato de a inicialização estar integrada a MsalRedirectComponent e handleRedirectObservable, as aplicações que usam apenas pop-ups também precisarão inicializar o MsalRedirectComponent ou chamar handleRedirectObservable manualmente uma vez, para inicializar o objeto da aplicação.

Consulte o guia para redirecionamentos para configurar detalhes.

O sinalizador allowNativeBroker

O allowNativeBroker sinalizador agora está ativado por padrão nas configurações. Se você estiver usando uma autoridade B2C, poderá desativá-la da seguinte maneira:

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

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

A MSAL Angular agora espera que seu aplicativo seja criado com:

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

Devido a essa alteração, o MSAL Angular v3 não é compatível com versões anteriores do Angular e RxJS e talvez seja necessário atualizar seu aplicativo. Siga o Guia de Atualização do Angular para atualizar sua aplicação para o Angular 15, 16, 17 ou 18.

Assim como acontece com o MSAL Angular v2, rxjs-compat não é necessário.

Exemplos

Os seguintes exemplos de desenvolvedor agora estão disponíveis:

• Exemplo do Angular 15
• Exemplo do Angular 16
• Exemplo do Angular 16 usando B2C
• Exemplo do Angular 16 usando componentes autônomos angulares
• Exemplo standalone do Angular 17
• Exemplo Standalone do Angular 18

Os exemplos demonstram a configuração e o uso básicos e podem ser aprimorados e adicionados de forma incremental.

Veja aqui uma lista dos exemplos do MSAL Angular v3 e os recursos demonstrados.