개요
얼굴 대조 보고서의 경고는 Didit이 1:1 얼굴 비교를 실행하는 동안 관찰한 모든 조건을 표시합니다. 경고는face_matches[]의 각 항목에 있는 warnings[] 배열에 포함됩니다(얼굴 대조 보고서 참조). 각 항목에는 feature: "FACEMATCH" 및 이를 발생시킨 워크플로 노드의 node_id도 함께 포함됩니다.
모든 경고에는 세 가지 레이어가 있습니다.
risk코드 — 코드에서 매칭할 수 있는 안정적인 식별자입니다.log_type— 워크플로의 유사도 점수 임계값에서 파생되는information,warning또는error입니다.- 결정 영향 — 유사도 점수에 대한 워크플로의 검토 및 거부 임계값에 의해 설정됩니다.
자동 거부 조건
다음 위험은 얼굴 대조 보고서(및 세션)를 항상Declined 상태로 만듭니다.
NO_REFERENCE_IMAGE가 발생하면 LOW_FACE_MATCH_SIMILARITY는 억제됩니다(점수를 산정할 대상이 없기 때문입니다).
단 한 가지 예외가 있습니다.
신분증 확인 단계가 인물 사진을 반환하지 않고 얼굴을 확인하지 않는 비서류 조회로 완료된 경우, 얼굴 대조는 설계상 실시간 캡처와 비교할 대상이 없습니다.
이 경우 자동 거부가 아닌 null 점수와 함께 FACE_MATCH_NOT_COMPUTED로 보고되며, 아래의 face_match_not_computed_action에 의해 결정됩니다.
구성 가능한 인증 설정
Didit 콘솔에서 얼굴 대조 유사도 점수는 두 가지 임계값으로 관리됩니다(Approve/Review/Decline 토글 없음).
오승인이 너무 많이 발생하는 경우 검토 임계값을 더 높게 조정하고, 오거부가 너무 많이 발생하는 경우 거부 임계값을 더 낮게 조정하십시오.
별도의 설정으로 유사도 점수를 전혀 계산할 수 없을 때(이미지 중 하나에서 얼굴이 감지되지 않았거나 비서류 조회로 비교할 기준 이미지가 남지 않은 경우) 발생하는 동작을 제어합니다.
이 작업은
FACE_MATCH_NOT_COMPUTED(문서 인물 사진에 얼굴이 없거나 비서류 조회 후 기준 이미지가 전혀 없음) 및 시도 횟수를 모두 소진한 NO_FACE_IN_SELFIE(사용자의 재시도 후에도 셀피에서 얼굴이 감지되지 않음)를 제어합니다. 셀피에 문제가 있는 경우 사용자는 먼저 다시 촬영하도록 요청받으며(아래 참조), 시도 가능 횟수를 모두 소진한 후에도 얼굴을 감지할 수 없는 경우에만 이 작업이 적용됩니다.
유사도가 낮은 실패 역시 상태가 최종 확정되기 전에 캡처 재시도 루프에 진입합니다. 사용자에게 재촬영을 포함해 총 face_match_max_attempts회의 시도가 주어집니다(기본값 3, 워크플로 노드당 2~5회 구성 가능). 더 선명한 셀피를 다시 촬영하여 문제를 해결할 수 있으므로 NO_FACE_IN_SELFIE 실패도 동일한 재시도 루프를 사용합니다. FACE_MATCH_NOT_COMPUTED 실패는 재시도되지 않습니다. 이 단계에서는 신분증 문서 인물 사진을 다시 촬영할 수 없기 때문입니다. 시도 횟수를 모두 소진한 경우에만 마지막 시도의 상태가 적용되며, 이를 기록하기 위해 FACE_MATCH_MAX_ATTEMPTS_EXCEEDED가 로깅됩니다.
독립형 얼굴 대조 API에는 거부 임계값(face_match_score_decline_threshold 요청 옵션, 기본값 30)만 존재합니다. 발생한 모든 경고는 요청을 거부하며, 얼굴을 전혀 비교할 수 없을 때 NO_REFERENCE_IMAGE가 발생합니다.
생성되는 경고
예시
검토 중 — 경계선 수준의 유사도
검토 중 — 얼굴 대조를 계산할 수 없음
자동 거부 — 참조 이미지 누락
재시도 횟수 소진 — 마지막 시도의 상태 적용
독립형 Face Match API는
node_id를 제외하고 동일한 경고 형식을 반환합니다(비교 작업이 워크플로 노드에 바인딩되지 않음).경고 유형
각 위험에는 애플리케이션 구성에 따라 심각도가 할당됩니다. 세 가지 심각도는 다음과 같습니다.관련 문서
- 얼굴 대조 보고서 — 전체 보고서 스키마 및 상태.
- 라이브니스 경고 — 셀피 캡처 시 발생하는 업스트림 경고.
- webhook — 단계가 완료되는 즉시
session.status.updated에 경고가 포함되어 전송됩니다. - 데이터 모델 — 얼굴 대조 — 표준 스키마.
- 데이터 모델 — 경고 객체 —
warnings[]내 각 항목의 형식.