Get your free and exclusive 80-page Banking Passkey Report

ما هو authenticatorSelection في WebAuthn؟

Vincent Delitz

Vincent

Created: July 11, 2025

Updated: July 12, 2025


See the original glossary version in English here.

ما هو authenticatorSelection؟#

في WebAuthn، يعد authenticatorSelection جزءًا مهمًا من كائن PublicKeyCredentialCreationOptions. تُمكّن هذه الميزة الأطراف المعتمدة (RPs) من تحديد معايير لاختيار أدوات المصادقة المناسبة أثناء عملية create(). تكمن أهميته في:

  • تحديد متطلبات أداة المصادقة: يحدد نوع أدوات المصادقة التي يمكن أن تشارك في عملية التسجيل.
  • ارتباط أداة المصادقة: يحدد ما إذا كانت أداة المصادقة مدمجة بالمنصة (مثل Face ID، Touch ID، Windows Hello) أو أداة مصادقة متنقلة عبر المنصات.
  • التحقق من المستخدم: يحدد متطلبات التحقق من المستخدم (على سبيل المثال، "مُفضّل"، "مطلوب"، أو "غير مُحبّذ").
Slack Icon

Become part of our Passkeys Community for updates & support.

Join

مثال:#

"authenticatorSelection": { "authenticatorAttachment": "platform", "residentKey": "required", "requireResidentKey": false, "userVerification": "required", }

واصل القراءة للحصول على تفصيل للقيم والإعدادات الممكنة لـ authenticatorSelection.

نقاط رئيسية#

  • يحدد authenticatorSelection متطلبات اختيار أدوات المصادقة في WebAuthn.
  • يتضمن طريقة ارتباط أداة المصادقة ومتطلبات التحقق من المستخدم.
  • يعزز الأمان من خلال السماح بالتحكم الدقيق في عملية المصادقة.

يعد authenticatorSelection في WebAuthn ضروريًا لضمان توافق عملية المصادقة مع متطلبات أمان محددة وتفضيلات تجربة المستخدم. إنه يوفر للأطراف المعتمدة المرونة لتخصيص عملية التسجيل وفقًا لاحتياجاتهم الأمنية.

فيما يلي نظرة عامة على القيم الممكنة، كما هو محدد في مواصفات WebAuthn:

authenticatorAttachment#

القيم الممكنة:

  • Platform: تكون أداة المصادقة مرتبطة بمنصة العميل وبالتالي لا يمكن إزالتها.
  • Cross-platform: لا تكون أداة المصادقة مرتبطة بمنصة العميل ويمكن استخدامها على أجهزة متعددة.

residentKey#

تحدد هذه القيمة ما إذا كان الطرف المعتمد يريد إنشاء بيانات اعتماد قابلة للاكتشاف. القيم الممكنة هي:

  • required: يجب على أداة المصادقة إنشاء مفتاح مقيم ويجب أن تفشل العملية إذا لم يكن ذلك ممكنًا.
  • preferred: يجب أن تحاول أداة المصادقة إنشاء مفتاح مقيم ويجب أن تنشئ مفتاحًا غير مقيم إذا لم يكن ذلك ممكنًا.
  • discouraged: يجب على أداة المصادقة إنشاء مفتاح غير مقيم ويجب أن تفشل العملية إذا لم يكن ذلك ممكنًا.

requireResidentKey#

تُستخدم هذه القيمة فقط للتوافق مع الإصدارات السابقة من المستوى الأول لـ WebAuthn، حيث يتم تعيينها إلى "true" إذا تم تعيين residentKey إلى "required".

Substack Icon

Subscribe to our Passkeys Substack for the latest news.

Subscribe

userVerification#

تشير هذه القيمة إلى ما إذا كان التحقق من المستخدم مطلوبًا للعملية. القيم الممكنة هي:

  • required: يجب أن تتحقق العملية من المستخدم.
  • preferred: يجب أن تتحقق العملية من المستخدم، ولكن يمكن أن تستمر بدونه (القيمة القياسية).
  • discouraged: يجب ألا تتحقق العملية من المستخدم.

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


الأسئلة الشائعة حول authenticatorSelection#

ما هي وظيفة authenticatorSelection في WebAuthn؟#

يسمح authenticatorSelection في WebAuthn للأطراف المعتمدة بتحديد نوع أدوات المصادقة المناسبة لعملية المصادقة الخاصة بهم، بما في ذلك متطلبات التحقق من المستخدم ونوع أداة المصادقة.

كيف يؤثر authenticatorSelection على تجربة المستخدم في المصادقة؟#

يؤثر على تجربة المستخدم من خلال تحديد نوع أداة المصادقة المستخدمة (مدمجة بالمنصة أو متنقلة) وتعيين مستوى التحقق من المستخدم، مما يؤثر على سهولة وأمان عملية المصادقة.

Debugger Icon

Want to experiment with passkey flows? Try our Passkeys Debugger.

Try for Free

ما هي تبعات إعداد authenticatorAttachment في authenticatorSelection؟#

يحدد إعداد authenticatorAttachment في authenticatorSelection ما إذا كانت هناك حاجة إلى أداة مصادقة مدمجة بالمنصة ثابتة أو أداة مصادقة متنقلة عبر المنصات قابلة للإزالة، مما يؤثر على الخصائص المادية والوظيفية لعملية المصادقة.

Add passkeys to your app in <1 hour with our UI components, SDKs & guides.

Start for free

Share this article


LinkedInTwitterFacebook

Enjoyed this read?

🤝 Join our Passkeys Community

Share passkeys implementation tips and get support to free the world from passwords.

🚀 Subscribe to Substack

Get the latest news, strategies, and insights about passkeys sent straight to your inbox.

Related Terms