Getting Started

설치

Capgo의 AI-Assisted Setup을 사용하여 플러그인을 설치할 수 있습니다. 다음 명령어를 사용하여 AI 도구에 Capgo 기능을 추가하세요:

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을 선호하시면, 플러그인을 설치하기 위해 다음 명령어를 실행하고 아래의 플랫폼별 지침을 따르세요:

npm install @capgo/capacitor-recaptcha
npx cap sync

사이트 키 구성

클립보드에 복사 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. 환경에 따라 키가 의존하는 경우 직접 siteKey or load() 클라이언트가 준비되지 않은 경우 자동으로 호출되므로 명시적 프리로드 단계는 선택적입니다. 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() 클라이언트가 준비되지 않은 경우 자동으로 호출되므로 명시적 프리로드 단계는 선택적입니다. load() 웹 표준 reCAPTCHA v3

override the shared

설정 enterprise: false Google의 표준 Web reCAPTCHA v3 스크립트를 로드합니다.

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

Android 및 iOS에서 Google의 네이티브 모바일 SDK 경로는 Enterprise/mobile 전용입니다. 네이티브 플랫폼에서 전달하는 것은 거부되므로 표준 Web v3 키가 실수로 사용되지 않도록 합니다. enterprise: false 이동 노트

이동 노트

콜 옵션과 __CAPGO_KEEP_0__ 구성에서 sitekeyAndroid 또한 sitekeyWeb in call options and Capacitor config. It also accepts sitekeyIos targetLanguage sitekeyIOS iOS 마이그레이션에 대한 별칭으로 사용합니다. 새로운 Capacitor 설정 이름을 code로 선호합니다.

시작하기

시작하기를 계속하세요 __CAPGO_KEEP_0__을 사용 중이시면 __CAPGO_KEEP_0__을 사용하여 인증 및 계정 흐름을 계획하고 capgo/capacitor-recaptcha를 사용하여 capgo/capacitor-recaptcha의 네이티브 기능을 사용하는 경우 capgo/capacitor-social-login을 사용하여 capgo/capacitor-social-login의 구현 세부 정보를 사용하는 경우 capgo/capacitor-passkey를 사용하여 capgo/capacitor-passkey의 구현 세부 정보를 사용하는 경우 @capgo/capacitor-native-생체인식 implementation 세부 사항에 대한 @capgo/capacitor-native-생체인식, 그리고 두 단계 인증 두 단계 인증의 implementation 세부 사항에 대한.