webauthn
Web Authentication Candidate Recommendation (CR-00)
Este es el repositorio del Grupo de Trabajo WebAuthn del W3C, que produce el borrador de la especificación de "Autenticación Web" .
gh-pages de este repositorio.Para contribuir materialmente a esta especificación, debe cumplir con los requisitos descritos en CONTRIBUTING.md. Además, antes de enviar comentarios, familiarícese con nuestra lista de problemas actuales y revise la discusión de la lista de correo.
Se puede crear HTML formateado para el borrador usando bikeshed (consulte a continuación las instrucciones para la instalación bikeshed ):
$ bikeshed spec
Es posible que también desee utilizar la función watch para regenerarse automáticamente a medida que realiza cambios:
$ bikeshed watch
Consulte las instrucciones completas en https://tabatkins.github.io/bikeshed/#installing.
Necesitará tener instalado Python 3.7 o posterior. Una vez que tenga instalado Python 3.7 o posterior, para instalar Bikeshed, ejecute lo siguiente:
pip3 install bikeshed && bikeshed update
Cuando se haya completado, Bikeshed debería estar instalado y el comando bikeshed debería funcionar en su shell.
https://w3c.github.io/webauthn/ se publica automáticamente desde la rama gh-pages en cada envío a la rama main , usando https://github.com/w3c/webauthn/blob/main/.github/workflows/ build-validate-publish.yml para configurar el comportamiento de publicación automática.
Para crear un nuevo WD y cargarlo en el sistema de publicación W3C:
bikeshed update
bikeshed spec
bikeshed echidna --u USERNAME --p PASSWORD --d DECISION_URL
El comando anterior creará un archivo comprimido con el HTML y las imágenes, y lo cargará en Echidna, el sistema de publicación automatizado del W3C. El comando debe devolver una URL, a través de la cual puede saber si publicó correctamente el borrador. También se puede realizar un seguimiento del estado de la solicitud a través del Archivo de la lista de correo. También puede utilizar la API W3C como se describe en la documentación de Echidna. Tenga en cuenta que en Windows, esto generará un error acerca de que no se puede eliminar un archivo temporal porque está siendo utilizado por un proceso diferente. Este error es inofensivo; sucede después de que se haya completado el envío.
Si la publicación a través del proceso no tiene éxito, probablemente se deba a Specbreus, un verificador de cumplimiento de especificaciones. Echidna se ejecuta automáticamente a través de Specbreus y rechazará la publicación si Specbreus informa algún error. Puede ejecutar su documento a través de Pubrules para comprender por qué se rechaza su documento. Puede modificar el archivo index.bs o el archivo index.html para garantizar el cumplimiento.
La mayoría de las veces, descubrirá que los errores de Pubrules se deben a errores en Bikeshed o Specbreus. Si es así, deberá modificar el archivo index.html compilado para omitir Echidna y utilizar el proceso manual para publicar. Mientras edita el archivo html para evitar errores, también debe verificar que el documento aún se muestre correctamente.
El proceso manual requiere que primero cree un archivo tar. Para crear el archivo tar, primero debe copiar el archivo index.html y cambiar el nombre del archivo copiado a Overview.html. Esto se debe a que Echidna no reconoce index.html. Luego puede usar el siguiente comando para crear un archivo tar:
tar -cvf WD.tar Overview.html image1 image2 image3
Luego puede ejecutar el siguiente comando curl para publicar en Echidna (use el comando en el mismo directorio que su archivo tar):
curl 'https://labs.w3.org/echidna/api/request' --user '<username>:<password>' -F "[email protected]" -F "decision=<decisionUrl>"
No dude en ponerse en contacto con su presidente o con cualquier miembro del personal del W3C cuando esté estancado. La información general sobre equidna está aquí: https://github.com/w3c/echidna/wiki y aquí https://labs.w3.org/echidna/.
