Prise en main

Copiez un prompt de configuration incluant les étapes d'installation et le guide markdown complet pour ce 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.

Installer

Vous pouvez utiliser notre configuration assistée par IA pour installer le plugin. Ajoutez les skills Capgo à votre outil d'IA avec la commande suivante :

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

Utilisez ensuite le prompt suivant :

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

Si vous préférez une installation manuelle, installez le plugin en exécutant les commandes suivantes et suivez les instructions spécifiques à chaque plateforme ci-dessous :

bun add @capgo/capacitor-verisoul
bunx cap sync

Démarrage rapide

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

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

Exemple : getSessionId

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

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

Exemple : reinitialize

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

await Verisoul.reinitialize();

Erreurs courantes

Initialiser une seule fois: exécutez le setup lors du bootstrap de l'app.
Sync native : exécuter bunx cap sync après les mises à jour du plugin.
Source de vérité : fiez-vous src/definitions.ts au repo GitHub.

Configurer Verisoul

Appelez configure() once, early in your app startup. Use sandbox pour les tests et prod pour le trafic de production.

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

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

Obtenir un ID de session

Une fois que Verisoul a collecté suffisamment de signaux natifs, demandez l’ID de session et envoyez-l’à votre backend. Votre backend doit appeler l’API côté serveur de Verisoul pour l’évaluation du risque.

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

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

Réinitialiser lors des changements de compte

Appelez reinitialize() lorsque le contexte utilisateur change, par exemple après une déconnexion suivie d’une connexion avec un autre compte.

await Verisoul.reinitialize();

Signaux tactiles Android

Sur Android, transmettez les événements tactiles lorsque votre application a besoin de la collecte de motifs tactiles Verisoul.

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

Configuration de la plateforme

Configuration iOS couvre les notes sur les autorisations App Attest.
Configuration Android couvre le dépôt Maven Verisoul et les autorisations.

Continuer depuis Getting Started

Si vous utilisez Prise en main pour intégrer les sessions Verisoul, connectez-l’à @capgo/capacitor-verisoul pour l’aperçu de API, Configuration iOS pour les notes sur App Attest, Configuration Android pour la configuration Gradle, et Utiliser @capgo/capacitor-verisoul pour le tutoriel du plugin.