Published: July 15, 2026
على الرغم من سهولة تنفيذ مفاتيح المرور، تستمر إمكاناتها وأفضل ممارساتها في التطور. ويستغرق فهم سبب الحاجة إليها وكيفية استخدامها وقتًا. لتبسيط هذه العملية، يقدّم فريق Chrome مهارات مفاتيح المرور في "إرشادات الويب الحديث" لمساعدتك أنت والوكلاء في إنشاء تجارب تسجيل دخول آمنة وحديثة باستخدام مفاتيح المرور.
ما هي فائدة استخدام مهارات مفاتيح المرور؟
"إرشادات الويب الحديث" هي مجموعة من المهارات المصمّمة لـ توجيه وكلاء الترميز بالذكاء الاصطناعي، مثل Anti Gravity أو Claude Code. باستخدام مهارات مفاتيح المرور، يمكنك تنفيذ التسجيل والمصادقة والإدارة وإعادة المصادقة باستخدام أحدث واجهات برمجة التطبيقات وأفضل الممارسات. ينشئ وكيل الترميز بشكل مستقل عملية التنفيذ لكلّ من واجهة المستخدم الأمامية والمنطق الخلفي.
يُظهر تقييم أنّ عملية التنفيذ التي تستخدم مهارات مفاتيح المرور تتفوّق على تلك التي لا تستخدمها على Claude Code Opus 4.8. يستخدم هذا التقييم التطبيق التجريبي والطلبات الموضّحة في هذا المستند.
| بدون مهارات مفاتيح المرور | باستخدام مهارات مفاتيح المرور | |
|---|---|---|
| تمريرة | 47 | 80 |
| إخفاق | 32 | 0 |
| لا ينطبق | 12 | 11 |
| المجموع | 91 | 91 |
الفرق الأكثر وضوحًا هو شاشة إدارة مفاتيح المرور، التي تعرض ا قائمة بمفاتيح المرور التي تم إنشاؤها استنادًا إلى قائمة بمزوّدي مفاتيح المرور من إعداد المنتدى، مع اتّباع أفضل ممارسات إدارة مفاتيح المرور.
تمنح مهارات مفاتيح المرور أيضًا وكيل الترميز إمكانات قوية وأقل وضوحًا:
getClientCapabilities: يمكنك إجراء عملية رصد للميزات الحديثة.- JSON Serialization: يمكنك تسلسل الحمولة المرمّزة باستخدام طلب JavaScript واحد.
- معالجة الأخطاء: يمكنك عرض رسالة أو إغلاقها استنادًا إلى نوع الخطأ.
- Conditional mediation: يمكنك السماح للمستخدمين بتسجيل الدخول مباشرةً من اقتراحات الملء التلقائي في المتصفّح.
- Signal API: يمكنك الحفاظ على مزامنة قائمة بيانات الاعتماد بين المزوّد والخادم.
- Conditional create: يمكنك إنشاء مفتاح مرور تلقائيًا للمستخدمين الذين سجّلوا الدخول مؤخرًا باستخدام كلمة مرور.
الخطوة 1: إنشاء نسخة طبق الأصل من مستودع العرض التوضيحي
يمكنك تجربة مهارات مفاتيح المرور باستخدام مشروع العرض التوضيحي لـ مهارات مفاتيح المرور العرض التوضيحي. عليك إنشاء نسخة طبق الأصل من المستودع:
git clone git@github.com:GoogleChromeLabs/passkey-skills-demo.git
الخطوة 2: تثبيت "إرشادات الويب الحديث"
يمكنك تشغيل معالج الإعداد التفاعلي في دليل مشروعك لتثبيت "إرشادات الويب الحديث":
npx modern-web-guidance@latest install
يضيف هذا المعالج الملفات الضرورية إلى تصميم مشروعك، ما يسمح لوكيل الذكاء الاصطناعي بفهم متطلبات مفاتيح المرور.
.الخطوة 3: استخدام الطلبات
بعد التثبيت، استخدِم هذه الطلبات لإنشاء ميزاتك. تغطّي هذه الأمثلة حالات الاستخدام الأربع التي تغطيها مهارة مفاتيح المرور، وهي مصمّمة خصيصًا لمشروع وضع الحماية.
التسجيل
يمكنك السماح للمستخدمين بتسجيل مفتاح مرور لحساباتهم. لتنفيذ ذلك، جرِّب الطلب التالي:
Implement passkey registration at /settings page under start directory
مثال على تنفيذ الوكيل: ينشئ الوكيل أو يعدّل بشكل مستقل واجهة المستخدم الأمامية والمنطق الخلفي لتسجيل مفتاح مرور جديد.
المصادقة
يمكنك السماح للمستخدمين العائدين بتسجيل الدخول بسرعة باستخدام بيانات الاعتماد القابلة للاكتشاف، إما من خلال مشغّلات الأزرار الصريحة أو اقتراحات الملء التلقائي في المتصفّح. لتنفيذ ذلك، جرِّب الطلب التالي:
Implement passkey authentication at the top page under start directory
مثال على تنفيذ الوكيل: يعالج الوكيل بشكل مستقل حلقة تسجيل الدخول والتحقّق على الصفحة المقصودة الرئيسية أو مسار تسجيل الدخول.
الإدارة
يمكنك السماح للمستخدمين بعرض مفاتيح المرور المسجّلة وإعادة تسميتها وحذفها مع الحفاظ على مزامنة بيانات الاعتماد بين الخادم ومديري كلمات المرور في المتصفّح. لتنفيذ ذلك، جرِّب الطلب التالي:
Implement passkey management at /settings page under start directory
مثال على تنفيذ الوكيل: ينشئ الوكيل خيارات هيكلية للمستخدمين لـ عرض مفاتيح المرور الحالية أو إضافتها أو إبطالها.
إعادة المصادقة
يمكنك التحقّق من هوية مستخدم سجّل الدخول باستخدام مفاتيح المرور الحالية قبل السماح بإجراءات حسّاسة، مثل تغييرات الأمان أو عمليات التحويل المالي. لتنفيذ ذلك، جرِّب الطلب التالي:
Implement passkey reauthentication at /reauth under start directory
مثال على تنفيذ الوكيل: يضبط الوكيل مستوى أمان أعلى للإجراءات الحسّاسة التي يتخذها المستخدم.
/modern-web-guidance
أو الأمر التالي لـ Codex:
$modern-web-guidance
يُرجى الرجوع إلى مستندات الوكيل أو سؤال الوكيل عن كيفية استدعاء مهارة modern-web-guidance مباشرةً إذا لم تكن متأكدًا.
دمج جانب الخادم
على الرغم من أنّ وكلاء الترميز يمكنهم إنشاء رمز مفتاح مرور من جهة الخادم، قد لا يستخدمون أحدث إصدارات المكتبة. يتضمّن مستودع العرض التوضيحي لمهارات مفاتيح المرور مهارة
simplewebauthn، وهي مهارة لمكتبة جانب الخادم المقترَحة
لـ JavaScript وTypeScript، وهي SimpleWebAuthn.
تكمّل هذه المهارة سلوك وكيل الترميز.
بالنسبة إلى لغات البرمجة الأخرى من جانب الخادم، تنصح Google بدمج مفاتيح المرور مع مفتاح مرور خاص باللغة أو مكتبة FIDO2 أو WebAuthn، بالإضافة إلى مهارة لاستخدام أحدث واجهات برمجة التطبيقات. يكتب مؤلفو المكتبات مهاراتهم الخاصة حتى يتمكّن وكلاء الترميز من استخدام أحدث واجهات برمجة التطبيقات دائمًا.
إخلاء المسؤولية والملاحظات
"إرشادات الويب الحديث" ومهارات مفاتيح المرور في وضع المعاينة. تم تطوير هذه المهارات واختبارها باستخدام مشروع العرض التوضيحي لمهارات مفاتيح المرور مع وكلاء مثل Antigravity وClaude Code. على الرغم من أنّ المهارات تم اختبارها على قواعد رموز أخرى، قد تتطلب تعديلات تتجاوز طلبات المثال المقدّمة. يُرجى مراجعة الرمز الذي تم إنشاؤه للتأكّد من أنّه يلبي توقعاتك، وتقديم طلبات إضافية حسب الحاجة.
يُجري فريق Chrome تعديلات على هذه المهارات ويضيف ميزات أخرى للتحقّق من الهوية والمصادقة إلى "إرشادات الويب الحديث" بمرور الوقت. إذا كانت لديك ملاحظات أو طلبات ميزات، يُرجى إرسالها إلى مستودع modern-web-guidance-src.
يمكنك تجربتها اليوم لتبسيط عملية اعتماد مفاتيح المرور.