Migrer de MSAL Node v3 vers v5

Note

Il n’existe aucune version MSAL Node v4. La version du package est passée directement de v3 à v5 afin d’aligner le msal-node versionnage sur celui des autres bibliothèques MSAL.js. Aucun ensemble de fonctionnalités v4 distinct n’existe.

Abandon de la prise en charge de Node.js 16 et 18

MSAL Node v5 ne prend plus en charge Node.js 16 ou 18 ; vous devez utiliser Node.js 20 ou version ultérieure.

Suppression de proxyUrl et de customAgentOptions

MSAL Node v5 ne fournit plus de configuration facultative pour le client HTTP. Les paramètres proxyUrl et customAgentOptions ont été supprimés de 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;
};

Les développeurs doivent maintenant écrire leur propre client HTTP personnalisé lorsque la prise en charge du proxy est nécessaire. Pour plus d’informations sur l’implémentation, consultez l’exemple INetworkModule personnalisé .

Modifications de configuration

protocolMode déplacé vers la configuration système

Le protocolMode paramètre n’est plus une option de configuration d’authentification et est plutôt une option de configuration système.

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

Autres paramètres supprimés

  • Le paramètre skipAuthorityMetadataCache a été supprimé. Les applications n’utilisent plus le cache de métadonnées locales pendant l’initialisation de l’autorité.
  • Le paramètre encodeExtraQueryParams a été supprimé. Tous les paramètres de requête supplémentaires sont automatiquement encodés.

fromNativeBroker renommé en fromPlatformBroker

Dans l’objet AuthenticationResult, le champ fromNativeBroker a été renommé en fromPlatformBroker.

  • Last updated on