Inizio

Installazione

npm install @capgo/capacitor-recaptcha
npx cap sync

Configura le chiavi del sito

Crea le chiavi del platform in Google Cloud reCAPTCHA, quindi aggiungile a 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, iosSiteKeye webSiteKey sovrascrive la condivisione siteKey. Puoi anche passare un siteKey direttamente a load() o execute() quando la chiave dipende dal tuo ambiente.

Genera un Token

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() chiama load() automaticamente quando il client non è pronto, quindi un passo di preload esplicito è facoltativo.

Standard reCAPTCHA v3 Web

Impostazione enterprise: false per caricare lo script standard Web reCAPTCHA v3 di Google.

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

On Android and iOS, Google’s native mobile SDK path is Enterprise/mobile only. Passing enterprise: false su piattaforme native è rifiutato, quindi una chiave standard Web v3 non viene utilizzata accidentalmente.

Nota di migrazione

Il plugin accetta gli alias delle vecchie opzioni Cordova sitekeyAndroid e sitekeyWeb nelle opzioni di chiamata e nella Capacitor configurazione. Anche accetta sitekeyIos Eseguire come alias di migrazione per iOS. Preferisci i nomi di configurazione __CAPGO_KEEP_0__ per nuovi __CAPGO_KEEP_1__. sitekeyIOS as iOS migration aliases. Prefer the Capacitor config names for new code.

Sottosezione intitolata “Continua da Inizia”

Inizia per pianificare l'autenticazione e le flussi di account, connettilo con Utilizzare @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-recaptcha per la capacità nativa in Utilizzare @capgo/capacitor-recaptcha, @capgo/capacitor-social-login per il dettaglio di implementazione in @capgo/capacitor-social-login, @capgo/capacitor-passkey per il dettaglio di implementazione in @capgo/capacitor-passkey per i dettagli di implementazione in @capgo/capacitor-passkey, @capgo/capacitor-native-biometric per i dettagli di implementazione in @capgo/capacitor-native-biometric, e Autenticazione a due fattori per i dettagli di implementazione in Autenticazione a due fattori.