跳转到正文

后端说明

GitHub

您的后端仍然负责标准的 WebAuthn 流程:

  • 生成注册和认证挑战
  • 验证证明和断言响应
  • 执行依赖方 ID 和挑战验证
  • 像浏览器流程一样存储凭据和计数器

该插件旨在保留现有 WebAuthn code 的前端结构。

  • 在 Web 端,它会转发到真实的浏览器 WebAuthn API。
  • 在原生 Capacitor 上,它返回由原生 passkey API 支持的类浏览器凭证对象。
  • 您的后端可以继续使用相同的 challenge 和验证 pipeline。

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 生态

如果你的后端已经返回 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 中的实现细节, 双因素认证 有关双重身份验证的实现细节。