신분증 개인정보 영역 마스킹 - 한국
신규 기능 기존에는 아르고스 내부 콘솔을 통해서만 설정할 수 있던 신분증 번호 마스킹 옵션을, 이제 대시보드에서 직접 제어할 수 있습니다. 프로젝트 관리 > 정책 및 인증 > 인증 데이터의 일반 탭에 신규 카드가 추가되었습니다. 한국 신분증(여권·주민등록증·운전면허증·외국인등록증)에 인쇄된 번호를 수집할지, 그리고 신분증 이미지에서 가릴지를 번호 종류별로 설정합니다.
수집 안 함은 번호를 저장하지 않지만 신분증 이미지에는 그대로 표시되고, 수집 안 함 + 마스킹은 이미지에서도 가려집니다. 주민등록번호는 뒷 7자리, 문서번호는 번호 영역 전체가 가려집니다.
신분증 개인정보 영역 마스킹 설정
일련번호에는 마스킹 선택지가 없습니다. 운전면허증의 암호일련번호는 수집 여부만 선택할 수 있습니다.
신분증 인식(OCR) 엔진 개선
기능 개선 신분증 인식(OCR)에 신형 인식 엔진을 적용하고 최신 버전으로 업데이트했습니다. 신분증에서 문자 정보를 읽어내는 정확도와 처리 안정성이 전반적으로 향상됩니다. 이번 업데이트의 핵심은 한국 운전면허증·주민등록증·외국인등록증의 인식 개선입니다. 기존에 인식률이 낮았던 항목도 더 안정적으로 추출됩니다.사용자 제출건 — 사용자 지정 필드 검색
기능 개선 사용자 제출건의 텍스트 검색 기준에 사용자 지정 필드 #1 ~ #3 (cf1 ~ cf3) 이 추가되었습니다. 기존의 제출 ID·이메일·이름·유저 ID 에 더해, 연동 시스템에서 전달한 사용자 지정 필드 값으로 직접 제출건을 찾을 수 있습니다.
여기서 검색되는 값은 제출건 상세보기의 메타데이터에 표시되는 사용자 지정 필드 값과 동일합니다.
텍스트 검색 기준 선택
userId나 짧은 사용자 지정 필드 값도 정상적으로 검색할 수 있습니다.
FaceAuth API 개편 — /v3/face-auth
호환성 변경
FaceAuth REST API가 /v3/face-auth 로 개편되었습니다. 응답 필드가 camelCase로 통일되고, 목록·단건 조회가 별도 endpoint로 분리되었으며, 오류 응답이 { code, message } 하나로 정리되었습니다.
주요 변경 사항은 다음과 같습니다.
- 응답에서 field를 생략하지 않습니다. 사용하지 않은 정책·결과도 key를 그대로 두고
null을 채워 반환하므로, key 존재 여부로 정책 사용을 판정하던 코드는 수정이 필요합니다. policy가{ enabled, threshold }중첩 객체가 되었습니다. 정책 적용 여부는threshold가 아니라enabled로 판정합니다.- 페이지네이션이 단일 cursor 방식으로 바뀌었습니다.
nextPage_key(nextKey_id·nextKey_date) 대신nextCursor를 그대로cursor에 전달하며,count(12,000)는200, 기본 100)으로 대체되었습니다.limit(10 - 이미지 다운로드가
302redirect 방식이 되었습니다. 바이너리를 본문으로 직접 반환하지 않으므로 HTTP client가 redirect를 따라가야 합니다. - POST 성공 응답이
201 Created이며, 조회와 동일한 제출 객체를 반환합니다.
- FaceAuth 공통 참조 — 구 API에서 옮기기 필드 대응표와 구조 변경 정리
- FaceAuth 시작하기 엔드포인트 목록
Face Auth — 리턴 URL 지원
신규 기능 FaceAuth 프로젝트 설정에 AddOn Return URL 카드가 추가되었습니다. 인증이 끝난 뒤 사용자가 돌아갈 URL과 함께 전달할 필드를 지정할 수 있습니다.
선택한 필드는 위 순서대로 리턴 URL 쿼리에 붙습니다.
리턴 URL 예시
encrypted 파라미터 하나로 묶여 AES-256-ECB로 전달됩니다.
- FaceAuth 시작하기 — 리턴 URL 개발자 가이드
- FACE AUTH 가이드 — 리턴 URL 설정 대시보드 가이드
ARGOS는 더 강력한 보안과 더 나은 사용자 경험을 위해 본인 인증 서비스를 지속적으로 개선하고 있습니다. ARGOS Identity를 이용해 주셔서 감사합니다. ARGOS Identity 팀