Migrera en JavaScript-ensidesapp från implicit beviljande till autentiseringskodflöde

Microsoft-autentiseringsbibliotek för JavaScript (MSAL.js) v2.0 ger stöd för auktoriseringskodflödet med PKCE och CORS till ensidesprogram på Microsofts identitetsplattform. Följ stegen i avsnitten nedan för att migrera ditt MSAL.js 1.x-program med hjälp av implicit beviljande till MSAL.js 2.0+ (nedan 2.x) och auktoriseringskodflödet med PKCE.

MSAL.js 2.x förbättrar MSAL.js 1.x genom att stödja auktoriseringskodflödet i webbläsaren i stället för det implicita beviljandeflödet. MSAL.js 2.x stöder INTE implicit flöde.

Migreringssteg

Det finns tre primära steg för att uppdatera programmet till MSAL.js 2.x och autentiseringskodflödet:

  1. Ändra omdirigerings-URI:erna för din appregistrering från plattformen Web till plattformen Single-page application.
  2. Uppdatera koden från MSAL.js 1.x till 2.x.
  3. Inaktivera implicit beviljande i din appregistrering när alla program som delar registreringen har uppdaterats till MSAL.js 2.x och autentiseringskodflödet med PKCE.

I följande avsnitt beskrivs varje steg i detalj.

Byt omdirigerings-URI:er till plattformen SPA

Tip

Stegen i den här artikeln kan variera något beroende på vilken portal du börjar från.

Om du vill fortsätta använda din befintliga appregistrering för dina program använder du Microsoft Entra administrationscenter för att uppdatera registreringens omdirigerings-URI:er till SPA-plattformen. Om du gör det aktiveras auktoriseringskodflödet med PKCE- och CORS-stöd för appar som använder registreringen (du behöver fortfarande uppdatera programmets kod till MSAL.js v2.x).

Följ dessa steg för appregistreringar som för närvarande är konfigurerade med omdirigerings-URI:er för webbplattform :

  1. Logga in på Microsoft Entra administrationscenter.

  2. Bläddra till Identitetsprogram>>App registrations, välj ditt program och sedan Autentisering.

  3. I panelen Webbplattform under Omdirigerings-URI:er väljer du varningsbanderollen som anger att du ska migrera dina URI:er.

  4. Välj endast de omdirigerings-URI:er vars program ska använda MSAL.js 2.x och välj sedan Konfigurera.

Dessa omdirigerings-URI:er bör nu visas i panelen Plattform för enkelsidiga program , som visar att CORS-stöd med auktoriseringskodflödet och PKCE är aktiverat för dessa URI:er.

Du kan också skapa en ny appregistrering i stället för att uppdatera omdirigerings-URI:erna i din befintliga registrering.

Uppdatera koden till MSAL.js 2.x

I MSAL 1.x skapade du en programinstans genom att initiera en UserAgentApplication på följande sätt:

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

const msalInstance = new msal.UserAgentApplication(config);

I MSAL 2.x initierar du i stället [PublicClientApplication][msal-js-publicclientapplication]:

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

const msalInstance = new msal.PublicClientApplication(config);

En fullständig genomgång av hur du lägger till MSAL 2.x i ditt program finns i Självstudie: Logga in användare och anropa Microsoft Graph API från en JavaScript-ensidesapp (SPA) med hjälp av autentiseringskodflöde.

Ytterligare ändringar som du kan behöva göra i koden finns i migreringsguiden för GitHub.

Inaktivera inställningarna för implicit grant

När du har uppdaterat alla dina produktionsprogram som använder den här appregistreringen och dess klient-ID till MSAL 2.x och auktoriseringskodflödet bör du avmarkera de implicita inställningarna för beviljande under autentiseringsmenyn i appregistreringen.

När du avmarkerar inställningarna för implicit beviljande i appregistreringen inaktiveras det implicita flödet för alla program som använder registrering och dess klient-ID.

Inaktivera inte det implicita beviljandeflödet innan du har uppdaterat alla dina program till MSAL.js 2.x och [PublicClientApplication][msal-js-publicclientapplication].

Nästa steg

Mer information om auktoriseringskodflödet, inklusive skillnaderna mellan implicita kodflöden och autentiseringskodflöden, finns i auktoriseringskodflödet Microsofts identitetsplattform och OAuth 2.0.

Om du vill fördjupa dig i utveckling av enkelsidesprogram i JavaScript på Microsofts identitetsplattform kan artikelserien i flera delar Scenario: enkelsidesprogram hjälpa dig att komma igång.