Migrace z uzlu MSAL v3 na verzi 5

Note

Není k dispozici žádná verze MSAL Node v4. Verze balíčku byla zvýšena přímo z v3 na v5, aby bylo verzování msal-node v souladu s dalšími knihovnami MSAL.js. Žádná samostatná sada funkcí v4 neexistuje.

Vyřazená podpora pro Node.js 16 a 18

MSAL Node v5 již nepodporuje Node.js 16 ani 18; musíte používat Node.js 20 nebo novější verzi.

Odstraněno proxyUrl a customAgentOptions

MSAL Node v5 už neposkytuje volitelnou konfiguraci pro klient HTTP. Parametry proxyUrl a customAgentOptions byly odebrány z 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;
};

Vývojáři teď musí v případě potřeby podpory proxy serveru napsat vlastního klienta HTTP. Podrobnosti o implementaci najdete v ukázce vlastního modulu INetworkModule .

Změny konfigurace

protocolMode přesunuto do konfigurace systému

Parametr protocolMode už není možností konfigurace ověřování a je to možnost konfigurace systému.

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

Další odebrané parametry

  • Parametr skipAuthorityMetadataCache byl odebrán. Aplikace už při inicializaci autority nepoužívají místní mezipaměť metadat.
  • Parametr encodeExtraQueryParams byl odebrán. Všechny další parametry dotazu jsou automaticky kódovány.

fromNativeBroker přejmenováno na fromPlatformBroker

V objektu AuthenticationResultfromNativeBroker bylo pole přejmenováno na fromPlatformBroker.