Erste Schritte

Kopiere einen Setup-Prompt mit den Installationsschritten und dem vollständigen Markdown-Guide für dieses 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.

Installieren

Du kannst unser KI-gestütztes Setup nutzen, um das Plugin zu installieren. Füge die Capgo Skills mit dem folgenden Befehl deinem KI-Tool hinzu:

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

Nutze dann diesen Prompt:

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

Wenn du ein manuelles Setup bevorzugst, installiere das Plugin mit den folgenden Befehlen und befolge die plattformspezifischen Anweisungen unten:

bun add @capgo/capacitor-verisoul
bunx cap sync

Quickstart

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

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

Beispiel: getSessionId

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

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

Beispiel: reinitialize

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

await Verisoul.reinitialize();

Häufige Stolperfallen

Einmalige Initialisierung: Setup beim App-Bootstrap ausführen.
Nativer Sync: ausführen bunx cap sync nach Plugin-Upgrades.
Single Source of Truth: Vertrauen src/definitions.ts im GitHub Repo.

Verisoul konfigurieren

Rufe configure() einmalig früh beim App-Start. Nutze sandbox zum Testen und prod für den Produktions-Traffic.

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

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

Session-ID abrufen

Sobald Verisoul genügend native Signale gesammelt hat, fordere die Session-ID an und sende sie an dein Backend. Dein Backend sollte die serverseitige API von Verisoul für die Risikobewertung aufrufen.

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

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

Reset bei Kontoänderungen

Rufe reinitialize() wenn sich der Benutzerkontext ändert, z. B. Logout gefolgt von Login mit einem anderen Konto.

await Verisoul.reinitialize();

Android-Touch-Signale

Leiten Sie auf Android Touch-Events weiter, wenn Ihre App die Erfassung von Verisoul-Touch-Mustern benötigt.

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

Plattform-Setup

iOS-Setup deckt Hinweise zu App Attest-Berechtigungen ab.
Android-Setup behandelt das Verisoul-Maven-Repository und die Berechtigungen.

Weiter geht's nach Getting Started

Wenn du es nutzt Erste Schritte um Verisoul-Sessions zu integrieren, verbinde es mit @capgo/capacitor-verisoul für die API-Übersicht, iOS-Setup für Hinweise zu App Attest, Android-Setup für das Gradle-Setup und Verwendung von @capgo/capacitor-verisoul für das Plugin-Tutorial.