本项目是一份面向 Web 开发者的中文学习文档：整理翻译 WebAuthn Level 2 的核心内容，并配上独立讲解与示例代码。它不是 W3C 授权译本，不是完整逐字翻译，也不构成新的技术规范。
整理与链接核对日期：2026 年 10 月 16 日。若中文解释与规范产生歧义，以对应英文版本为准。浏览器能力和第三方库 API 应按各自版本再次核对。
主规范与原始入口#
| 来源 | 版本与用途 |
|---|---|
| 用户提供的英文入口 §1.2.2 Authentication | 完整保留最初链接，含其原始查询参数 |
| WebAuthn Level 2 | W3C Recommendation，2021-04-08；本文主要整理翻译来源 |
| Level 2 固定版本 | 对照历史语境时使用的不可变版本入口 |
| Level 2 Errata | 发布后的勘误；请同时检查规范首页所指向的最新勘误入口 |
| WebAuthn Level 3 | 现代补充来源；核对时首页标示 W3C Recommendation，2026-08-25 |
| Level 3 固定版本 | 本次补充所参考的发布版本 |
| 编辑草案 | 可能持续变化；不能与上述发布版不加区分地引用 |
如何区分文档内容#
**“中文释义”按对应原文重述核心意思，允许调整句式以方便学习。“开发讲解”解释工程上的原因、误区与取舍。“现代补充”**说明 L2 之后的 Passkey 实践或 L3 能力。代码示例用于演示学习，不是规范原文的逐行复刻。
规范中的浏览器内部算法和认证器操作，被整理为职责、数据结构与原文导航；没有声称全部翻译。设备证明格式、扩展和自动化的深层细节请通过章节对照回到原文。
示例与延伸阅读#
- SimpleWebAuthn Server 官方文档：配套示例的服务端验证库及其当前参数。
- SimpleWebAuthn Browser 官方文档：浏览器封装 API、JSON 转换和条件式 UI 的相关说明。
- SimpleWebAuthn 源码：核对版本行为、测试与问题。
- FIDO Alliance：Passkeys：Passkey 术语、生态和背景。
- Chrome for Developers：Passkeys：浏览器端的实现与调试资料。
- Cloudflare Pages Direct Upload：本文静态文档站的部署方式。
本站的学习代码及运行说明可以从完整示例进入。站点本身没有收集、注册或验证读者真实凭据的线上账号系统。
W3C 归属与许可#
本文包含从 Web Authentication: An API for accessing Public Key Credentials — Level 2 复制、翻译或派生的材料；原规范状态为 W3C Recommendation，2021 年 4 月 8 日。
Copyright © 2021 W3C® (MIT, ERCIM, Keio, Beihang). This software or document includes material copied from or derived from Web Authentication: An API for accessing Public Key Credentials — Level 2, https://www.w3.org/TR/webauthn-2/.
保留原作者版权声明：Copyright © 2021 W3C (World Wide Web Consortium)® (MIT (Massachusetts Institute of Technology), ERCIM (European Research Consortium for Informatics and Mathematics), Keio, Beihang). W3C liability、trademark 和 document use 规则适用。原文的规范、状态和完整归属可在英文版首页查看。
现代补充也参考 WebAuthn Level 3。Copyright © 2026 World Wide Web Consortium. This document includes material derived from Web Authentication: An API for accessing Public Key Credentials — Level 3. 参见 W3C document license。
此中文指南用于帮助实现和学习配套软件，不作为替代 W3C 英文规范的技术标准，也不表示得到 W3C 或任何浏览器、认证器厂商的认可。原规范按其许可中列明的条件与免责声明提供。