개요
NFC 보고서의 경고는 Didit이 칩을 읽고 검증하는 동안 관찰한 모든 상태를 표시합니다. 경고는nfc_verifications[]의 각 항목에 있는 warnings[] 배열에 포함되며(NFC 보고서 참조), feature는 "NFC"로 설정됩니다. 각 항목은 공통 경고 객체 형태인 feature, risk, additional_data, log_type, short_description, long_description, node_id를 따릅니다.
모든 경고에는 세 가지 계층이 있습니다.
risk코드 — 코드에서 일치 여부를 확인할 수 있는 안정적인 식별자(아래에 나열된 코드).log_type—information,warning,error중 하나입니다. 워크플로에서 해당 위험에 대해 구성한 작업에서 파생됩니다. 작업 없음 →information, 검토 →warning, 거부 →error.- 결정 영향 — 동일하게 구성된 작업은 NFC 보고서의
status도 제어합니다. 검토 작업은In Review로, 거부 작업은Declined로 변경합니다.
SKIPPED_NFC_VALIDATION, NFC_CHIP_NOT_VERIFIED, NFC_TRUST_ANCHOR_MISSING, NFC_AND_OCR_DATA_NOT_SAME)이며, 여기에 각각 고유한 설정을 가진 5가지 일본 마이넘버카드 위험이 추가됩니다. 두 가지 인증서 위험(DSC_CERTIFICATE_REVOKED, DSC_CERTIFICATE_EXPIRED)은 정보 제공 전용입니다. 항상 log_type: "information"을 가지며 자체적으로 NFC 상태를 변경하지 않습니다.
NFC 모듈이 생성하는 전체 위험 코드 목록은 아래와 같습니다. 다른 NFC 위험 코드는 존재하지 않습니다.
생성되는 경고
SKIPPED_NFC_VALIDATION은 NFC_CHIP_NOT_VERIFIED 및 NFC_TRUST_ANCHOR_MISSING과 상호 배타적입니다. 칩 검증 경고는 칩 읽기를 건너뛰지 않은 경우에만 평가됩니다. 두 가지 칩 검증 경고 또한 상호 배타적입니다.정확한 설명 문자열
API는 각 risk에 대해 다음과 같은 정확한short_description 및 long_description 문자열을 반환합니다.
건너뛰기 이유
SKIPPED_NFC_VALIDATION 경고에는 NFC가 실행되지 않은 구체적인 이유를 나타내는 7가지 고정 코드 중 하나인 additional_data.skip_reason이 포함됩니다(건너뛰기 이유가 도입되기 전에 기록된 세션의 경우 additional_data가 null일 수 있으므로 이전 결정을 처리할 때 해당 필드를 선택 항목으로 취급하세요). 동일한 분류 체계가 세션 수준의 결정 payload에서 nfc_skip_reason으로도 나타나며, 여기에는 NFC를 전혀 실행할 수 없어(칩이 없는 문서, 웹 연동) NFC 보고서나 경고가 존재하지 않는 세션도 포함됩니다.
NFC 보고서 및 해당
SKIPPED_NFC_VALIDATION 경고는 클라이언트가 NFC 단계에 도달하여 명시적으로 건너뛴 경우에만 존재합니다(일반적으로 USER_SKIPPED이거나 스캔 시점에 리더를 사용할 수 없는 것으로 확인된 경우 DEVICE_WITHOUT_NFC). NFC 단계가 사용자에게 아예 제공되기 전에 우회된 경우(칩이 없는 문서, 인증서 누락, 보고된 NFC 기능 없음, 읽을 수 없는 MRZ 키, JPKI 사용 불가)에는 보고서나 경고가 생성되지 않으며, 세션 상태에 영향을 주지 않고 세션 수준의 nfc_skip_reason 필드에만 이유가 표시됩니다.설정
세 가지 워크플로 설정을 통해 NFC 경고가 라우팅되는 방식을 제어합니다. 각각 조치 없음, 검토 또는 거부로 설정할 수 있습니다.- NFC 건너뛰기 작업 (
skip_nfc_action) —SKIPPED_NFC_VALIDATION에 적용됩니다.allow_nfc_skip이 활성화된 경우에만 사용자에게 건너뛰기 옵션이 제공됩니다. - 미검증 칩 작업 (
unverified_chip_action) —NFC_CHIP_NOT_VERIFIED및NFC_TRUST_ANCHOR_MISSING모두에 적용되므로, 위험 코드를 통해 인증 실패 이유를 설명하면서도 세션 상태 동작은 동일하게 유지됩니다. - 데이터 불일치 작업 (
inconsistent_data_action) —NFC_AND_OCR_DATA_NOT_SAME에 적용됩니다. 신분증 인증에서 사용되는 데이터 불일치 설정과 동일합니다.
DSC_CERTIFICATE_* 위험에는 작업 설정이 없으며 항상 정보 제공용입니다. 일본 마이넘버카드 위험에는 다음 섹션에 나열된 다섯 가지 추가 설정이 있습니다.
일본 마이넘버카드 (JPKI)
일본 마이넘버카드는 ICAO 9303 대신 JPKI를 통해 읽히므로(chip_protocol: "jpki"), 위의 ICAO 위험은 절대 발생하지 않습니다. 대신 마이넘버카드 판독 시 다음 다섯 가지 위험이 발생하며, 각 위험은 NFC 노드에서 고유한 설정을 갖습니다.
건너뛴 마이넘버카드 판독은 다른 칩과 마찬가지로
SKIPPED_NFC_VALIDATION을 발생시키고 skip_nfc_action을 따릅니다. 판독 작동 방식에 대해서는 일본 마이넘버카드 (JPKI)를 참조하세요.
예시
검토 중 — 칩을 확인할 수 없음
NFC_CHIP_NOT_VERIFIED에 log_type: "warning"이 전달되고 NFC 보고서 상태는 In Review가 됩니다. 만료된 DSC 항목은 순수한 정보 제공용입니다.
거부됨 — 칩과 OCR 불일치
log_type: "error"가 전달되고 NFC 보고서 상태는 Declined가 됩니다. ocr_mrz는 MRZ 줄의 배열인 반면, nfc_mrz는 칩의 하나로 연결된 MRZ 문자열이라는 점에 유의하십시오.
검토 중: 취소 여부 응답이 없는 마이 넘버 카드
jpki_revocation_unchecked_action이 기본값인 Review를 유지하므로 경고에 log_type: "warning"이 전달되고 NFC 보고서 상태는 In Review가 됩니다. 카드 자체는 검증되었습니다. 즉, jpki.chain_valid와 jpki.signature_valid가 모두 true입니다.
경고 유형
애플리케이션 설정에 따라 각 위험에 심각도가 할당됩니다. 세 가지 심각도는 다음과 같습니다.관련 항목
- NFC 보고서 — 전체 보고서 스키마 및 상태.
- webhook — 세션 상태가 변경될 때
status.updated가 트리거됩니다. 세션이 Approved, Declined, In Review 또는 Abandoned 상태에 도달하면 결정 payload(NFC 경고 포함)가 첨부됩니다. - 데이터 모델 — NFC 인증 — 표준 필드별 스키마.
- 데이터 모델 — Warning 객체 —
warnings[]내 모든 항목의 구조.