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

Puede utilizar nuestra configuración asistida por IA para instalar el plugin. Agregue las Capgo habilidades a su herramienta de IA utilizando 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-verisoul` plugin in my project.

Si prefieres la configuración manual, instala el plugin 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. Utiliza 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 cambien los contextos del usuario, como salir e iniciar sesión como otra cuenta.

await Verisoul.reinitialize();

Señales de toque de Android

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

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

Configuración de la plataforma

Configuración de iOS cubre notas sobre la concesión de App Attest.
Configuración de Android cubre el repositorio Maven de Verisoul y las permisos.

Sigue adelante desde Inicio rápido

Si estás utilizando Inicio rápido para integrar sesiones de Verisoul, conecta con @capgo/capacitor-verisoul para la API vista general, configuración de iOS para notas de App Attest, configuración de Android para la configuración de Gradle, y Usando @capgo/capacitor-verisoul para el tutorial del plugin.