Миграция с MSAL Node версии 3 на v5

Note

Выпуск MSAL Node версии 4 отсутствует. Версия пакета была увеличена с v3 сразу до v5, чтобы согласовать версионирование msal-node с версионированием других библиотек MSAL.js. Отдельный набор компонентов версии 4 не существует.

Удалена поддержка Node.js 16 и 18

MSAL Node версии 5 больше не поддерживает Node.js 16 или 18; необходимо использовать Node.js 20 или более поздней версии.

Удалено proxyUrl и customAgentOptions

MsAL Node версии 5 больше не предоставляет необязательную конфигурацию для 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.