ترتبط مفاتيح المرور بموقع إلكتروني محدّد، ولا يمكن استخدامها إلا لتسجيل الدخول إلى الموقع الإلكتروني الذي تم إنشاؤها له.
يتم تحديد ذلك في معرّف الجهة المعتمدة (RP ID)، والذي يمكن أن يكون www.example.com أو example.com لمفاتيح المرور التي تم إنشاؤها لنطاق example.com.
على الرغم من أنّ معرّفات الجهات المعتمِدة تمنع استخدام مفاتيح المرور كبيانات اعتماد واحدة للمصادقة في كل مكان، فإنّها تؤدي إلى حدوث مشاكل في ما يلي:
- المواقع الإلكترونية التي تتضمّن نطاقات متعددة: لا يمكن للمستخدمين استخدام مفتاح المرور نفسه لتسجيل الدخول على نطاقات مختلفة خاصة ببلدان معيّنة (مثل
example.comوexample.co.uk) تديرها الشركة نفسها. - النطاقات التي تحمل علامة تجارية: لا يمكن للمستخدمين استخدام بيانات الاعتماد نفسها في
نطاقات مختلفة تستخدمها علامة تجارية واحدة (على سبيل المثال،
acme.comوacmerewards.com). - التطبيقات المتوافقة مع الأجهزة الجوّالة: غالبًا ما لا يكون للتطبيقات المتوافقة مع الأجهزة الجوّالة نطاق خاص بها، ما يجعل إدارة بيانات الاعتماد أمرًا صعبًا.
هناك حلول بديلة تستند إلى اتحاد الهوية، وأخرى تستند إلى إطارات iframe، ولكنها غير ملائمة في بعض الحالات. وتقدّم طلبات المصدر ذي الصلة حلاً لهذه المشكلة.
الحل
باستخدام طلبات المصادر ذات الصلة، يمكن لموقع إلكتروني تحديد المصادر المسموح لها باستخدام معرّف الطرف المعتمِد الخاص به.
يتيح ذلك للمستخدمين إعادة استخدام مفتاح المرور نفسه على مواقع إلكترونية متعدّدة تديرها.
لاستخدام ميزة "طلبات المصدر ذي الصلة"، عليك عرض ملف JSON خاص على عنوان URL محدّد https://{RP ID}/.well-known/webauthn. إذا أراد "example.com"
السماح للمصادر الإضافية باستخدامه كمعرّف للطرف المعتمِد، عليه عرض الملف التالي
على الرابط https://example.com/.well-known/webauthn:
{
"origins": [
"https://example.co.uk",
"https://example.de",
"https://example-rewards.com"
]
}
في المرة التالية التي يطلب فيها أي من هذه المواقع الإلكترونية إنشاء مفتاح مرور
(navigator.credentials.create) أو مصادقة (navigator.credentials.get)
تستخدم example.com كمعرّف للطرف المعتمِد، سيلاحظ المتصفّح أنّ معرّف الطرف المعتمِد
لا يتطابق مع المصدر الذي يرسل الطلب. إذا كان المتصفّح يتيح "طلبات المصدر ذي الصلة"، سيبحث أولاً عن ملف webauthn على https://{RP ID}/.well-known/webauthn. إذا كان الملف متوفّرًا،
يتحقّق المتصفّح مما إذا كان المصدر الذي يرسل الطلب مدرجًا في allowlist.
إذا كانت الإجابة "نعم"، ينتقل إلى خطوات إنشاء مفتاح المرور أو المصادقة.
إذا كان المتصفّح لا يتيح "طلبات المصادر ذات الصلة"، فسيظهر الخطأ SecurityError.
دعم المتصفح
تتوفّر ميزة "طلبات المصدر ذي الصلة" على متصفّحَي Chrome وSafari. اعتبارًا من يناير 2026، لا يزال Firefox يدرس إمكانية استخدام هذه الميزة. ويمكنك تتبُّع حالتها في مشكلة موضع معايير Mozilla.
إعداد طلبات المصدر ذي الصلة
يستخدم العرض التوضيحي التالي موقعَين إلكترونيَين، هما https://ror-1.glitch.me وhttps://ror-2.glitch.me.
للسماح للمستخدمين بتسجيل الدخول باستخدام مفتاح المرور نفسه على كلا الموقعَين الإلكترونيَين، يستخدم الموقع الإلكتروني "طلبات المصدر ذي الصلة" للسماح لـ ror-2.glitch.me باستخدام ror-1.glitch.me كمعرّف الجهة الموثوق بها.
عرض توضيحي
ينفّذ الموقع الإلكتروني https://ror-2.glitch.me ميزة "طلبات المصادر ذات الصلة" لاستخدام ror-1.glitch.me كمعرّف للجهة المعتمدة، وبالتالي يستخدم كل من ror-1 وror-2 المعرّف ror-1.glitch.me كمعرّف للجهة المعتمدة عند إنشاء مفتاح مرور أو المصادقة باستخدامه.
لقد نفّذنا أيضًا قاعدة بيانات مشتركة لمفاتيح المرور على هذه المواقع الإلكترونية.
لاحظ تجربة المستخدم التالية:
- يمكنك إنشاء مفتاح مرور بنجاح والمصادقة باستخدامه على
ror-2، على الرغم من أنّ معرّف الطرف المعتمد هوror-1(وليسror-2). - بعد إنشاء مفتاح مرور على
ror-1أوror-2، يمكنك المصادقة باستخدامه على كل منror-1وror-2. بما أنّror-2يحدّدror-1كمعرّف للجهة المعتمِدة، فإنّ إنشاء مفتاح مرور أو طلب مصادقة من أي من هذه المواقع الإلكترونية هو نفسه تقديم الطلب على ror-1. معرّف الجهة المعتمدة هو الشيء الوحيد الذي يربط الطلب بمصدر. - بعد إنشاء مفتاح مرور على "
ror-1" أو "ror-2"، يمكن لمتصفّح Chrome ملؤه تلقائيًا على كل من "ror-1" و"ror-2". - وسيكون لمعرّف الطرف المعتمِد (RP ID) لبيانات الاعتماد التي تم إنشاؤها على أي من هذه المواقع الإلكترونية القيمة
ror-1.
الاطّلاع على الرمز:
- يمكنك الاطّلاع على ملف
/.well-known/webauthnالذي تم إعداده في قاعدة الرموز البرمجية ror-1. - يمكنك الاطّلاع على
RP_ID_RORتكرار في قاعدة الرموز البرمجية ror-2.
الخطوة 1: تنفيذ قاعدة بيانات حسابات مشتركة
إذا أردت أن يتمكّن المستخدمون من تسجيل الدخول باستخدام مفتاح المرور نفسه على كلّ من site-1 وsite-2، عليك تنفيذ قاعدة بيانات للحسابات تتم مشاركتها على هذين الموقعين الإلكترونيين.
الخطوة 2: إعداد ملف JSON الخاص بـ .well-known/webauthn في الموقع الإلكتروني 1
أولاً، عليك ضبط site-1.com للسماح لـ site-2.com باستخدامه كمعرّف للجهة المعتمِدة. ولتنفيذ ذلك، أنشِئ ملف JSON الخاص بـ webauthn:
{
"origins": [
"https://site-2.com"
]
}
يجب أن يحتوي عنصر JSON على مفتاح باسم "origins" تكون قيمته مصفوفة من سلسلة واحدة أو أكثر تتضمّن عناوين الويب المصدر.
قيود مهمة: 5 تصنيفات كحدّ أقصى
ستتم معالجة كل عنصر في هذه القائمة لاستخراج تصنيف النطاق ذي المستوى الأعلى الفعلي (eTLD) + 1.
على سبيل المثال، تصنيفات eTLD + 1 لكل من example.co.uk وexample.de هي
example. ولكن تصنيف eTLD + 1 لـ "example-rewards.com" هو "example-rewards".
في Chrome، يبلغ الحد الأقصى لعدد التصنيفات 5.
الخطوة 3: عرض ملف JSON .well-known/webauthn في الموقع الإلكتروني 1
بعد ذلك، اعرض ملف JSON ضمن site-1.com/.well-known/webauthn.
على سبيل المثال، في Express:
app.get("/.well-known/webauthn", (req, res) => {
const origins = {
origins: ["https://site-2.com"],
};
return res.json(origins);
});
في هذا المثال، نستخدم res.json السريع الذي يضبط تلقائيًا
قيمة content-type ('application/json') الصحيحة.
الخطوة 4: تحديد معرّف الطرف المعتمِد في الموقع الإلكتروني 2
في قاعدة الرموز البرمجية لـ site-2، اضبط site-1.com كمعرّف الجهة المعتمدة في كل مكان مطلوب:
- عند إنشاء بيانات الاعتماد:
- يجب ضبط
site-1.comكمعرّف الجهة الموثوقة في عملية إنشاء بيانات الاعتمادoptionsالتي يتم تمريرها إلى طلب واجهة المستخدمnavigator.credentials.create، ويتم إنشاؤها عادةً من جهة الخادم. - يجب ضبط
site-1.comكمعرّف الجهة المعتمدة المتوقّع، لأنّك تجري عمليات التحقّق من بيانات الاعتماد قبل حفظها في قاعدة البيانات.
- يجب ضبط
- بعد المصادقة:
- اضبط
site-1.comكمعرّف الجهة المعتمدة فيoptionsالمصادقة التي يتم تمريرها إلى طلب واجهة المستخدمnavigator.credentials.get، ويتم إنشاؤها عادةً من جهة الخادم. - اضبط
site-1.comكمعرّف الجهة الموثوقة المتوقّع التحقّق منه على الخادم، أثناء إجراء عمليات التحقّق من بيانات الاعتماد قبل مصادقة المستخدم.
- اضبط
تحديد المشاكل وحلّها
اعتبارات أخرى
مشاركة مفاتيح المرور على المواقع الإلكترونية وتطبيقات الأجهزة الجوّالة
تتيح ميزة "طلبات المصدر ذي الصلة" للمستخدمين إعادة استخدام مفتاح مرور على مستوى مواقع إلكترونية متعددة. للسماح للمستخدمين بإعادة استخدام مفتاح مرور على موقع إلكتروني وتطبيق متوافق مع الأجهزة الجوّالة، استخدِم الأساليب التالية:
- في Chrome: روابط تنقل إلى مواد عرض رقمية يمكنك الاطّلاع على مزيد من المعلومات في مقالة إضافة دعم لروابط التنقل إلى مواد عرض رقمية.
- في Safari: النطاقات المرتبطة
مشاركة كلمات المرور على مواقع إلكترونية مختلفة
تتيح ميزة "طلبات المصادر ذات الصلة" للمستخدمين إعادة استخدام مفتاح مرور على مواقع إلكترونية متعددة. تختلف حلول مشاركة كلمات المرور على مستوى المواقع الإلكترونية بين مدراء كلمات المرور. بالنسبة إلى "مدير كلمات المرور في Google"، استخدِم روابط تنقل إلى مواد عرض رقمية . يستخدم Safari نظامًا مختلفًا.
دور مدراء بيانات الاعتماد ووكلاء المستخدمين
يتجاوز هذا نطاق عملك كمطوّر مواقع إلكترونية، ولكن يُرجى العِلم أنّه على المدى الطويل، يجب ألا يكون معرّف الجهة المعتمدة مفهومًا مرئيًا للمستخدم في وكيل المستخدم أو Credential Manager التي يستخدمها المستخدمون. وبدلاً من ذلك، على وكلاء المستخدمين ومدراء بيانات الاعتماد أن يعرضوا للمستخدمين أماكن استخدام بيانات الاعتماد الخاصة بهم. سيستغرق تنفيذ هذا التغيير بعض الوقت. سيكون الحل المؤقت هو عرض كل من الموقع الحالي وموقع التسجيل الأصلي.