Eseguire la migrazione dal nodo MSAL v3 alla versione 5

Note

Non è disponibile alcuna versione del nodo MSAL v4. La versione del pacchetto è stata aumentata da v3 direttamente a v5 per allineare il controllo delle versioni di msal-node a quello delle altre librerie MSAL.js. Non esiste alcun set di funzionalità v4 separato.

Supporto eliminato per Node.js 16 e 18

Il nodo MSAL v5 non supporta più Node.js 16 o 18; è necessario usare Node.js 20 o versione successiva.

Rimossi proxyUrl e customAgentOptions

Il nodo MSAL v5 non fornisce più la configurazione facoltativa per il client HTTP. I proxyUrl parametri e customAgentOptions sono stati rimossi da 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;
};

Gli sviluppatori devono ora scrivere il proprio client HTTP personalizzato quando è necessario il supporto proxy. Per informazioni dettagliate sull'implementazione, vedere l'esempio INetworkModule personalizzato .

Modifiche di configurazione

protocolMode spostato nelle impostazioni di sistema

Il protocolMode parametro non è più un'opzione di configurazione dell'autenticazione ed è invece un'opzione di configurazione di sistema.

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

Altri parametri rimossi

  • Il parametro skipAuthorityMetadataCache è stato rimosso. Le applicazioni non usano più la cache dei metadati locale durante l'inizializzazione dell'autorità.
  • Il parametro encodeExtraQueryParams è stato rimosso. Tutti i parametri di query aggiuntivi vengono codificati automaticamente.

fromNativeBroker rinominato in fromPlatformBroker

Nell'oggetto AuthenticationResult il fromNativeBroker campo è stato rinominato in fromPlatformBroker.

  • Last updated on