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 prefiere la configuración manual, instale el plugin ejecutando los siguientes comandos y siga las instrucciones específicas del plataforma a continuación:

npm install @capgo/capacitor-verisoul
npx cap sync

Configurar Verisoul

Llamar configure() una vez, temprano en el arranque de su aplicación. Utilice sandbox para la prueba 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 debe 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 }),
});

Reiniciar en cambios de cuenta

Llamar reinitialize() cuando cambian los contextos del usuario, como salir e iniciar sesión con otra cuenta.

await Verisoul.reinitialize();

Señales de tacto de Android

En Android, envía eventos de tacto 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 incluye notas sobre la titularidad de App Attest.
Configuración de Android incluye la Verisoul Maven repository y permisos.

Sigue adelante desde Inicio

If estás utilizando Getting Started para integrar sesiones de Verisoul, conecta con @capgo/capacitor-verisoul para la visión general de API Configuración de iOS para notas de App Attest Configuración de Android para configuración de Gradle Usando @capgo/capacitor-verisoul para el tutorial del plugin