MSAL Node v3 から v5 への移行

Note

MSAL Node v4 リリースはありません。 パッケージバージョンは、他の MSAL.js ライブラリとバージョン管理 msal-node 合わせるために、v3 から v5 に直接インクリメントされました。 個別の v4 機能セットは存在しません。

Node.js 16 および 18 のサポートが削除されました

MSAL Node v5 では、Node.js 16 または 18 はサポートされなくなりました。Node.js 20 以降を使用する必要があります。

proxyUrl と customAgentOptions を削除

MSAL Node v5 では、HTTP クライアントのオプション構成が提供されなくなりました。 proxyUrlパラメーターとcustomAgentOptions パラメーターは、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;
};

プロキシのサポートが必要な場合、開発者は独自のカスタム HTTP クライアントを作成する必要があります。 実装の詳細については、 カスタム INetworkModule サンプル を参照してください。

構成の変更

protocolMode システム構成に移動

protocolMode パラメーターは、認証構成オプションではなく、代わりにシステム構成オプションです。

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

その他の削除されたパラメーター

  • skipAuthorityMetadataCache パラメーターは削除されました。 アプリケーションは、権限の初期化中にローカル メタデータ キャッシュを使用しなくなりました。
  • encodeExtraQueryParams パラメーターは削除されました。 追加のクエリ パラメーターはすべて自動的にエンコードされます。

fromNativeBroker に名前が変更された fromPlatformBroker

AuthenticationResult オブジェクトでは、fromNativeBroker フィールドの名前が fromPlatformBroker に変更されました。

  • Last updated on