webauthn

웹 인증 사양

이는 "웹 인증" 사양 초안을 작성하는 W3C WebAuthn 작업 그룹의 저장소입니다.

• 편집자의 사본은 https://w3c.github.io/webauthn/ 또는 이 저장소의 gh-pages 분기에서 사용할 수 있습니다.
  • 현재 공식적으로 게시된 작업 초안 스냅샷은 https://www.w3.org/TR/webauthn/에 있습니다.
• 빌드 기록은 저장소 작업 탭에서 확인할 수 있습니다.
• W3C WebAuthn 블로그
• 웹 플랫폼 테스트 저장소

기여

이 사양에 실질적으로 기여하려면 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/은 https://github.com/w3c/webauthn/blob/main/.github/workflows/를 사용하여 main 분기로 푸시할 때마다 gh-pages 분기에서 자동 게시됩니다. build-validate-publish.yml을 사용하여 자동 게시 동작을 구성합니다.

새로운 작업 초안 작성

새 WD를 제작하여 W3C 게시 시스템에 업로드하려면:

• W3C 회원으로 등록하고 웹 인증 워킹 그룹에 참여하세요. 아래 명령에 사용할 W3C USERNAME 및 PASSWORD를 기록해 두세요. 둘 중 하나도 기억나지 않으면 여기로 가서 검색하세요.
• 작업 그룹이 새로운 초안을 게시하기로 결정한 회의록의 URL을 DECISION_URL로 복사하여 아래에 사용하세요.
• 자전거 창고가 로컬에 설치되어 있는지 확인하세요(위의 자전거 창고 설치 및 설정 섹션을 따르세요).
• ./bikeshed 디렉토리로 이동하여 git pull을 사용하여 Bikeshed를 업데이트합니다.
• Bikeshed의 데이터 파일을 업데이트하려면 다음 명령을 실행하십시오.

 bikeshed update

• Bikeshed 메타데이터를 편집하여 상태를 ED에서 WD로 변경합니다(이 변경 사항을 커밋하지 마세요).
• 다음 명령을 실행하여 Bikeshed가 오류나 경고 없이 컴파일될 수 있는지 확인하세요.

 bikeshed spec

• 다음을 사용하여 새 초안을 빌드하고 업로드하세요.

 bikeshed echidna --u USERNAME --p PASSWORD --d DECISION_URL

위의 명령은 HTML과 이미지의 타르볼을 생성하고 W3C의 자동 게시 시스템인 Echidna에 업로드합니다. 이 명령은 초안을 성공적으로 게시했는지 여부를 알 수 있는 URL을 반환해야 합니다. 요청 상태는 메일링 리스트 아카이브를 통해서도 추적할 수 있습니다. Echidna 문서에 설명된 대로 W3C API를 사용할 수도 있습니다. 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

그런 다음 다음 명령을 실행하여 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/에 있습니다.

회의록 작성

• W3C 가이드북의 지침을 필기하세요
• XML 보안 WG의 대체 지침