スタートガイド

インストール

CapgoのAI-Assistedセットアップを使用してプラグインをインストールできます。次のコマンドを使用して、CapgoスキルをAIツールに追加します。

npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

次に、以下のプロンプトを使用してください。

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-recaptcha` plugin in my project.

Manual Setupを選択する場合は、以下のコマンドを実行して、以下のプラットフォーム固有の指示に従ってください。

bun add @capgo/capacitor-recaptcha
bunx cap sync

サイトキーを設定

Google Cloud reCAPTCHAでプラットフォームキーを作成し、次にCapgoに追加してください capacitor.config.ts.

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

const config: CapacitorConfig = {
  appId: 'com.example.app',
  appName: 'Example',
  webDir: 'dist',
  plugins: {
    Recaptcha: {
      androidSiteKey: 'ANDROID_SITE_KEY',
      iosSiteKey: 'IOS_SITE_KEY',
      webSiteKey: 'WEB_SITE_KEY',
      enterprise: true,
    },
  },
};

export default config;

androidSiteKey, iosSiteKey、 webSiteKey 共有設定を上書きします。 siteKeyもしくは、HTMLのテキストフラグメントを直接渡すこともできます。 siteKey または load() or execute() トークンを生成

「トークンを生成」セクション

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

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

await fetch('/api/recaptcha-assessment', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({ token, action: 'login' }),
});

execute() calls load() Web標準 reCAPTCHA v3

「Web標準 reCAPTCHA v3」セクション

設定 enterprise: false Googleの標準Web reCAPTCHA v3スクリプトをロードする

const { token } = await Recaptcha.execute({
  siteKey: 'WEB_V3_SITE_KEY',
  enterprise: false,
  action: 'signup',
});

AndroidおよびiOSでは、GoogleのネイティブモバイルSDKパスはエンタープライズ/モバイルのみです。SDKをパスする enterprise: false 移行ノート

移行ノート

そして sitekeyAndroid and sitekeyWeb 新しい__CAPGO_KEEP_1__のためにCapacitorの設定名を優先する sitekeyIos and sitekeyIOS iOS マイグレーションエイリアスとして。新しい code の Capacitor 設定名を使用することをお勧めします。

次に進む

あなたが使用している スタートガイド 認証とアカウントフローの計画に使用している場合 Using @capgo/capacitor-recaptcha native capabilityの@capgo/capacitor-recaptcha Using @capgo/capacitor-recaptcha @capgo/capacitor-recaptchaの実装詳細 Using @capgo/capacitor-social-login @capgo/capacitor-social-loginの実装詳細 Using @capgo/capacitor-passkey @capgo/capacitor-native-biometric 二要素認証 Two-factor authentication