webauthn
Web Authentication Candidate Recommendation (CR-00)
Ini adalah gudang untuk Kelompok Kerja WebAuthn W3C, yang menghasilkan rancangan spesifikasi "Otentikasi Web" .
gh-pages repositori ini.Untuk berkontribusi secara material pada spesifikasi ini, Anda harus memenuhi persyaratan yang diuraikan dalam CONTRIBUTING.md. Selain itu, sebelum mengirimkan masukan, harap pelajari daftar masalah kami terkini dan tinjau diskusi milis.
Format HTML untuk draf dapat dibuat menggunakan bikeshed (lihat di bawah untuk petunjuk pemasangan bikeshed ):
$ bikeshed spec
Anda mungkin juga ingin menggunakan fungsi watch untuk membuat ulang secara otomatis saat Anda melakukan perubahan:
$ bikeshed watch
Lihat petunjuk lengkapnya di https://tabatkins.github.io/bikeshed/#installing.
Anda harus menginstal Python 3.7 atau lebih baru. Setelah Anda menginstal Python 3.7 atau lebih baru, untuk menginstal Bikeshed itu sendiri, jalankan perintah berikut:
pip3 install bikeshed && bikeshed update
Ketika sudah selesai, Bikeshed harus diinstal, dan perintah bikeshed seharusnya bekerja di shell Anda.
https://w3c.github.io/webauthn/ diterbitkan secara otomatis dari cabang gh-pages pada setiap push ke cabang main , menggunakan https://github.com/w3c/webauthn/blob/main/.github/workflows/ build-validate-publish.yml untuk mengonfigurasi perilaku penerbitan otomatis.
Untuk membuat WD baru dan mengunggahnya ke sistem penerbitan W3C:
bikeshed update
bikeshed spec
bikeshed echidna --u USERNAME --p PASSWORD --d DECISION_URL
Perintah di atas akan membuat tarball HTML dan gambar, dan diunggah ke Echidna, sistem penerbitan otomatis W3C. Perintah tersebut harus mengembalikan url, yang melaluinya Anda dapat mengetahui apakah Anda berhasil menerbitkan draf tersebut. Status permintaan juga dapat dilacak melalui Arsip Milis. Anda juga dapat menggunakan API W3C seperti yang dijelaskan dalam dokumentasi Echidna. Perhatikan bahwa pada Windows, ini akan memberikan kesalahan tentang kegagalan menghapus file sementara karena sedang digunakan oleh proses yang berbeda. Kesalahan ini tidak berbahaya; itu terjadi setelah penyerahan selesai.
Jika publikasi melalui proses tersebut tidak berhasil, kemungkinan besar disebabkan oleh Specbreus, pemeriksa kepatuhan spesifikasi. Echidna secara otomatis berjalan melalui Specbreus dan akan menolak publikasi jika ada kesalahan yang dilaporkan oleh Specbreus. Anda dapat menjalankan dokumen Anda melalui Pubrules untuk memahami mengapa dokumen Anda ditolak. Anda dapat memodifikasi file index.bs atau file index.html untuk memastikan kepatuhan.
Lebih sering daripada tidak, Anda akan menemukan kesalahan Pubrules disebabkan oleh bug di Bikeshed atau Specbreus. Jika demikian, Anda harus memodifikasi file index.html yang telah dikompilasi untuk melewati Echidna dan menggunakan proses manual untuk mempublikasikannya. Saat Anda mengedit file html untuk menghindari kesalahan, Anda juga harus memeriksa untuk memastikan dokumen masih ditampilkan dengan benar.
Proses manualnya mengharuskan Anda membuat file tar terlebih dahulu. Untuk membuat file tar, Anda perlu menyalin file index.html terlebih dahulu dan mengganti nama file yang disalin menjadi Ikhtisar.html. Ini karena Echidna tidak mengenali index.html. Anda kemudian dapat menggunakan perintah berikut untuk membuat file tar:
tar -cvf WD.tar Overview.html image1 image2 image3
Kemudian Anda dapat menjalankan perintah curl berikut untuk mempublikasikan ke Echidna (gunakan perintah di direktori yang sama dengan file tar Anda):
curl 'https://labs.w3.org/echidna/api/request' --user '<username>:<password>' -F "[email protected]" -F "decision=<decisionUrl>"
Jangan ragu untuk menghubungi ketua Anda atau staf W3C mana pun jika Anda mengalami kebuntuan. Info keseluruhan tentang echidna ada di sini: https://github.com/w3c/echidna/wiki dan di sini https://labs.w3.org/echidna/.
