메인 콘텐츠로 건너뛰기

개요

얼굴 대조 보고서의 경고는 Didit이 1:1 얼굴 비교를 실행하는 동안 관찰한 모든 조건을 표시합니다. 경고는 face_matches[]의 각 항목에 있는 warnings[] 배열에 포함됩니다(얼굴 대조 보고서 참조). 각 항목에는 feature: "FACEMATCH" 및 이를 발생시킨 워크플로 노드의 node_id도 함께 포함됩니다. 모든 경고에는 세 가지 레이어가 있습니다.
  1. risk 코드 — 코드에서 매칭할 수 있는 안정적인 식별자입니다.
  2. log_type — 워크플로의 유사도 점수 임계값에서 파생되는 information, warning 또는 error입니다.
  3. 결정 영향 — 유사도 점수에 대한 워크플로의 검토 및 거부 임계값에 의해 설정됩니다.
얼굴 대조 모듈은 의도적으로 단순하게 구성되어 있으며, 아래에 전체 목록으로 안내된 정확히 5개의 위험 코드가 있습니다.

자동 거부 조건

다음 위험은 얼굴 대조 보고서(및 세션)를 항상 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를 제외하고 동일한 경고 형식을 반환합니다(비교 작업이 워크플로 노드에 바인딩되지 않음).

경고 유형

각 위험에는 애플리케이션 구성에 따라 심각도가 할당됩니다. 세 가지 심각도는 다음과 같습니다.

관련 문서

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