스텝업 인증
이 사용 사례가 해결하는 문제
얼굴 생체 인식이 운영자 기반 내 다른 활성 계정과 이미 연결되 어 있는지 여부를 감지합니다 — "One Face, One Contract" 원칙. 단일 API 호출로 캡처된 얼굴을 등록 기반과 교차 참조하여 행동 시점에 중복 계정을 차단합니다.
이 사용 사례를 사용하는 경우:
- 사용자가 작업(첫 출금, 캐시아웃 요청)을 실행하려 할 때, 해당 생체 인식이 이미 시스템 내 다른 활성 계정에 속하는지 검증하고자 하는 경우.
- 기존 중복을 식별하기 위해 셀피의 이력 기반에 대한 소급 수집 을 수행해야 하는 경우 (배치 모드). 이것이 생체 인식 베이스 가져오기 흐름입니다.
- 비즈니스 모델상 각 개인이 운영자당(또는 국가당) 최대 하나의 활성 계정만 보유해야 하는 경우.
- 수동 영상 심사 데스크의 부하를 줄이고, 사람의 분석을 자동적이고 결정론적인 판단으로 대체하고자 하는 경우.
이 사용 사례를 사용하지 않는 경우:
- 신원 문서의 진위 여부를 검증해야 하는 경우 → 온보딩 사용 사례를 살펴보세요.
- 트랜잭션을 수행하는 사람이 계정 소유자인지 확인해야 하는 경우 (1:1 검증) → 트랜잭션 사용 사례를 살펴보세요.
- 제품이 설계상 개인당 여러 계정을 허용하는 경우 (예: 개인 및 비즈니스 계정) → 이 규칙을 활성화하기 전에 Unico 팀과
clientReferenceSegment구성을 검토하세요. 이 필드는 검색 범위를 정의합니다: 1:N 비교는 동일 세그먼트에 등록된 레코드에 대해서만 실행되므로, 별개 의 세그먼트는 단일 운영자 내에서 오탐 없이 공존할 수 있습니다.
관련 기능
단일 프로세스 내에서 실행되는 파이프라인:
| 기능 | 필수 여부 | 흐름에서의 역할 |
|---|---|---|
| 라이브니스 | API의 경우 선택 사항; 웹 및 네이티브의 경우 필수 | 캡처 시점의 라이브니스 확인. |
| 다중 계정 1:N | 필수 | 운영자의 기반에서 세그먼트별 생체 인식 검색을 수행하여, 수신된 얼굴을 동일 세그먼트의 모든 레코드와 교차 참조합니다. |
사전 요구 사항
- Bearer 토큰 — 인증을 참조하세요.
- 샌드박스 자격 증명 — 환경을 참조하세요.
- SDK 또는 웹 컴포넌트 설치 — 웹 및 SDK 통합에만 해당됩니다. SDK 및 도구를 참조하세요.
- 모든 요청에
clientReference필드 입력 — 운영자 시스템에서 사용자를 고유하게 식별합니다. 클라이언트 데이터베이스에서 고유해야 하며, 최대 256자이고 공백을 포함하지 않아야 합니다. 이 필드는 다중 계정 1:N 목적의 기본 식별자입니다.
단계별 구현
- 네이티브
- Web
- API
네이티브 SDK를 통한 통합 — Android, iOS 또는 Flutter용 Unico SDK를 사용하여 앱 내부에서 캡처가 실행됩니다.
- SDK 설치 — 플랫폼에 맞는 Unico SDK 종속성을 추가합니다. Android, iOS 또는 Flutter의 설정 가이드를 참조하세요.
- 프로세스 생성 — 적절한
flow값과 사용자 식별자를 포함하여 Create Process를 호출합니다. 반환된token을 사용하여 SDK를 초기화합니다. - 캡처 시작 — SDK가 카메라 UI를 렌더링하고 디바이스에서 활동성 감지를 수행하여 캡처된 페이로드를 반환합니다.
- 결과 조회 — Get Process를 호출하여 기능 결과를 가져옵니다.
- 비즈니스 규칙 적용 — 응답 필드를 평가하여 승인, 거부 또는 에스컬레이션합니다.
iFrame, 리디렉션 또는 네이티브를 통한 통합 — Unico가 캡처 UI를 호스팅하며, 폴링을 통해 결과를 수신합니다.
- 프로세스 생성 — 적절한
flow값과 사용자 식별자를 포함하여 Create Process를 호출합니다. 응답에userRedirectUrl이 포함됩니다. - 사용자 리디렉션 — 사용자를
userRedirectUrl로 보냅니다. Unico가 캡처 여정을 렌더링합니다. 네이티브 앱의 경우webAppToken을 사용합니다. - 사용자가 여정 완료 — 캡처 후 사용자는 지정한
callbackUri로 다시 리디렉션됩니다. - 결과 조회 — Get Process를 호출하여 기능 결과를 가져옵니다.
- 비즈니스 규칙 적용 — 응답 필드를 평가하여 승인, 거부 또는 에스컬레이션합니다.
직접 API 통합 — Unico SDK나 캡처 표준을 따르는 자체 UI를 사용하여 셀피를 캡처한 후 Unico API로 직접 이미지를 전송합니다.
- 셀피 캡처 — 플랫폼에 맞는 Unico SDK를 사용하거나 캡처 표준을 따라 liveness 요건을 충족하는 셀피 이미지를 확보하세요.
- 프로세스 생성 — 사용자 식별자와
imagebase64로 된 셀피와 함께 프로세스 생성을 호출하세요. - 결과 조회 — 프로세스 조회를 호출하여 기능 결과를 가져오세요.
- 비즈니스 규칙 적용 — 응답 필드를 평가하여 승인, 거부 또는 에스컬레이션을 결정하세요.


