Per iniziare

Copia un prompt di configurazione con i passaggi di installazione e la guida markdown completa per questo 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.

Installa

Puoi usare il nostro setup assistito dall'IA per installare il plugin. Aggiungi le skill Capgo al tuo strumento di IA usando il seguente comando:

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

Poi usa il seguente prompt:

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

Se preferisci la configurazione manuale, installa il plugin eseguendo questi comandi e segui le istruzioni specifiche per piattaforma qui sotto:

bun add @capgo/capacitor-verisoul
bunx cap sync

Avvio rapido

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

await Verisoul.configure({
  environment: 'dev',
  projectId: 'project-id-123',
});

Esempio: getSessionId

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

const result = await Verisoul.getSessionId();
console.log(result);

Esempio: reinizializzazione

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

await Verisoul.reinitialize();

Errori comuni

Inizializza una volta: esegui il setup durante il bootstrap dell'app.
Sync nativo: esegui bunx cap sync dopo gli aggiornamenti dei plugin.
Fonte di verità: fidati src/definitions.ts nel repo GitHub.

Configura Verisoul

Chiama configure() una sola volta, all'avvio dell'app. Usa sandbox per i test e prod per il traffico di produzione.

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

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

Ottieni un session ID

Dopo che Verisoul ha raccolto abbastanza segnali nativi, richiedi il session ID e invialo al tuo backend. Il tuo backend dovrà chiamare l'API server-side di Verisoul per la valutazione del rischio.

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

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

Reset in caso di modifiche all'account

Chiama reinitialize() quando il contesto utente cambia, ad esempio dopo un logout seguito dal login con un altro account.

await Verisoul.reinitialize();

Segnali touch su Android

Su Android, inoltra gli eventi touch quando la tua app richiede la raccolta dei pattern touch di Verisoul.

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

Configurazione della piattaforma

Setup iOS include note sull'entitlement App Attest.
Configurazione Android copre il repository Maven di Verisoul e i permessi.

Continua da Getting Started

Se stai usando Per iniziare per integrare le sessioni Verisoul, connettilo a @capgo/capacitor-verisoul per la panoramica su API, Setup iOS per le note su App Attest, Configurazione Android per la configurazione di Gradle, e Utilizzo di @capgo/capacitor-verisoul per il tutorial del plugin.