Partilhar via

Migrar um aplicativo JavaScript de página única de concessão implícita para fluxo de código de autenticação

A Biblioteca de Autenticação da Microsoft para JavaScript (MSAL.js) v2.0 traz suporte para o fluxo de código de autorização com PKCE e CORS para aplicativos de página única na plataforma de identidade da Microsoft. Siga as etapas nas seções abaixo para migrar seu aplicativo MSAL.js 1.x usando a concessão implícita para MSAL.js 2.0+ (doravante 2.x) e o fluxo de código de autenticação.

MSAL.js 2.x melhora o MSAL.js 1.x suportando o fluxo de código de autorização no navegador em vez do fluxo de concessão implícito. MSAL.js 2.x NÃO suporta o fluxo implícito.

Realizar os passos de migração

Para atualizar seu aplicativo para o MSAL.js 2.x e o fluxo de código de autenticação, há três etapas principais:

  1. Altere o(s) URI(s) de redirecionamento do registo de aplicação da plataforma Web para a plataforma aplicação de página única.
  2. Atualize seu código de MSAL.js 1.x para 2.x.
  3. Desative a concessão implícita no registro do seu aplicativo quando todos os aplicativos que compartilham o registro tiverem sido atualizados para MSAL.js 2.x e o fluxo de código de autenticação.

As seções a seguir descrevem cada etapa com detalhes adicionais.

Mudar URIs de redirecionamento para a plataforma SPA

Se você quiser continuar usando seu registro de aplicativo existente para seus aplicativos, use o centro de administração do Microsoft Entra para atualizar os URIs de redirecionamento do registro para a plataforma SPA. Ao fazê-lo, ativa o fluxo de código de autorização com suporte a PKCE e CORS para aplicações que utilizam o registo (ainda necessita de atualizar o código da sua aplicação para o MSAL.js v2.x).

Siga estas etapas para registos de aplicativos que estão atualmente configurados com URIs de redirecionamento da plataforma Web:

  1. Entre no centro de administração do Microsoft Entra.

  2. Navegue atéRegistros do >, selecione seu aplicativo e, em seguida, Autenticação.

  3. No bloco Plataforma Web , em Redirecionar URIs, selecione o banner de aviso indicando que você deve migrar seus URIs.

    Banner de aviso de fluxo implícito no bloco do aplicativo Web no centro de administração do Entra.

  4. Selecione apenas os URIs de redirecionamento cujos aplicativos usarão o MSAL.js 2.x e, em seguida, selecione Configurar.

    Selecione o painel URI de redirecionamento no painel SPA no centro de administração do Entra.

Esses URIs de redirecionamento agora devem aparecer no bloco Plataforma de aplicativo de página única , mostrando que o suporte a CORS com o fluxo de código de autorização e PKCE está habilitado para esses URIs.

Seção de aplicação de página única no registo de aplicações no portal do Azure

Atualize seu código para MSAL.js 2.x

No MSAL 1.x, você criou uma instância de aplicativo inicializando um UserAgentApplication da seguinte maneira:

// MSAL 1.x
import * as msal from "msal";

const msalInstance = new msal.UserAgentApplication(config);

No MSAL 2.x, inicialize em vez disso um [PublicClientApplication][msal-js-publicclientapplication]:

// MSAL 2.x
import * as msal from "@azure/msal-browser";

const msalInstance = new msal.PublicClientApplication(config);

Para alterações adicionais que você pode precisar fazer em seu código, consulte o guia de migração no GitHub.

Desativar configurações de concessão implícitas

Depois de atualizar todas as suas aplicações de produção que usam esse registro de aplicação e seu ID de cliente para o MSAL 2.x e o fluxo de autorização por código, você deve desselecionar as configurações de concessão implícitas no menu Autenticação do registro da aplicação.

Quando você desmarca as configurações de concessão implícita no registro do aplicativo, o fluxo implícito é desativado para todos os aplicativos que usam o registro e sua ID de cliente.

Não desative o fluxo de concessão implícito antes de atualizar todos os seus aplicativos para o MSAL.js 2.x e o [PublicClientApplication][msal-js-publicclientapplication].

Próximos passos

  • Last updated on