Migrieren von MSAL Node v3 zu v5

Note

Es gibt keine MSAL Node v4-Version. Die Paketversion wurde direkt von v3 auf v5 erhöht, um die msal-node Versionierung an die der anderen MSAL.js-Bibliotheken anzugleichen. Es ist kein separater v4-Featuresatz vorhanden.

Unterstützung für Node.js 16 und 18 eingestellt

MSAL Node v5 unterstützt nicht mehr Node.js 16 oder 18; Sie müssen Node.js 20 oder höher verwenden.

Entfernt proxyUrl und customAgentOptions

MSAL Node v5 bietet keine optionale Konfiguration mehr für den HTTP-Client. Die Parameter proxyUrl und customAgentOptions wurden aus NodeSystemOptions entfernt.

// 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;
};

Entwickler müssen jetzt ihren eigenen benutzerdefinierten HTTP-Client schreiben, wenn die Proxyunterstützung erforderlich ist. Details zur Implementierung finden Sie im benutzerdefinierten INetworkModule-Beispiel .

Konfigurationsänderungen

protocolMode in die Systemkonfiguration verschoben

Der protocolMode Parameter ist keine Authentifizierungskonfigurationsoption mehr und ist stattdessen eine Systemkonfigurationsoption.

// 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",
    },
};

Andere entfernte Parameter

  • Der Parameter skipAuthorityMetadataCache wurde entfernt. Anwendungen verwenden bei der Initialisierung der Autorität den lokalen Metadatencache nicht mehr.
  • Der Parameter encodeExtraQueryParams wurde entfernt. Alle zusätzlichen Abfrageparameter werden automatisch codiert.

fromNativeBroker umbenannt in fromPlatformBroker

AuthenticationResult Im Objekt wurde das fromNativeBroker Feld umbenannt in fromPlatformBroker.

  • Last updated on