السماح بإعادة استخدام مفاتيح المرور في جميع مواقعك الإلكترونية من خلال "طلبات المصدر ذات الصلة"

ترتبط مفاتيح المرور بموقع إلكتروني محدّد، ولا يمكن استخدامها إلا لتسجيل الدخول إلى الموقع الإلكتروني الذي تم إنشاؤها له.

يتم تحديد ذلك في معرّف الجهة المعتمدة (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.
يملأ Chrome تلقائيًا البيانات على كلا الموقعَين الإلكترونيَين.
بفضل ميزة "طلبات المصدر ذي الصلة"، يمكن للمستخدمين استخدام بيانات اعتماد مفتاح المرور نفسها في ror-1 وror-2. سيملأ Chrome أيضًا بيانات الاعتماد تلقائيًا.

الاطّلاع على الرمز:

الخطوة 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
رسالة خطأ في Chrome عند إنشاء بيانات الاعتماد يظهر هذا الخطأ إذا تعذّر العثور على ملف `.well-known/webauthn` على الرابط `https://{RP ID}/.well-known/webauthn`.
رسالة خطأ منبثقة في Chrome
رسالة الخطأ في Chrome عند إنشاء بيانات الاعتماد يظهر هذا الخطأ إذا تم العثور على ملف ‎ `.well-known/webauthn` ولكنّه لا يتضمّن المصدر الذي تحاول إنشاء بيانات اعتماد منه.

اعتبارات أخرى

مشاركة مفاتيح المرور على المواقع الإلكترونية وتطبيقات الأجهزة الجوّالة

تتيح ميزة "طلبات المصدر ذي الصلة" للمستخدمين إعادة استخدام مفتاح مرور على مستوى مواقع إلكترونية متعددة. للسماح للمستخدمين بإعادة استخدام مفتاح مرور على موقع إلكتروني وتطبيق متوافق مع الأجهزة الجوّالة، استخدِم الأساليب التالية:

مشاركة كلمات المرور على مواقع إلكترونية مختلفة

تتيح ميزة "طلبات المصادر ذات الصلة" للمستخدمين إعادة استخدام مفتاح مرور على مواقع إلكترونية متعددة. تختلف حلول مشاركة كلمات المرور على مستوى المواقع الإلكترونية بين مدراء كلمات المرور. بالنسبة إلى "مدير كلمات المرور في Google"، استخدِم روابط تنقل إلى مواد عرض رقمية . يستخدم Safari نظامًا مختلفًا.

دور مدراء بيانات الاعتماد ووكلاء المستخدمين

يتجاوز هذا نطاق عملك كمطوّر مواقع إلكترونية، ولكن يُرجى العِلم أنّه على المدى الطويل، يجب ألا يكون معرّف الجهة المعتمدة مفهومًا مرئيًا للمستخدم في وكيل المستخدم أو Credential Manager التي يستخدمها المستخدمون. وبدلاً من ذلك، على وكلاء المستخدمين ومدراء بيانات الاعتماد أن يعرضوا للمستخدمين أماكن استخدام بيانات الاعتماد الخاصة بهم. سيستغرق تنفيذ هذا التغيير بعض الوقت. سيكون الحل المؤقت هو عرض كل من الموقع الحالي وموقع التسجيل الأصلي.