Chrome 143'teki FedCM güncellemeleri

Yayınlanma tarihi: 12 Ocak 2026

Chrome 143, gizliliği, geliştirici deneyimini ve tarayıcılar arası birlikte çalışabilirliği iyileştirmek için Birleşik Kimlik Bilgisi Yönetimi (FedCM) API'de güncellemeler sunar. Bu değişiklikler; kimlik sağlayıcılar (IdP'ler), bağlı olan taraflar (RP'ler) ve web topluluğundan gelen geri bildirimlere dayanmaktadır.

Önemli güncellemeler şunlardır:

Kimlik onaylama uç noktasından gelen yapılandırılmış JSON yanıtlarını destekleme

Daha önce FedCM kimlik onayı uç noktasının yanıtındaki token özelliğinin dize olması gerekiyordu. Bu durum, geliştiricileri verileri sunucuda manuel olarak JSON dizesine dönüştürmeye ve istemcide ayrıştırmaya zorluyordu.

Chrome 143'ten itibaren kimlik onayı uç noktası, token özelliğinin değeri olarak yapılandırılmış bir JSON nesnesini destekler. Örneğin:

{
  "token": {
    "access_token": "a1b2c3d4e5f6...",
    "user_info": {
      "email": "jane.doe@company.example",
      "given_name": "Jane",
      "family_name": "Doe"
    }
  }
}

Bu değişiklik, manuel JSON serileştirme ve ayrıştırma ihtiyacını ortadan kaldırır ve IdP'lerin ek bilgi döndürmesine olanak tanır.

Bu özelliği FedCM demosu ile deneyin veya güncellenen kimlik onay uç noktası yanıtının nasıl yapılandırıldığıyla ilgili güncel bilgiler için Kimlik sağlayıcı tarafında FedCM'yi uygulama kılavuzuna bakın.

Müşteri meta verilerini doğrulama

FedCM, kullanıcı gizliliğini daha iyi korumak için IdP uç noktalarının doğrulamasını güçlendiriyor. Bu değişiklik, IdP'nin RP'yi yol parametresi olarak iletilen benzersiz bir kimlikle eşleştirmesini engeller.

FedCM yapılandırmanız client_metadata uç noktasını kullanıyorsa .well-known/web-identity dosyanıza accounts_endpoint ve login_url parametrelerini eklemeniz gerekir. Chrome 145'ten itibaren tarayıcı, well-known dosyasında accounts_endpoint parametresini zorunlu kılar.

{
  "accounts_endpoint": "/example-accounts",
  "login_url": "/example-login"
}

Daha fazla bilgi için FedCM uygulama kılavuzunu inceleyin.

API tutarlılığı ve hata işleme güncellemeleri

Chrome 143, web ekosistemi geri bildirimlerine uygun olarak FedCM API'nin netliğini ve tarayıcılar arasındaki tutarlılığını artırmak için iki değişiklik sunar.

nonce parametresinin yerini değiştirme

Chrome, 145 sürümünden itibaren üst düzey nonce parametresi için desteği sonlandıracak. navigator.credentials.get() çağrısındaki params nesnesinde nonce parametresini iletmeniz gerekir:

const credential = await navigator.credentials.get({
  identity: {
    providers: [{
      // Don't pass nonce as a top-level parameter here
      configURL: "/fedcm.json",
      clientId: "123",
      params: {
     // Place nonce within the params object    
        nonce: "a-random-nonce"
      }
    }]
  }
});

Sunucu tarafı mantığınızın, kimlik onayı uç noktasındaki params nesnesinde nonce değerini beklediğinden emin olun.

IdentityCredentialError.code adlı öğeyi IdentityCredentialError.error olarak yeniden adlandır

Yerleşik DOMException.code özelliğiyle adlandırma çakışmalarını önlemek için IdentityCredentialError.code, IdentityCredentialError.error olarak yeniden adlandırıldı. Bu değişiklik Chrome 145'ten itibaren uygulanacak.

try {
  // FedCM API call
} catch (e) {
   // Renamed IdentityCredentialError.code to IdentityCredentialError.error:    
   console.log(e.error);
}

Geçiş döneminde (Chrome 143 ve 144) geriye dönük uyumluluğu sağlamak için hata işleme mantığınızda hem code hem de error özelliklerini kontrol edin. Bu sayede, kullanıcılar Chrome'un daha yeni sürümlerine geçerken çözümünüz eski tarayıcılarda çalışmaya devam eder:

 // In older browsers, the property might still be named 'code'
 // during the transition period
  const errorCode = e.error ?? e.code;
  if (errorCode) {
    // Handle specific error types
  } else {
    console.error("An unknown error occurred", e);
  }

FedCM belgelerinin Hata yanıtı döndürme bölümünden daha fazla bilgi edinebilirsiniz.

Görüşlerinizi paylaşın

FedCM'yi geliştirmeye ve iyileştirmeye devam ederken görüşlerinize değer veriyoruz. Geri bildiriminiz varsa veya herhangi bir sorunla karşılaşırsanız:

Daha fazla bilgi