문서 검증 API는 어떤 문서를 읽나요?

캐나다와 미국의 모든 주, 준주, DC의 운전면허증, 기계 판독 영역을 통한 여권, 영주권 카드, 주 발급 사진 ID를 지원합니다. 멕시코 두 개 주를 포함해 72개 발급 기관을 바코드로 인식합니다. 건강보험 카드는 현재 인식되는 문서 유형에 별도로 명시되어 있지 않습니다.

API가 문서를 인식하지 못하면 어떻게 되나요?

문서를 거부하지 않습니다. ShieldID는 문서 유형으로 차단하지 않습니다. 낯선 카드는 전체 페이지 OCR 폴백으로 필드별로 읽고, 일괄 거부 대신 각 필드에 개별 판정을 내립니다.

바코드, MRZ, 인쇄된 앞면은 어떻게 조정되나요?

문서에 실제로 있는 출처를 각각 읽고, 같은 필드가 둘 이상의 출처에 나타나면 바코드, 체크섬을 통과한 여권 MRZ, 구조화된 앞면 판독, 전체 페이지 OCR 순으로 우선합니다. 출처 간 불일치는 표시되며, 조용히 평균을 내지 않습니다.

문서 변조 점수가 검증 통과 여부를 결정하나요?

아니요. 문서 변조 점수는 모든 검증에서 실행되어 결과에 보고되지만, 현재는 참고용이며 필드별 판정이나 전체 결과를 좌우하지 않습니다. 임계값은 실제 촬영본을 대상으로 독립적으로 측정된 적이 없습니다.

API가 실제 문서와 인쇄된 문서를 찍은 사진을 구별할 수 있나요?

아직은 아닙니다. 문서가 인쇄물이나 화면을 찍은 사진이 아닌 실제 물리적 물건임을 감지하는 기능은 로드맵에 있습니다. 현재의 프레젠테이션 공격 검사는 검증의 셀카 쪽에서 실행됩니다.

문서 검증 결과로 무엇을 받나요?

이름, 생년월일, 주소, 문서 번호, 만료일, 관할 지역 등의 필드별 값이 각각의 출처 및 개별 판정과 함께 제공되며, 참고용 증거로 보고되는 문서 변조 신호도 포함됩니다. 전체 결과에는 같은 세션의 얼굴 일치 및 라이브니스 검사도 담깁니다.

문서 판독 정확도 수치를 공개하나요?

아니요. 동의를 받은 실제 트래픽으로 측정하지 않은 정확도 수치는 공개하지 않습니다. 대신 각 검사가 실제로 무엇을 하는지, 필드 단위 교차 확인이 어떻게 작동하는지를 공개하므로 증거를 직접 판단하실 수 있습니다.

신분증 문서 검증

앞면에 적힌 문서 유형만이 아니라 신분증 자체를 읽는 문서 검증 API.

ShieldID는 신청자 본인의 휴대폰으로 정부 발급 사진 신분증의 앞면과 뒷면을 읽고, 바코드와 여권의 MRZ를 디코딩하며, 모든 필드를 모든 출처와 교차 확인하여 카드 전체에 대한 통과 또는 실패 하나가 아닌 필드별 판정을 보고합니다.

Start free in sandbox API 레퍼런스

문서 지원 범위

캐나다와 미국 문서를 깊이 있게 읽습니다.

운전면허증, 여권, 영주권 카드, 주 발급 사진 ID를 지원하며, 바코드에 발급 기관 정보가 있으면 해당 기관별로 식별합니다.

13주 및 준주캐나다의 모든 운전면허증 및 ID 카드 발급 기관, 바코드로 식별

72인식되는 문서 발급 기관캐나다, 미국, 멕시코 2개 주 (AAMVA 바코드 IIN 기준)

캐나다 운전면허증, 13개 모든 주와 준주
미국 운전면허증, 모든 주와 준주, 그리고 DC
여권: MRZ를 읽고 체크섬으로 검증
영주권 카드
주 및 준주 발급 사진 신분증
멕시코 2개 주는 초기 지원 단계입니다.

기준선을 어디에 두는지 솔직하게 말씀드립니다

건강보험 카드는 현재 인식되는 문서 유형에 별도로 명시되어 있지 않습니다. 낯설거나 목록에 없는 카드도 다른 모든 문서와 같은 원칙으로 읽습니다. 문서를 입구에서 거부하지 않고, 페이지에 표시된 내용을 추출하여 각 필드별 판정을 보고합니다.

문서를 읽는 방법

네 가지 경로, 겹칠 때는 하나의 우선순위.

신청자가 자신의 휴대폰으로 신분증의 앞면과 뒷면을 촬영합니다. ShieldID는 해당 문서에 실제로 있는 출처를 모두 읽고, 두 출처가 일치하지 않으면 가장 신뢰할 수 있는 출처를 따릅니다.

PDF417 바코드
북미 운전면허증 또는 ID 카드의 뒷면에는 PDF417 바코드가 있습니다. ShieldID는 이를 이름, 생년월일, 주소, 면허 번호, 만료일 등의 구조화된 AAMVA 필드로 디코딩합니다.
여권 MRZ
여권의 MRZ는 전용 감지기와 판독기로 읽은 뒤, MRZ 자체에 내장된 ICAO 체크 디지트 공식으로 검증합니다. 이 방식으로 추출한 필드를 신뢰할지는 최소 유효성 점수로 결정합니다.
구조화된 앞면 판독
문서의 인쇄된 면은 필드별로 읽으며, 문서 유형의 레이아웃이 인식되면 그 레이아웃을 활용합니다.
전체 페이지 OCR 대체 수단
더 구체적으로 적용할 방법이 없을 때는 앞면 전체를 텍스트로 읽습니다. 낯선 문서가 곧바로 거부되지 않는 이유입니다.

출처가 겹칠 때의 우선순위

같은 필드가 둘 이상의 출처에 나타나면 바코드, 체크섬을 통과한 여권 MRZ, 구조화된 앞면 판독, OCR 폴백 순으로 우선합니다. 출처가 서로 다르면 검토 대상으로 표시되며, 조용히 평균을 내지 않습니다.

Cross-checks

모든 필드는 무조건 믿지 않고 서로 대조하여 확인합니다.

단독으로는 깔끔하게 읽히는 문서에도 앞면의 내용과 바코드 또는 MRZ의 내용 사이에 불일치가 숨어 있을 수 있습니다. ShieldID는 모든 검증에서 이를 확인합니다.

앞면 vs 바코드 vs MRZ

이름, 생년월일, 문서 번호, 주소를 문서에 실제로 있는 모든 출처에서 비교합니다. 불일치는 하나를 골라 나머지를 숨기는 방식으로 해결하지 않고 그대로 보고합니다.

면허 번호 인코딩

주에서 면허 번호 자체에 구조를 인코딩하는 경우, 그 구조를 나머지 기록과 대조해 확인합니다.

3자 신원 비교

문서에서 읽은 이름과 신원 정보를 서로 비교하고, 검증을 요청한 측이 신청자에 대해 제시한 내용과도 비교하므로, 바꿔치기가 있으면 깔끔한 통과가 아닌 불일치로 나타납니다.

우리의 원칙

문서 유형으로 차단하지 않습니다.

인식되지 않거나 낯선 문서라고 해서 처음 본다는 이유로 거부하지 않습니다. ShieldID는 읽을 수 있는 것을 읽고 각 필드별 판정을 보고하므로, 한 번도 목록에 올린 적 없는 발급 기관의 카드에서도 올바른 생년월일과 실제 얼굴 일치 결과를 얻어 양호로 보고할 수 있습니다.

판정은 문서 단위가 아닌 필드 단위입니다

이름, 생년월일, 주소, 문서 번호, 사진은 각각 자체 증거에 따라 판정됩니다. 하나의 취약한 필드가 깔끔하게 확인된 필드를 끌어내리지 않으며, 강한 필드가 그렇지 못한 필드를 덮어 주지도 않습니다.

문서를 수락할지는 고객님이 결정합니다

ShieldID는 검사별 증거와 판정을 보고합니다. 낯설거나 일부만 검증된 문서를 이후에 어떻게 처리할지는 보고서를 보고 각 비즈니스가 직접 판단할 몫입니다.

변조 점수는 참고용입니다

참고용일 뿐입니다

문서 변조 점수는 모든 검증에서 실행되어 결과에 보고되지만, 현재는 참고용입니다. 필드별 판정이나 전체 결과를 좌우하지 않으며, 임계값도 실제 촬영본을 대상으로 독립적으로 측정된 적이 없습니다. 관문이 아니라 하나의 추가 증거로 활용해 주십시오.

문서 프레젠테이션 공격 탐지

출시 예정

문서가 인쇄물이나 화면에 표시된 문서를 찍은 사진이 아닌 실제 물리적 물건임을 감지하는 기능은 아직 없습니다. 현재의 검사는 검증의 셀카 쪽을 방어하며, 프레젠테이션 공격 감지의 문서 쪽은 로드맵에 있습니다.

안내형 재촬영

검증에 실패하면 어느 쪽이 원인인지 알려 드립니다.

검증에 실패했다고 해서 신청자가 잘못한 것은 아닐 수 있습니다. 신분증 사진이 흐릿했거나 셀카가 어두웠을 수 있는데, 엉뚱한 쪽을 다시 요청하면 신청자의 시간을 두 번 낭비하게 됩니다.

ShieldID의 재촬영 로직은 실패한 검사의 라벨이 아니라 증거를 읽고 신분증과 셀카 중 어느 쪽을 다시 시도해야 하는지 판단하며, 해당 쪽의 카메라만 다시 보여 드립니다. 깨끗한 셀카와, 비스듬한 각도로 찍혀 읽을 수 없는 여권 사진 모두에 셀카를 다시 찍으라고 안내했던 실제 사례를 계기로 만들어졌습니다.

제공되는 결과

필드별 값과 각각의 출처, 판정 결과입니다.

결과는 단순한 통과 또는 실패 하나가 아닙니다. ShieldID가 읽은 모든 필드가 값, 출처, 확인 여부와 함께 반환됩니다.

성명: 앞면, 바코드, MRZ(있는 경우) 간에 비교하고, 요청자가 제시한 이름과도 비교합니다.
생년월일: 바코드 및 MRZ와 교차 확인합니다.
주소: 앞면과 바코드(문서에 있는 경우)에서 읽으며, 필요한 경우 업로드된 주소 증빙 문서와 비교합니다.
문서 번호: 내부 일관성을 확인하고, 해당되는 경우 발급 관할 지역의 인코딩 규칙에 따라 검증합니다.
만료일: 앞면과 바코드 또는 MRZ에서 읽으며, 출처 간에 불일치하면 표시합니다.
발급 관할: 문서에 인식 가능한 바코드 발급 기관 코드가 있는 경우, 해당 코드로 식별됩니다.
문서 변조 신호: 모든 검증에서 참고용 증거로 보고되며, 판정 자체로 사용되지는 않습니다.

실제 사례

온타리오 운전면허증을 필드별로 살펴봅니다.

가상의 신청자, 가상의 면허증입니다. 필드 구성, 출처 표기, 교차 검사는 실제 파이프라인 그대로입니다.

Jordan A. Reyes — Ontario driver's licence (sample)

샘플 데이터

필드	값	출처	판정
Full name	Jordan Alexander Reyes	Front + barcode (agree)	Match
Date of birth	14 Mar 1994	Barcode	Match
Address	482 King St W, Toronto ON	Barcode	Match
Licence number	R1234-56789-01234	Barcode; front reads the same string	Match
Expiry date	14 Mar 2029	Front + barcode (agree)	Match
Photo	Present, legible	Front image	Face match: pending selfie
Document tamper signal	No indication	Advisory model, cropped document image	Advisory — not gating

비교

지원하는 문서는 깊이 있게, 지원하지 않는 문서는 솔직하게.

특정 업체명이 아닌 범주입니다. 엔터프라이즈 열은 엔터프라이즈 IDV 업체 사이트를 검토하며 발견한 패턴을 설명합니다.

ShieldID의 문서 검증을 일반적인 엔터프라이즈 IDV 플랫폼 및 수동 신분증 확인과 비교한 표입니다.
기능	ShieldID	일반적인 엔터프라이즈 IDV	수동 확인
앞면과 뒷면을 읽고 바코드와 MRZ를 필드별로 교차 확인	예	대체로 제공	앞면만 확인, 육안 판독
낯설거나 목록에 없는 문서도 거부하지 않고 계속 진행	예	자주 거부함	직원 교육 수준에 따라 다름
문서 단위의 통과 또는 실패 하나가 아닌 필드별 판정	예	드묾	n/a
요청자가 제시한 내용과 이름 및 신원을 3자 비교	예	때때로	수동으로, 하는 경우에 한해
증거에 따라 신분증 또는 셀카 중 원인을 짚어 주는 안내형 재촬영	예	드묾	n/a
숨겨진 관문이 아닌 참고용으로 솔직하게 보고되는 문서 변조 점수	예	거의 공개되지 않음	신호 없음

문의

문서 인증에 대한 솔직한 답변입니다.

내 문서로 직접 확인해 보세요

실제 운전면허증이나 여권으로 sandbox 인증을 실행해 보세요.

샌드박스 세션을 만들고 본인의 휴대폰으로 앞면과 뒷면을 읽어 필드별 결과를 확인해 보세요. 샌드박스 세션에는 요금이 청구되지 않습니다.

sandbox에서 무료로 시작하기 데모 예약하기