시작하기

설치

        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.

설치

Capgo의 AI 보조 설치를 사용하여 플러그인을 설치할 수 있습니다. AI 도구에 Capgo 기능을 추가하려면 다음 명령어를 사용하세요:

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

그다음에 다음 프롬프트를 사용하세요:

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

만약 Manual Setup을 선호한다면, 플러그인을 설치하기 위해 다음 명령어를 실행하고 아래의 플랫폼별 지침을 따르세요:

npm install @capgo/capacitor-verisoul
npx cap sync

Verisoul을 구성하세요

Call configure() 한 번, 앱이 시작되는 초기 단계에서 사용하세요. sandbox 테스트 및 prod 생산 트래픽

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

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

세션 ID를 가져오세요

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 }),
});

Call

테스트 및 reinitialize() 사용자 컨텍스트가 변경될 때, 예를 들어 로그아웃 후 다른 계정으로 로그인할 때.

await Verisoul.reinitialize();

Android 터치 신호

Android에서 앱이 Verisoul 터치 패턴 수집이 필요한 경우 터치 이벤트를 전달합니다.

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

플랫폼 설정

iOS 설정 App Attest 특권에 대한 주의사항을 다룹니다.
Android 설정 Verisoul Maven 저장소와 권한에 대한 내용을 다룹니다.

시작하기에서 계속

Verisoul 세션을 통합하기 위해 시작하기 @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-verisoul @capgo/capacitor-verisoul for the API overview, App Attest 참고 Android 설정 Gradle 설정 Using @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-verisoul Using @capgo/capacitor-verisoul 이 플러그인 튜토리얼을 위해.