iOS 配置

站点密钥

在 Google Cloud reCAPTCHA 中创建 iOS 移动应用密钥。注册 Capacitor 应用使用的 bundle identifier，然后在以下位置设置该密钥： capacitor.config.ts.

iOS 使用 Google 的 RecaptchaEnterprise 移动端 SDK。在此插件中，常规的非 Enterprise 版 reCAPTCHA v3 仅支持 Web 端； enterprise: false 在 iOS 上会被拒绝。

import type { CapacitorConfig } from '@capacitor/cli';
import '@capgo/capacitor-recaptcha';

const config: CapacitorConfig = {
  plugins: {
    Recaptcha: {
      iosSiteKey: 'IOS_SITE_KEY',
    },
  },
};

export default config;

依赖项

该插件随附 CocoaPods 和 Swift Package Manager 元数据，适用于 Google 的 RecaptchaEnterprise iOS SDK。运行 npx cap sync ios 通过你选择的 Capacitor iOS 工作流安装原生依赖。

执行

import { Recaptcha } from '@capgo/capacitor-recaptcha';

const { token } = await Recaptcha.execute({
  action: 'password_reset',
  timeout: 10000,
});

立即将 token 发送到后端，在接受受保护的请求之前创建 reCAPTCHA 评估。

从 iOS Setup 继续

如果你正在使用 iOS 配置 用来规划身份验证和账户流程，并将它与 使用 @capgo/capacitor-recaptcha 关于使用 @capgo/capacitor-recaptcha 时的原生能力， @capgo/capacitor-social-login 在 @capgo/capacitor-social-login 中查看实现细节， @capgo/capacitor-passkey 有关 @capgo/capacitor-passkey 的实现细节， @capgo/capacitor-native-biometric 以及 @capgo/capacitor-native-biometric 中的实现细节， 双因素认证 有关双重身份验证的实现细节。