Getting Started

Copiez une commande de configuration avec les étapes d'installation et la 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.

Installation

Vous pouvez utiliser notre configuration assistée par l'IA pour installer le plugin. Ajoutez les Capgo compétences à votre outil IA à l'aide de la commande suivante :

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

Ensuite, utilisez la prompt suivante :

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 la configuration manuelle, installez le plugin en exécutant les commandes suivantes et suivez les instructions spécifiques à la plateforme ci-dessous :

npm install @capgo/capacitor-verisoul
npx cap sync

Configurer Verisoul

Appel configure() une fois, tôt dans le démarrage de votre application. Utilisez 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

After Verisoul has collected enough native signals, request the session ID and send it to your backend. Your backend should call Verisoul’s server-side API for the risk assessment.

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

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

Réinitialiser sur les modifications de compte

Appeler reinitialize() lorsque les contextes de l'utilisateur changent, comme la déconnexion suivie d'une connexion sous un autre compte.

await Verisoul.reinitialize();

Signaux de toucher Android

Sur Android, transmettez les événements de toucher lorsque votre application a besoin de la collecte de modèles de toucher Verisoul.

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

Configuration de plateforme

Configuration iOS couvre les notes sur l'entitlement App Attest.
Configuration Android couvre le dépôt Maven Verisoul et les permissions.

Continuez de Getting Started

Si vous utilisez Démarrage pour intégrer les sessions de Verisoul, connectez-le avec @capgo/capacitor-verisoul pour l'aperçu de API Configuration iOS pour les notes d'App Attest, Configuration Android pour la configuration Gradle, et En utilisant @capgo/capacitor-verisoul pour le tutoriel du plugin.