Migrálás MSAL-csomópont 3-ról v5-ös verzióra

Note

Nincs MSAL Node v4 kiadás. A csomagverziót közvetlenül a v3-ról v5-re növelték, hogy a msal-node verziókezelését a többi MSAL.js könyvtáréhoz igazítsák. Nincs külön v4-funkciókészlet.

Megszűnt a Node.js 16 és 18 támogatása

Az MSAL Node v5 már nem támogatja a Node.js 16-os és 18-as verzióját; a Node.js 20-as vagy újabb verzióját kell használnia.

Eltávolítva proxyUrl és customAgentOptions

Az MSAL Node v5 már nem biztosít opcionális konfigurációt a HTTP-ügyfélhez. A(z) proxyUrl és customAgentOptions paramétereket eltávolítottuk a(z) NodeSystemOptions elemből.

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

A fejlesztőknek most már saját egyéni HTTP-ügyfelet kell írniuk, ha proxytámogatásra van szükség. A megvalósítás részleteiért tekintse meg az egyéni INetworkModule-mintát .

Konfigurációs módosítások

protocolMode átkerült a rendszerkonfigurációba

A protocolMode paraméter már nem hitelesítési konfigurációs beállítás, hanem rendszerkonfigurációs beállítás.

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

Egyéb eltávolított paraméterek

  • A skipAuthorityMetadataCache paraméter el lett távolítva. Az alkalmazások már nem használják a helyi metaadat-gyorsítótárat a szolgáltató inicializálása során.
  • A encodeExtraQueryParams paraméter el lett távolítva. A rendszer automatikusan kódolja az összes további lekérdezési paramétert.

fromNativeBroker átnevezve lett fromPlatformBroker

Az objektumban a AuthenticationResultfromNativeBroker mező át lett nevezve a következőre fromPlatformBroker: .