Démarrage

Copiez un prompt de configuration avec les étapes d'installation et la guide markdown complète 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

Appelez configure() une fois, au début de l'initialisation 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',
});

Obtenez un ID de session

Après que Verisoul a collecté suffisamment de signaux natifs, demandez l'ID de session et envoyez-l’à votre backend. Votre backend doit appeler le serveur côté serveur de Verisoul API pour l'évaluation des risques.

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

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

Réinitialiser en cas de changements de compte

Appelez reinitialize() lorsque le contexte de l'utilisateur change, comme lors d'un 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 lorsqu'il est nécessaire à votre application de collecter les modèles de toucher Verisoul.

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

Configuration de la plateforme

couvre les notes sur l'entitlement App Attest. Configuration Android
couvre le référentiel Maven Verisoul et les permissions. Lorsque le contexte de l'utilisateur change, comme lors d'un déconnexion suivie d'une connexion sous un autre compte.

Continuez de là

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