تاريخ النشر: 12 يناير 2026
يقدّم الإصدار 143 من Chrome تحديثات على Federated Credential Management (FedCM) API لتحسين الخصوصية وتجربة المطوّرين وإمكانية التشغيل التفاعلي للمتصفّح. تستند هذه التغييرات إلى الملاحظات الواردة من موفّري الهوية (IdP) والجهات المعتمِدة (RP) ومنتدى الويب.
في ما يلي التعديلات الرئيسية:
- إتاحة الردود المنظَّمة بتنسيق JSON
- عملية تحقّق أكثر صرامة من البيانات الوصفية للعملاء
- تحسينات على اتساق واجهة برمجة التطبيقات
إتاحة استجابات JSON المنظَّمة من نقطة نهاية تأكيد الهوية
في السابق، كانت نقطة نهاية تأكيد الهوية في FedCM تتطلّب أن تكون السمة token في ردّها سلسلة. وقد أجبر ذلك المطوّرين على إجراء تسلسل للبيانات يدويًا في سلسلة JSON على الخادم وتحليلها على العميل.
بدءًا من الإصدار 143 من Chrome، تتيح نقطة نهاية تأكيد الهوية استخدام عنصر JSON منظَّم كقيمة للسمة token، على سبيل المثال:
{
"token": {
"access_token": "a1b2c3d4e5f6...",
"user_info": {
"email": "jane.doe@company.example",
"given_name": "Jane",
"family_name": "Doe"
}
}
}
يؤدي هذا التغيير إلى إلغاء الحاجة إلى إجراء تسلسل وتحليل JSON يدويًا، ويسمح لموفّري الهوية بإرجاع معلومات إضافية.
يمكنك تجربة هذه الميزة من خلال النسخة التجريبية من FedCM أو الرجوع إلى دليل تنفيذ FedCM من جانب موفِّر الهوية للحصول على معلومات محدّثة حول كيفية تنظيم استجابة نقطة نهاية تأكيد الهوية المعدَّلة.
التحقّق من صحة البيانات الوصفية للعميل
لحماية خصوصية المستخدم بشكل أفضل، تعمل واجهة برمجة التطبيقات FedCM على تعزيز عملية التحقّق من نقاط نهاية موفِّر الهوية. يمنع هذا التغيير موفّر الهوية من مطابقة الجهة المعتمدة مع معرّف فريد يتم تمريره كمَعلمة مسار.
إذا كانت إعدادات FedCM تستخدم نقطة النهاية client_metadata، يجب تضمين accounts_endpoint وlogin_url في ملف .well-known/web-identity. اعتبارًا من الإصدار 145 من Chrome، يفرض المتصفّح المَعلمة accounts_endpoint في الملف المعروف.
{
"accounts_endpoint": "/example-accounts",
"login_url": "/example-login"
}
لمزيد من التفاصيل، يُرجى الاطّلاع على دليل استخدام FedCM.
تعديلات على اتساق واجهة برمجة التطبيقات ومعالجة الأخطاء
يقدّم الإصدار 143 من Chrome تغييرَين لتحسين وضوح واجهة برمجة التطبيقات FedCM API واتساقها على مستوى المتصفّحات، بما يتوافق مع الملاحظات الواردة من منظومة الويب المتكاملة.
نقل مَعلمة nonce
اعتبارًا من الإصدار 145، سيتوقف Chrome عن إتاحة مَعلمة nonce ذات المستوى الأعلى. يجب تمرير المَعلمة nonce ضمن عنصر المَعلمات في طلب navigator.credentials.get():
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"
}
}]
}
});
يُرجى التأكّد من أنّ منطق جهة الخادم يتوقّع nonce ضمن عنصر params في
نقطة نهاية تأكيد الهوية.
إعادة تسمية IdentityCredentialError.code إلى IdentityCredentialError.error
لمنع حدوث تعارضات في الأسماء مع السمة المضمّنة DOMException.code،
تمت إعادة تسمية IdentityCredentialError.code إلى IdentityCredentialError.error.
سيتم فرض هذا التغيير اعتبارًا من الإصدار 145 من Chrome.
try {
// FedCM API call
} catch (e) {
// Renamed IdentityCredentialError.code to IdentityCredentialError.error:
console.log(e.error);
}
لضمان التوافق مع الأنظمة القديمة خلال الفترة الانتقالية (الإصداران 143 و144 من Chrome)، ابحث عن السمتَين code وerror في منطق معالجة الأخطاء.
يضمن ذلك عمل الحلّ في المتصفّحات القديمة أثناء تحديث المستخدمين إلى الإصدارات الأحدث من Chrome:
// 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.
مشاركة ملاحظاتك
نحن نقدّر ملاحظاتك ونستفيد منها لمواصلة تطوير FedCM وتحسينها. إذا كانت لديك ملاحظات أو واجهت أي مشاكل:
- الإبلاغ عن مشكلة في مستودع GitHub
- انضم إلى القائمة البريدية للنشرة الإخبارية المخصّصة للمطوّرين للاطّلاع على آخر الإشعارات.