webauthn
Web Authentication Candidate Recommendation (CR-00)
นี่คือพื้นที่เก็บข้อมูลสำหรับ W3C WebAuthn Working Group ซึ่งสร้างข้อกำหนด "Web Authentication" แบบร่าง
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
คำสั่งด้านบนจะสร้าง tarball ของ HTML และรูปภาพ และอัปโหลดไปยัง Echidna ซึ่งเป็นระบบเผยแพร่อัตโนมัติของ W3C คำสั่งควรส่งคืน URL ซึ่งคุณจะทราบได้ว่าเผยแพร่ฉบับร่างสำเร็จหรือไม่ สถานะของคำขอสามารถติดตามได้ผ่านทาง Mailing List Archive คุณยังสามารถใช้ W3C API ตามที่อธิบายไว้ในเอกสารประกอบของ Echidna โปรดทราบว่าบน Windows สิ่งนี้จะทำให้เกิดข้อผิดพลาดเกี่ยวกับความล้มเหลวในการลบไฟล์ชั่วคราวเนื่องจากมีการใช้งานโดยกระบวนการอื่น ข้อผิดพลาดนี้ไม่เป็นอันตราย มันเกิดขึ้นหลังจากการส่งเสร็จสิ้น
หากการเผยแพร่ผ่านกระบวนการไม่ประสบผลสำเร็จ อาจเป็นเพราะ Specbreus ซึ่งเป็นเครื่องมือตรวจสอบการปฏิบัติตามข้อกำหนด Echidna ทำงานผ่าน Specbreus โดยอัตโนมัติ และจะปฏิเสธการตีพิมพ์หาก Specbreus รายงานข้อผิดพลาดใดๆ คุณสามารถเรียกใช้เอกสารของคุณผ่าน Pubrules เพื่อทำความเข้าใจว่าทำไมเอกสารของคุณจึงถูกปฏิเสธ คุณสามารถแก้ไขไฟล์ index.bs หรือไฟล์ index.html เพื่อให้มั่นใจว่าเป็นไปตามข้อกำหนด
บ่อยกว่านั้น คุณจะพบว่าข้อผิดพลาด Pubrules เกิดจากข้อบกพร่องใน Bikeshed หรือ Specbreus หากเป็นเช่นนั้น คุณจะต้องแก้ไขไฟล์ index.html ที่คอมไพล์แล้วเพื่อหลีกเลี่ยง Echidna และใช้กระบวนการแบบแมนนวลในการเผยแพร่ ขณะที่คุณกำลังแก้ไขไฟล์ html เพื่อหลีกเลี่ยงข้อผิดพลาด คุณควรตรวจสอบเพื่อให้แน่ใจว่าเอกสารยังคงแสดงผลได้อย่างถูกต้อง
กระบวนการที่ต้องดำเนินการด้วยตนเองกำหนดให้คุณต้องสร้างไฟล์ tar ก่อน ในการสร้างไฟล์ tar คุณต้องคัดลอกไฟล์ index.html ก่อน และเปลี่ยนชื่อไฟล์ที่คัดลอกเป็นภาพรวม.html เนื่องจากอีคิดน่าไม่รู้จักดัชนี.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 เมื่อคุณติดขัด ข้อมูลโดยรวมเกี่ยวกับตัวตุ่นอยู่ที่นี่: https://github.com/w3c/echidna/wiki และที่นี่ https://labs.w3.org/echidna/
