Migracja z MSAL Node v3 do v5

Note

Nie ma wydania biblioteki MSAL Node w wersji 4. Wersja pakietu została podniesiona z v3 bezpośrednio do v5, aby dostosować numerację wersji msal-node do pozostałych bibliotek MSAL.js. Nie istnieje żaden oddzielny zestaw funkcji w wersji 4.

Porzucona obsługa Node.js 16 i 18

Biblioteka MSAL Node v5 nie obsługuje już Node.js 16 ani 18; musisz używać Node.js w wersji 20 lub nowszej.

Usunięte proxyUrl i customAgentOptions

MSAL Node 5 nie zapewnia już opcjonalnej konfiguracji klienta HTTP. Parametry proxyUrl i customAgentOptions zostały usunięte z NodeSystemOptionselementu .

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

Deweloperzy muszą teraz napisać własnego niestandardowego klienta HTTP, gdy potrzebna jest obsługa serwera proxy. Aby uzyskać szczegółowe informacje o implementacji, zobacz przykład niestandardowy moduł INetworkModule .

Zmiany konfiguracji

protocolMode przeniesiono do konfiguracji systemu

Parametr protocolMode nie jest już opcją konfiguracji uwierzytelniania i jest zamiast tego opcją konfiguracji systemu.

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

Inne usunięte parametry

• Parametr skipAuthorityMetadataCache został usunięty. Aplikacje nie korzystają już z lokalnej pamięci podręcznej metadanych podczas inicjowania authority.
• Parametr encodeExtraQueryParams został usunięty. Wszystkie dodatkowe parametry zapytania są automatycznie kodowane.

fromNativeBroker zmieniono nazwę na fromPlatformBroker

AuthenticationResult W obiekcie nazwa fromNativeBroker pola została zmieniona na fromPlatformBroker.