모니터링 데이터 수집

선택적 구현

모니터링 데이터 수집은 선택 사항입니다. 이를 적용하면 prepareSelfieCamera 호출에만 영향을 미치며 — 캡처 플로우의 다른 모든 단계(초기화, 콜백, 결과 처리)는 변경되지 않습니다.

캡처 세션에 사용자 및 플로우 메타데이터를 첨부하면 Unico 측의 모니터링 및 옵저버빌리티 도구에서 상관관계를 파악할 수 있습니다. 데이터가 제공되면 캡처와 함께 전달되며 — SDK의 캡처 동작이나 API 응답을 변경하지 않습니다.

setSilentInfo 매개변수

매개변수	타입	필수 여부	설명
externalUserId	String	✅	귀하의 시스템에서 사용자 식별자. 전송 전 SHA-256으로 자동 해시 처리되며 — 평문으로 전송되지 않습니다.
useCase	String	—	실행 중인 플로우 또는 컨텍스트의 식별자(예: "account_opening", "password_recovery"). 평문으로 전송됩니다.

구현

빌드된 카메라 인스턴스에서 prepareSelfieCamera를 호출하기 전에 setSilentInfo를 호출합니다. 캡처 플로우의 다른 모든 부분은 동일하게 유지됩니다.

import { UnicoCheckBuilder, UnicoConfig, SelfieCameraTypes, SDKEnvironmentTypes } from "@acesso-io/unico-webframe";

const config = new UnicoConfig()
  .setHostname("<YOUR_HOSTNAME>")
  .setHostKey("<YOUR_HOST_KEY>");

const unicoCamera = new UnicoCheckBuilder()
  .setEnvironment(SDKEnvironmentTypes.UAT)
  .build();

unicoCamera.setSilentInfo("external_user_id", "flow_id");

await unicoCamera.prepareSelfieCamera(config, SelfieCameraTypes.SMART);