시작하기

설치

        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.

설치

AI-Assisted Setup을 사용하여 플러그인을 설치할 수 있습니다. 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을 구성하세요

호출 configure() 한 번, 앱 시작 시 초기에 사용하세요. sandbox 테스트 및 prod 생산 트래픽

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

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

세션 ID 획득

Verisoul이 충분한 네이티브 신호를 수집한 후 세션 ID를 요청하고 백엔드에 전송하세요. 백엔드에서는 Verisoul의 서버측 API를 호출하여 위험 평가를 수행해야 합니다.

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

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

계정 변경 시 초기화

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

await Verisoul.reinitialize();

안드로이드 터치 신호

안드로이드에서 앱이 Verisoul 터치 패턴 수집이 필요한 경우, 터치 이벤트를 전달하세요.

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

플랫폼 설정

iOS 설정 App Attest 특권에 대한 주의사항을 포함합니다.
안드로이드 설정 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 @capgo/capacitor-verisoul 플러그인 튜토리얼을 위해.