MSAL Node v3'ten v5'e geçiş

Note

MSAL Node v4 sürümü yoktur. Sürüm oluşturma işlemini diğer MSAL.js kitaplıklarıyla hizalamak msal-node için paket sürümü v3'ten doğrudan v5'e artırıldı. Ayrı bir v4 özellik kümesi yok.

Node.js 16 ve 18 desteği bırakıldı

MSAL Node v5 artık Node.js 16 veya 18'i desteklemez; Node.js 20 veya üzerini kullanmanız gerekir.

kaldırıldı proxyUrl ve customAgentOptions

MSAL Node v5 artık HTTP istemcisi için isteğe bağlı yapılandırma sağlamaz. proxyUrl ve customAgentOptions parametreleri, NodeSystemOptions içinden kaldırılmıştır.

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

Ara sunucu desteği gerektiğinde geliştiricilerin artık kendi özel HTTP istemcilerini yazması gerekir. Uygulama ayrıntıları için özel INetworkModule örneğine bakın.

Yapılandırma değişiklikleri

protocolMode sistem yapılandırmasına taşındı

protocolMode Parametresi artık bir kimlik doğrulama yapılandırma seçeneği değildir ve bunun yerine bir sistem yapılandırma seçeneğidir.

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

Kaldırılan diğer parametreler

  • skipAuthorityMetadataCache parametresi kaldırıldı. Uygulamalar artık yetkili başlatma sırasında yerel meta veri önbelleğini kullanmaz.
  • encodeExtraQueryParams parametresi kaldırıldı. Tüm ek sorgu parametreleri otomatik olarak kodlanır.

fromNativeBroker olarak yeniden adlandırıldı fromPlatformBroker

AuthenticationResult nesnesinde, fromNativeBroker alanının adı fromPlatformBroker olarak değiştirildi.