Configuración inicial

Instalar

Puede utilizar nuestra configuración asistida por IA para instalar el plugin. Agregue las Capgo habilidades a su herramienta de IA mediante el siguiente comando:

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

Luego utilice el siguiente prompt:

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

Si prefiere la configuración manual, instale el complemento ejecutando los siguientes comandos y siga las instrucciones específicas de la plataforma a continuación:

bun add @capgo/capacitor-recaptcha
bunx cap sync

Configura Claves de Sitio

Crea claves de plataforma en Google Cloud reCAPTCHA, luego agrega las 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, iosSiteKey, y webSiteKey sobreescribir la clave compartida siteKeyPuedes pasar una siteKey directamente a load() o execute() Configura una clave cuando la clave depende de tu entorno.

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() llamadas load() automáticamente cuando el cliente no está listo, por lo que un paso de carga explícita es opcional.

reCAPTCHA v3 de estándar web

Establecer enterprise: false Cargar el script de reCAPTCHA Web estándar v3 de 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 En Android e iOS, el camino nativo móvil de Google es solo de empresa/móvil. Pasar

Notas de Migración

Acepta el plugin las antiguas opciones de alias de Cordova sitekeyAndroid y sitekeyWeb en opciones de llamada y Capacitor configuración. También acepta sitekeyIos y sitekeyIOS como alias de migración de iOS. Prefiere los nombres de configuración Capacitor para nuevos code.

Sigue adelante desde Getting Started

Si estás utilizando Getting Started para planificar flujos de autenticación y cuentas, conecta con Usando @capgo/capacitor-recaptcha para la capacidad nativa en Usando @capgo/capacitor-recaptcha, @capgo/capacitor-login-social para los detalles de implementación en @capgo/capacitor-login-social @capgo/capacitor-clave-llave para los detalles de implementación en @capgo/capacitor-clave-llave @capgo/capacitor-biometría-nativa para los detalles de implementación en @capgo/capacitor-biometría-nativa, y autenticación de dos factores para los detalles de implementación en autenticación de dos factores.