Migrera från MSAL Node v3 till v5

Note

Det finns ingen MSAL Node v4-version. Paketversionen höjdes från v3 direkt till v5 för att anpassa versionshanteringen för msal-node till de andra MSAL.js-biblioteken. Det finns ingen separat v4-funktionsuppsättning.

Minskat stöd för Node.js 16 och 18

MSAL Node v5 stöder inte längre Node.js 16 eller 18. du måste använda Node.js 20 eller senare.

Borttagen proxyUrl och customAgentOptions

MSAL Node v5 tillhandahåller inte längre valfri konfiguration för HTTP-klienten. Parametrarna proxyUrl och customAgentOptions har tagits bort från NodeSystemOptions.

// BEFORE (v3)
NodeSystemOptions = {
    loggerOptions?: LoggerOptions;
    networkClient?: INetworkModule;
    proxyUrl?: string;
    customAgentOptions?: http.AgentOptions | https.AgentOptions;
    disableInternalRetries?: boolean;
    protocolMode?: ProtocolMode;
};

// AFTER (v5)
NodeSystemOptions = {
    loggerOptions?: LoggerOptions;
    networkClient?: INetworkModule;
    disableInternalRetries?: boolean;
    protocolMode?: ProtocolMode;
};

Utvecklare måste nu skriva sin egen anpassade HTTP-klient när proxysupport behövs. Mer information finns i det anpassade INetworkModule-exemplet .

Konfigurationsändringar

protocolMode har flyttats till systemkonfiguration

Parametern protocolMode är inte längre ett autentiseringskonfigurationsalternativ och är i stället ett systemkonfigurationsalternativ.

// BEFORE (v3)
const msalConfig = {
    auth: {
        clientId: "your_client_id",
        authority: "https://login.live.com",
        protocolMode: "OIDC",
    },
};

// AFTER (v5)
const msalConfig = {
    auth: {
        clientId: "your_client_id",
        authority: "https://login.live.com",
    },
    system: {
        protocolMode: "OIDC",
    },
};

Andra borttagna parametrar

  • Parametern skipAuthorityMetadataCache har tagits bort. Applikationer använder inte längre den lokala metadatacachen vid auktoritetsinitiering.
  • Parametern encodeExtraQueryParams har tagits bort. Alla extra frågeparametrar kodas automatiskt.

fromNativeBroker har bytt namn till fromPlatformBroker

AuthenticationResult I -objektet har fältet fromNativeBroker bytt namn till fromPlatformBroker.