시작하기

설치

AI-Assisted Setup으로 플러그인을 설치할 수 있습니다. 다음 명령어로 AI 도구에 Capgo 스킬을 추가하세요:

bunx 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.

수동 설정을 선호한다면, 다음 명령어를 실행하여 플러그인을 설치하고 아래의 플랫폼별 지침을 따르세요:

bun add @capgo/capacitor-verisoul
bunx cap sync

빠른 시작

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

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

예시: getSessionId

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

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

예시: reinitialize

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

await Verisoul.reinitialize();

자주 하는 실수

• 한 번만 초기화: 앱 부트스트랩 시 setup을 실행하세요.
• 네이티브 동기화: 실행 bunx cap sync 플러그인 업그레이드 후.
• 신뢰할 수 있는 소스: 신뢰 src/definitions.ts GitHub 레포지토리에서.

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();

Android 터치 신호

Android에서는 앱에서 Verisoul touch-pattern 수집이 필요할 때 터치 이벤트를 전달하세요.

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

플랫폼 설정

• iOS 설정 App Attest entitlement 관련 참고 사항을 다룹니다.
• Android 설정 Verisoul Maven repository 및 권한에 대해 다룹니다.

시작하기 다음 단계

사용 중이라면 시작하기 Verisoul 세션을 통합하려면 다음을 연결하세요: @capgo/capacitor-verisoul API 개요를 보려면, iOS 설정 App Attest 참고 사항은, Android 설정 Gradle 설정 및 @capgo/capacitor-verisoul 사용하기 플러그인 튜토리얼용.