WebAuthn timeout 参数的作用
webauthn（web authentication api）作为一种现代的、无密码的认证标准，允许用户通过生物识别（如指纹、面部识别）或硬件安全密钥进行身份验证。在webauthn的凭证创建（navigator.credentials.create）或获取（navigator.credentials.get）过程中，publickeycredentialcreationoptions 或 publickeycredentialrequestoptions 对象中包含一个关键参数 timeout。
timeout 参数用于指定用户完成认证操作的最长时间（以毫秒为单位）。如果用户未能在指定时间内完成操作（例如，未在指纹传感器上放置手指，或未完成面部识别），认证请求应自动终止并返回超时错误。这对于提升用户体验和系统安全性至关重要，可以避免请求长时间挂起，并限制攻击者尝试认证的时间。
以下是一个典型的WebAuthn凭证创建请求的publicKey配置示例，其中包含了timeout参数：
const publicKey = {
"challenge": "testchanllengevalue",
"rp": { "name": "test.com" },
"user": {
"id": "12345-543212-12345-54321",
"name": "NAME",
"displayName": "NAME"
},
"attestation": "direct",
"timeout": 20000, // 期望的超时时间，单位毫秒
"authenticatorSelection": {
"authenticatorAttachment": "platform",
"requireResidentKey": false,
"userVerification": "required"
},
"pubKeyCredParams": [
{ "type": "public-key", "alg": -7 },
{ "type": "public-key", "alg": -257 }
]
};
// 调用WebAuthn API
navigator.credentials.create({ 'publicKey': publicKey })
.then(credential => {
console.log("凭证创建成功:", credential);
})
.catch(error => {
console.error("凭证创建失败:", error);
// 处理超时错误，例如：if (error.name === "TimeoutError") { ... }
});移动设备上的超时行为差异及原因
尽管上述timeout参数在桌面浏览器上通常能按预期工作，即在指定时间后终止请求，但在某些移动设备上，尤其是在旧版本的Android系统上，开发者可能会观察到该参数无效，认证请求会无限期地等待用户操作，直到用户手动取消或完成。
原因分析：Android平台与Google Play服务
这一行为差异主要源于Android平台上WebAuthn操作的底层实现机制。对于Android 14之前的版本，WebAuthn相关的操作（如指纹识别、面部识别等）通常由Google Play服务（Play Services）进行处理和协调。然而，Play Services在设计上并不完全支持WebAuthn规范中的timeout参数。这意味着，即使在publicKey对象中明确设置了timeout值，Play Services也可能不会强制执行这个时间限制，导致认证请求持续等待。
随着Android系统的演进，WebAuthn的底层实现也在不断优化。在Android 14及更高版本中，WebAuthn操作的处理方式可能有所改变，从而改善了对timeout参数的支持。因此，这种不一致性在较新的Android设备上可能不再是问题，但在仍有大量旧版Android设备在使用的今天，开发者仍需注意此兼容性问题。
WebAuthn timeout 值的最佳实践
除了兼容性问题，timeout参数的数值选择也至关重要。在上述示例中，20000毫秒（即20秒）的超时时间可能仅用于演示目的，但在实际生产环境中，这个值通常过短。
WebAuthn规范（W3C Web Authentication: An API for accessing Public Key Credentials Level 3）对timeout值的推荐如下：
- 最低推荐值： 规范建议timeout值至少为五分钟（300,000毫秒）。
- 设计考量： timeout的值应反映依赖方（RP，即你的网站或应用）愿意信任其他认证因素（在二次认证中）或能够建立挑战有效性（在所有模式中）的时间。
- 用户体验： 给予用户足够的时间来完成认证操作，例如找到他们的安全密钥、完成生物识别扫描或输入PIN码。过短的超时时间会导致用户体验不佳，频繁出现超时错误。
- 安全性： 适当的超时时间可以平衡用户便利性和安全性。虽然过长的超时可能增加潜在攻击窗口，但WebAuthn机制本身已通过挑战（challenge）等方式提供了强大的安全保障。
修正后的 timeout 示例：
const publicKey = {
// ... 其他参数保持不变 ...
"timeout": 300000, // 推荐设置为至少五分钟 (300,000 毫秒)
// ...
};注意事项与总结
- 移动设备兼容性： 在设计WebAuthn认证流程时，请务必考虑到Android 14之前设备上timeout参数可能无效的问题。这意味着你的应用需要能够优雅地处理用户可能长时间未响应的情况，而不仅仅依赖于timeout来终止操作。
- 用户引导： 即使timeout参数有效，也应提供清晰的用户指引，告知用户需要执行的操作以及预期等待时间，以减少用户的困惑。
- 后端超时： 除了前端的timeout设置，你的后端服务也应该有相应的超时机制，以防止WebAuthn请求在服务器端无限期挂起。
- 持续关注规范更新： WebAuthn规范和各平台实现都在不断发展。开发者应持续关注最新的规范文档和平台更新日志，以便及时调整实现策略。
综上所述，WebAuthn的timeout参数是优化认证流程的关键组成部分，但在跨平台尤其是移动端（Android
