后端说明
复制包含安装步骤和该插件完整 Markdown 指南的配置 prompt。
您的后端仍然负责标准的 WebAuthn 流程:
- 生成注册和认证挑战
- 验证证明和断言响应
- 执行依赖方 ID 和挑战验证
- 像浏览器流程一样存储凭据和计数器
保持不变的部分
标题为“保持不变的部分”的章节该插件旨在保留现有 WebAuthn code 的前端结构。
- 在 Web 端,它会转发到真实的浏览器 WebAuthn API。
- 在原生 Capacitor 上,它返回由原生 passkey API 支持的类浏览器凭证对象。
- 您的后端可以继续使用相同的 challenge 和验证 pipeline。
Android 端的变更
标题为“Android 上的变化”的章节Android 原生 passkey 与浏览器的信任模型并不完全相同。
- Digital Asset Links 允许 Android 与您的网站共享相同的 relying party 和凭证生态系统。
- 字面量
clientDataJSON.origin值仍可能与网站 origin 不同。 - 如果您的服务器拒绝除以下之外的任何内容:
https://your-domain,即使 passkey 本身有效,Android 原生断言也可能失败。
推荐的后端规则
标题为“推荐的后端规则”的章节在支持 Android 原生 passkey 时,请为同一 Relying Party 允许预期的浏览器 Origin 和预期的 Android 应用 Origin。
这样你就能获得:
- 网站的浏览器支持
- Capacitor 应用中的原生 passkey 支持
- 同一 Relying Party 域名下的统一 passkey 生态
如果需要直接发起 JSON 安全调用
标题为“如果你需要直接发起 JSON 安全调用”的章节如果你的后端已经返回 PublicKeyCredentialCreationOptionsJSON 以及 PublicKeyCredentialRequestOptionsJSON,你也可以直接使用 API 插件,而无需使用浏览器风格的 shim:
import { CapacitorPasskey } from '@capgo/capacitor-passkey';
const registration = await CapacitorPasskey.createCredential({ origin: 'https://signin.example.com', publicKey: registrationOptionsFromBackend,});
const authentication = await CapacitorPasskey.getCredential({ origin: 'https://signin.example.com', publicKey: requestOptionsFromBackend,});继续阅读后端注意事项
章节标题为“从 Backend Notes 继续”如果你正在使用 后端说明 用来规划身份验证和账户流程,并将它与 使用 @capgo/capacitor-passkey 在“使用 @capgo/capacitor-passkey”中了解原生能力, @capgo/capacitor-social-login 在 @capgo/capacitor-social-login 中查看实现细节, @capgo/capacitor-passkey 有关 @capgo/capacitor-passkey 的实现细节, @capgo/capacitor-native-biometric 以及 @capgo/capacitor-native-biometric 中的实现细节, 双因素认证 有关双重身份验证的实现细节。