Getting Started

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 utilizzare la nostra configurazione assistita dall'IA per installare il plugin. Aggiungi le Capgo abilità al tuo strumento di AI utilizzando il seguente comando:

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

Poi utilizza la seguente richiesta:

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

Se preferisci l'installazione manuale, installa il plugin eseguendo i seguenti comandi e segui le istruzioni specifiche per la piattaforma riportate di seguito:

npm install @capgo/capacitor-verisoul
npx cap sync

Configura Verisoul

Chiamata configure() una volta, all'inizio dell'avvio dell'applicazione. Utilizza sandbox per le prove e prod per il traffico di produzione.

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

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

Ottieni un ID di sessione

Dopo che Verisoul ha raccolto abbastanza segnali nativi, richiedere l'ID di sessione e inviarlo al tuo backend. Il tuo backend dovrebbe chiamare il server di Verisoul API per l'analisi del rischio.

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

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

Ripristina alle modifiche dell'account

Chiamata reinitialize() quando cambia il contesto dell'utente, come logout seguito da login come un altro account.

await Verisoul.reinitialize();

Segnali di tocco Android

Su Android, invia gli eventi di tocco quando il tuo app ha bisogno della raccolta dei modelli di tocco di Verisoul.

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

Impostazione della piattaforma

Impostazione iOS copre le note sull'entitlement App Attest.
Impostazione Android copre il repository Maven di Verisoul e le autorizzazioni.

Continua da Getting Started

Se stai utilizzando Getting Started per integrare le sessioni di Verisoul, connettilo con @capgo/capacitor-verisoul per la API panoramica, configurazione iOS per le note di App Attest, configurazione Android per la configurazione di Gradle, e Utilizzo di @capgo/capacitor-verisoul per il tutorial del plugin.