모니터링 데이터 수집

선택적 구현

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

카메라가 전혀 필요 없으신가요?

이 페이지는 prepareSelfieCamera/prepareDocumentCamera 호출과 함께일 때만 적용되는 setSilentInfo를 다룹니다. 카메라 세션을 전혀 열지 않고 사일런트 검증을 수행하고 싶다면(예: 로그인 화면), 대신 사일런트 재검증에 문서화된 initializeSDK + startSilentValidation을 사용하세요. 두 경로 모두 같은 페이지에서 사용할 수 있습니다.

캡처 세션에 사용자 및 플로우 메타데이터를 첨부하면 Unico 측의 모니터링 및 옵저버빌리티 도구에서 상관관계를 파악할 수 있으며, 백엔드가 이 거래에 대한 사일런트 재검증 결과에 해당 데이터를 반영할 수 있습니다. 데이터가 제공되면 캡처와 함께 전달되며 SDK의 캡처 동작은 변경하지 않지만 — Create Process 응답에는 영향을 미칩니다: 사일런트 재검증의 silentAuth.result를 참고하세요.

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