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

사이트 키를 구성하세요

Google Cloud reCAPTCHA에서 플랫폼 키를 생성한 후에 __CAPGO_KEEP_0__에 추가하세요. 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 직접 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() 복사

호출합니다.

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

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

안드로이드 및 iOS에서 구글의 네이티브 모바일 SDK 경로는 기업용 모바일 전용입니다. enterprise: false 네이티브 플랫폼에서 전달하는 것은 거부되므로 표준 웹 v3 키가 의도치 않게 사용되지 않습니다.

이동 노트

플러그인은 Cordova 옵션의 구버전을 지원합니다. sitekeyAndroid 또는 sitekeyWeb 콜 옵션과 Capacitor 구성에서 구버전을 지원합니다. 또한 sitekeyIos 또는 sitekeyIOS iOS로의 마이그레이션에 대한 별칭으로 사용하세요. 새로운 code에 대해 Capacitor config 이름을 선호하세요.

시작하기

시작하기 시작하기 인증 및 계정 흐름을 계획하고 사용하는 경우 __CAPGO_KEEP_0__-recaptcha와 연결하세요. capgo-recaptcha를 사용하여 native capability를 구현하는 경우 capgo/capacitor-recaptcha를 사용하세요. capgo/capacitor-social-login을 사용하여 capgo/capacitor-social-login의 구현 세부 정보를 구현하세요. capgo/capacitor-passkey를 사용하여 capgo/capacitor-passkey의 구현 세부 정보를 구현하세요. capgo/capacitor-recaptcha를 사용하여 native capability를 구현하는 경우 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 두 단계 인증 두 단계 인증 구현 세부 사항