跳转到正文

@capgo/capacitor-passkey

在 Capacitor 应用中保留浏览器风格的 WebAuthn code,同时由插件处理原生 passkey 调用和原生宿主补丁。

浏览器风格的 API

保留 navigator.credentials.create() 以及 navigator.credentials.get() 在应用中使用,而无需围绕自定义 API 重写 passkey 流程。

极少的应用改动

只需配置一次插件,然后调用 CapacitorPasskey.autoShimWebAuthn() 在 bootstrap 期间调用,并让 WebAuthn code 的其余部分尽量贴近浏览器实现。

构建时的原生配置

插件会在 sync 期间修补生成的 iOS 和 Android 宿主项目,因此您无需再反复手动编辑这些文件。

  • shimWebAuthn(options?) 立即安装浏览器风格的 shim,并支持可选的 HTTPS origin 覆盖。
  • getConfiguration() 从以下路径读取解析后的运行时配置: plugins.CapacitorPasskey.
  • autoShimWebAuthn(options?) 读取该配置并在应用启动阶段一步完成 shim 的安装。
  • createCredential(options) 以及 getCredential(options) 使用 JSON 安全的 WebAuthn 负载直接调用原生 passkey API。
  • isSupported() 报告运行时可用性并 getPluginVersion() 返回原生实现的版本标记。

如果你正在使用 @capgo/capacitor-passkey 用来规划身份验证和账户流程,并将它与 使用 @capgo/capacitor-passkey 在“使用 @capgo/capacitor-passkey”中了解原生能力, @capgo/capacitor-social-login 在 @capgo/capacitor-social-login 中查看实现细节, @capgo/capacitor-native-biometric 有关 @capgo/capacitor-native-biometric 的实现细节, 双因素认证 有关双因素认证的实现细节,以及 SSO (企业版) 有关 SSO (Enterprise) 的实现细节。