Migreren van MSAL Node v3 naar v5

Note

Er is geen MSAL Node v4-release. De pakketversie is rechtstreeks van v3 naar v5 verhoogd om versiebeheer uit te lijnen msal-node met de andere MSAL.js bibliotheken. Er bestaat geen afzonderlijke v4-onderdelenset.

Verwijderde ondersteuning voor Node.js 16 en 18

MSAL Node v5 biedt geen ondersteuning meer voor Node.js 16 of 18; u moet Node.js 20 of hoger gebruiken.

Verwijderd proxyUrl en customAgentOptions

MSAL Node v5 biedt geen optionele configuratie meer voor de HTTP-client. De proxyUrl en customAgentOptions parameters zijn verwijderd uit 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;
};

Ontwikkelaars moeten nu hun eigen aangepaste HTTP-client schrijven wanneer proxyondersteuning nodig is. Zie het voorbeeld van de aangepaste INetworkModule voor implementatiedetails.

Configuratiewijzigingen

protocolMode verplaatst naar systeemconfiguratie

De protocolMode parameter is geen verificatieconfiguratieoptie meer en is in plaats daarvan een systeemconfiguratieoptie.

// 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 verwijderde parameters

  • De skipAuthorityMetadataCache parameter is verwijderd. Toepassingen gebruiken de lokale metagegevenscache niet meer tijdens de initialisatie van de authority.
  • De encodeExtraQueryParams parameter is verwijderd. Alle extra queryparameters worden automatisch gecodeerd.

fromNativeBroker hernoemd in fromPlatformBroker

In het AuthenticationResult object is de naam van het fromNativeBroker veld gewijzigd in fromPlatformBroker.

  • Last updated on