라이브니스
사용자가 신원 확인 여정에 있을 때, 라이브니스가 가장 먼저 실행되는 기능입니다.
기능 설명
캡처된 셀피가 사진, 동영상, 마스크 또는 기타 주입 시도가 아닌 카메라 앞의 실제 사람으로부터 나온 것인지 감지합니다. SDK 또는 Unico의 Web 여정과 함께 작동하여 생체 인식적으로 유효한 프레임이 얻어질 때까지 사용자를 안내합니다.
입력값
캡처는 SDK 또는 Web 여정이 처리합니다 — 라이브니스에 이미지를 수동으로 전송하지 않습니다. 입력값은 라이브니스가 포함된 플로우로 POST /v1/process를 통해 열린 세션입니다.
헤드리스 API 연동에서 라이브니스를 사용하려면 Unico SDK(Web, Android, iOS 또는 Flutter) 중 하나의 구현이 필수입니다 — 라이브니스는 base64 이미지만으로 API를 통해 단독으로 호출될 수 없습니다.
가능한 응답
| 응답 | 의미 |
|---|---|
YES | 사용자가 살아있습니다. |
NO | 라이브니스 시도가 실패했습니다. |
Web & Native 계약 응답에서, 이 값들은 authenticationInfo.livenessResult 필드의 LIVENESS_RESULT_LIVE (YES)와 LIVENESS_RESULT_NOT_LIVE (NO)에 매핑됩니다. 전체 열거형 표는 프로세스 조회를 참조하세요.
가용성
| 인터페이스 | 지원 여부 |
|---|---|
| SDK (Android, iOS, Flutter) | ✅ |
| Web (iFrame, Redirect) | ✅ |
| API (헤드리스, SDK 없음) | ⚠️ 캡처를 위해 Unico SDK 필요 |
유효한 조합
라이브니스는 카탈로그의 거의 모든 플로우에 포함됩니다:
idlive, id, idlivetrust, idtrust, idcheck, idchecktrust, iddocs, idsign, iddocssign, idchecktrustdocs, idchecktrustsign, idchecktrustdocssign, idtrustdocs, idtrustsign, idtrustdocssign, idunicodocs, idunicosign, idunicodocssign, idunicoserprodocssign, idcheckserpro, idcheckserprodocs, idcheckserprodocssign, creditoconsignado, idtoken, idtokentrust, idtokensign.
전체 매트릭스는 사용 가능한 플로우를 참조하세요.
idsmart (스마트 재검증) — 이전에 캡처된 생체 인식과 함께 메타데이터/패스키 검증으로 활성 캡처를 대체합니다.