메인 콘텐츠로 건너뛰기

개요

라이브니스 보고서는 카메라 앞에 인쇄된 사진, 화면 재생 또는 딥페이크가 아닌 실제 사람이 있는지 확인하는 동안 Didit이 관찰한 모든 내용을 기록합니다. 여기에는 라이브니스 방식, 0–100점의 신뢰도 점수, 참조 셀피 및 캡처 비디오, 선택적 연령 추정, 패시브 라이브니스 품질 지표, 그리고 애플리케이션의 이력 및 차단 목록과 대조한 교차 세션 얼굴 대조 결과가 포함됩니다. 이 보고서는 사용자가 워크플로에서 라이브니스 단계를 완료하거나(또는 독립 실행형 얼굴 endpoint를 호출한 후) 생성됩니다. Didit은 세 가지 라이브니스 방식(액티브 3D, 플래싱 또는 패시브) 중 하나를 실행하고, 캡처 점수를 산정하며, 알려진 스푸핑 패턴을 검사하고, 애플리케이션에서 확인된 다른 모든 얼굴과 생체 인식 방식으로 비교합니다. 각 보고서는 전체 세션 상태와 무관하게 라이브니스 단계 자체의 처리 결과를 반영하는 자체 status를 가집니다.
  • 승인됨 — 얼굴이 감지되었고, 라이브니스 점수가 검토 임계값보다 높으며, 자동 거부 경고가 발생하지 않았습니다.
  • 검토 중 — 검토로 전달되는 경고가 하나 이상 발생했거나, 점수가 검토 임계값 이하이지만 거부 임계값보다 높습니다.
  • 거부됨 — 자동 거부 조건(NO_FACE_DETECTED, LIVENESS_FACE_ATTACK, FACE_IN_BLOCKLIST, 또는 연령 추정 흐름의 연령 위험)이 발생했거나, 설정 가능한 경고가 거부로 전달되었거나, 점수가 거부 임계값 이하입니다.
  • 완료되지 않음 — 사용자가 라이브니스 단계를 완료하지 않았습니다.

API 응답에 표시되는 위치

라이브니스 보고서는 GET /v3/session/{sessionId}/decision/에서 liveness_checks[]로 표시되며, 단일 liveness 객체가 아닌 항상 JSON 배열로 제공됩니다. 워크플로에서 라이브니스를 두 번 이상 실행하는 경우(예: 기본 검사 후 재캡처) 여러 항목이 표시됩니다.
  • 세션 결정 API — GET /v3/session/{sessionId}/decision/은 최상위 수준에서 liveness_checks[]를 반환합니다. 세션 결정 조회를 참조하세요.
  • Webhook — 단계에서 데이터가 생성되면 session.status.updated payload에 동일한 liveness_checks[] 배열이 포함됩니다. Webhook을 참조하세요.
  • 독립 실행형 라이브니스 API — 라이브니스 독립 실행형 API를 참조하세요.
response.liveness_checks[0]을 읽고 배열을 순회하세요. 일부 이전 튜토리얼에서 언급된 단일 liveness 형태는 v3 결정 endpoint에 존재하지 않습니다.

스키마

필드별 표준 스키마는 데이터 모델 참조 페이지에서 확인할 수 있습니다. 아래 필드들은 해당 표준 스키마를 반영합니다.

세션 간 얼굴 대조

matches[]는 해당 셀피에 대해 생체 인식 유사도 임계값을 초과한 애플리케이션 내역의 얼굴 목록을 표시합니다. 차단 목록 및 허용 목록의 얼굴이 먼저 표시되며, 이후 유사도 내림차순으로 최대 5개 항목까지 제공됩니다. 대상 후보는 차단 목록의 얼굴, 허용 목록의 얼굴, Approved 세션의 얼굴, 그리고 벤더 사용자로 가져온 얼굴입니다. 동일한 사용자(동일한 vendor_data 또는 사용 가능한 경우 동일한 벤더 사용자)에 속한 얼굴은 중복 감지 및 차단 목록 스크리닝을 포함한 전체 검색에서 제외됩니다. 각 항목에는 다음이 포함됩니다:

상태 값

상태 값은 공유 기능 상태 열거형(FeatureStatusChoices)에서 가져옵니다.

예시

Approved — 이상 없는 액티브 3D 캡처

In Review — 패시브 라이브니스, 낮은 캡처 품질 및 잠재적 중복

여기서 얼굴 품질(12.4)은 기본 검토 임계값(15) 미만이고, 밝기(18.7)는 기본 최소값(20) 미만이며, 워크플로의 중복 얼굴 작업이 검토로 설정되어 있습니다. 따라서 세 가지 경고 모두 log_type: "warning"을 가지며 보고서는 In Review로 결정됩니다.

보안 참고 사항

라이브니스 동영상과 셀피는 생체 인식 데이터입니다. 서명된 URL은 일시적이며 만료됩니다(기본 4시간 후). 단기간만 유효한 것으로 취급해야 하며, 캐시하거나 외부에 공개해서는 안 됩니다. 일반적으로 애플리케이션에는 status, score 및 경고만 필요합니다. 서버에 저장되는 생체 인식 데이터를 최소화하기 위해 가능한 한 적은 데이터만 저장하십시오.

관련 항목

마지막 수정일 2026년 11월 7일