webauthn
Web Authentication Candidate Recommendation (CR-00)
هذا هو المستودع الخاص بمجموعة عمل W3C WebAuthn، التي تنتج مسودة مواصفات "مصادقة الويب" .
gh-pages لهذا المستودع.للمساهمة ماديًا في هذه المواصفات، يجب عليك تلبية المتطلبات الموضحة في CONTRIBUTING.md. وأيضًا، قبل إرسال التعليقات، يرجى التعرف على قائمة المشكلات الحالية لدينا ومراجعة مناقشة القائمة البريدية.
يمكن إنشاء HTML المنسق للمسودة باستخدام bikeshed (انظر أدناه للحصول على تعليمات تثبيت bikeshed ):
$ bikeshed spec
قد ترغب أيضًا في استخدام وظيفة watch للتجديد تلقائيًا أثناء إجراء التغييرات:
$ bikeshed watch
راجع التعليمات الكاملة على https://tabatkins.github.io/bikeshed/#installing.
ستحتاج إلى تثبيت Python 3.7 أو إصدار أحدث. بمجرد تثبيت Python 3.7 أو إصدار أحدث، لتثبيت Bikeshed نفسه، قم بتشغيل ما يلي:
pip3 install bikeshed && bikeshed update
عند اكتمال ذلك، يجب تثبيت Bikeshed، ويجب أن يعمل أمر bikeshed في الصدفة الخاصة بك.
يتم نشر https://w3c.github.io/webauthn/ تلقائيًا من فرع gh-pages في كل دفعة إلى الفرع main ، باستخدام https://github.com/w3c/webauthn/blob/main/.github/workflows/ build-validate-publish.yml لتكوين سلوك النشر التلقائي.
لإنشاء WD جديد وتحميله إلى نظام النشر W3C:
bikeshed update
bikeshed spec
bikeshed echidna --u USERNAME --p PASSWORD --d DECISION_URL
سيقوم الأمر أعلاه بإنشاء كرة قطران من HTML والصور، وتحميلها إلى Echidna، نظام النشر الآلي لـ W3C. يجب أن يُرجع الأمر عنوان URL، والذي يمكنك من خلاله معرفة ما إذا كنت قد قمت بنشر المسودة بنجاح أم لا. يمكن أيضًا متابعة حالة الطلب من خلال أرشيف القائمة البريدية. يمكنك أيضًا استخدام W3C API كما هو موضح في وثائق Echidna. لاحظ أنه على نظام التشغيل Windows، سيعطي هذا خطأً حول الفشل في حذف ملف مؤقت لأنه قيد الاستخدام من خلال عملية مختلفة. هذا الخطأ غير ضار؛ يحدث بعد اكتمال التقديم.
إذا لم ينجح النشر خلال العملية، فمن المحتمل أن يكون ذلك بسبب Specbreus، وهو مدقق الامتثال للمواصفات. يعمل Echidna تلقائيًا عبر Specbreus وسيرفض النشر إذا أبلغ Specbreus عن أي خطأ. يمكنك تشغيل المستند الخاص بك من خلال Pubrules لفهم سبب رفض المستند الخاص بك. يمكنك تعديل ملف Index.bs أو ملف Index.html لضمان التوافق.
في أغلب الأحيان، سوف تكتشف أن أخطاء Pubrules ناتجة عن أخطاء في Bikeshed أو Specbreus. إذا كان الأمر كذلك، فسيتعين عليك تعديل ملف Index.html المترجم لتجاوز Echidna واستخدام العملية اليدوية للنشر. أثناء قيامك بتحرير ملف html لتجنب الأخطاء، يجب عليك أيضًا التحقق للتأكد من استمرار عرض المستند بشكل صحيح.
تتطلب العملية اليدوية منك أولاً إنشاء ملف tar. لإنشاء ملف tar، تحتاج أولاً إلى نسخ ملف Index.html وإعادة تسمية الملف المنسوخ باسم Overview.html. وذلك لأن Echidna لا يتعرف على ملف Index.html. يمكنك بعد ذلك استخدام الأمر التالي لإنشاء ملف tar:
tar -cvf WD.tar Overview.html image1 image2 image3
ثم يمكنك تشغيل الأمر التالي curl للنشر على Echidna (استخدم الأمر في نفس الدليل مثل ملف tar الخاص بك):
curl 'https://labs.w3.org/echidna/api/request' --user '<username>:<password>' -F "[email protected]" -F "decision=<decisionUrl>"
لا تتردد في الاتصال بكرسيك أو أي من موظفي W3C عندما تكون عالقًا. المعلومات العامة عن echidna موجودة هنا: https://github.com/w3c/echidna/wiki وهنا https://labs.w3.org/echidna/.
