Getting Started

Copie un prompt de configuración con los pasos de instalación y la guía de markdown completa para este plugin.

        Set up this Capacitor plugin in the project.

Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-verisoul`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/verisoul/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.

Instalar

Puedes utilizar nuestra configuración asistida por inteligencia artificial para instalar el complemento. Agrega las Capgo habilidades a tu herramienta de inteligencia artificial utilizando el siguiente comando:

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

Luego utiliza el siguiente prompt:

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

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

npm install @capgo/capacitor-verisoul
npx cap sync

Configurar Verisoul

Llamar configure() una vez, temprano en el arranque de tu aplicación. Utilice sandbox para pruebas y prod para el tráfico de producción.

import { Verisoul } from '@capgo/capacitor-verisoul';

await Verisoul.configure({
  environment: 'prod',
  projectId: 'YOUR_PROJECT_ID',
});

Obtener un ID de sesión

Después de que Verisoul haya recopilado suficientes señales nativas, solicite el ID de sesión y envíelo a su backend. Su backend debería llamar al servidor de Verisoul API para la evaluación de riesgo.

const { sessionId } = await Verisoul.getSessionId();

await fetch('/api/risk/verisoul', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ sessionId }),
});

Restablecer en cambios de cuenta

Llamar reinitialize() cuando cambia el contexto del usuario, como cuando se cierra sesión y luego se inicia sesión con otra cuenta.

await Verisoul.reinitialize();

Señales de toque de Android

En Android, envía eventos de toque cuando tu aplicación necesite la recopilación de patrones de Verisoul.

await Verisoul.recordTouchEvent({
  x: 120,
  y: 240,
  action: 'down',
});

Configuración de plataforma

Configuración de iOS cubre las notas de permiso de App Attest.
Configuración de Android cubre el repositorio Maven de Verisoul y los permisos.

Sigue adelante desde Getting Started

Si estás utilizando Getting Started para integrar sesiones de Verisoul, conecta con @capgo/capacitor-verisoul para el API resumen, Configuración de iOS para notas de App Attest, Configuración de Android para configuración de Gradle, y Usando @capgo/capacitor-verisoul para la tutoría del plugin.