에러 페이지 세분화 & 무한 재시도 루프 차단
기능 개선 신분증 라이브니스·셀피(Passive) 라이브니스·얼굴 비교·한국 정부 진위확인 등 주요 엔진 처리가 연속으로 실패할 경우, 기존에는 사용자가 무한 재시도 루프에 빠지는 문제가 있었습니다. 이번 개선으로 동일 오류가 3회 누적되면 재시도 대신 오류 유형별 전용 에러 페이지로 이동하도록 변경되었습니다. 3회 미만에서는 재촬영 안내 또는 알림으로 처리됩니다.신규 에러 코드
엔진 오류 (SE) — 엔진별로 전용 에러 페이지가 분리되어, 고객사가 어떤 엔진에서 실패했는지 즉시 식별할 수 있습니다.
| 에러 코드 | 엔진 |
|---|---|
SE-50020 | 신분증 라이브니스 (ID Liveness) |
SE-50021 | 셀피 Passive 라이브니스 |
SE-50022 | 얼굴 비교 (Face Compare) |
SE-50030 | 한국 정부 진위확인 — 주민등록증 |
SE-50031 | 한국 정부 진위확인 — 운전면허증 |
SE-50032 | 한국 정부 진위확인 — 여권 |
SE-50033 | 한국 정부 진위확인 — 외국인등록증 |
LO) — 신분증 촬영·단계 처리 중 동일 오류가 3회 누적되면 루프 차단 페이지로 이동합니다. 매핑되지 않는 루프 오류는 Fallback으로 처리됩니다.
| 에러 코드 | 발생 조건 |
|---|---|
LO-30001 | OCR 신분증 인식 실패 |
LO-30002 | 데이터 처리 오류 |
LO-30003 | 필수 파라미터 누락 |
LO-30004 | requestId 누락 |
LO-30005 | 신분증 이미지 품질 미달 |
LO-99999 | 위 항목에 매핑되지 않은 루프 오류 (Fallback) |
Error Handling Method (오류 시 처리 방식) — Warning 전환 & Custom Policy 연계
엔진 오류 발생 시의 처리 방식을 대시보드에서Error(기본 — 전용 에러 페이지로 이동) ↔ Warning(해당 검증 Skip 후 진행) 중 선택할 수 있습니다. 신분증 라이브니스 · 셀피 Passive 라이브니스 · 한국 정부 진위확인 항목별로 개별 설정합니다.
Warning으로 설정하면 전용 에러 페이지로 이동하지 않고 해당 검증만 Skip한 뒤 후속 KYC 프로세스를 이어갑니다. 이때 남는 Warning 기록은 Custom Policy의 “경고 발생(Warning)” 트리거로 받아 ARGOS Score 감점·보류(Pending)·거절 등 후처리를 정책대로 적용할 수 있습니다. (만료 신분증(Expired ID) Warning 처리와 동일한 패턴)
Error Handling Method 설정은 인증강화 및 위조방지 가이드를, Warning을 활용한 Custom Policy 구성은 KYC 프로세스 가이드를, 전체 에러 코드 매핑 및 에러 페이지 정의는 에러 코드와 에러 페이지 문서를 참고하세요.
미지원 브라우저·기기 안내 강화
기능 개선 구형 브라우저·WebAssembly 미지원 환경·Android OS 9 미만 기기 등 미지원 환경에서 라이브폼에 접속할 경우, 기존에는 에러 코드 없이 안내 문구만 노출되었습니다. 이번 개선으로 **에러 코드RT-60002**가 부여되고 지원 환경 가이드 링크가 함께 제공됩니다. 고객사는 차단 사유를 즉시 식별하고 사용자에게 구체적인 안내를 제공할 수 있습니다.
관리자 권한 관리(RBAC) 개선
신규 기능 아르고스(내부) 관리자와 프로젝트 외부 관리자의 권한(역할)이 분리되어, 역할에 따라 대시보드에서 노출·수정·삭제 가능한 항목이 개별적으로 제어됩니다. 역할은 Owner · Leader · Member · Guest 로 구분됩니다.
개인정보 표시 제어
권한(역할)에 따라 사용자 제출 정보(submission)의 데이터 필드가 마스킹되어 표시됩니다. 주민등록번호·문서번호·식별번호·신분증 사진 등 개인정보(PII) 항목을 어떤 역할(Owner·Leader·Member·Guest)에 노출할지 속성 별 개인정보 표시 여부 설정에서 항목별로 지정하며, 체크되지 않은 항목은 해당 역할 관리자에게 마스킹되어 보입니다.마스킹은 화면 표시에만 적용되며, 실제 저장 데이터와 API 응답 데이터는 변경되지 않습니다. (예: 이름
홍길동 → ***, 생년월일 1990-01-15 → ****-**-**)
현재 속성 별 개인정보 표시 여부 설정에서는 신분증 사진(image) 항목만 조정할 수 있습니다. 그 외 항목은 현재 조정할 수 없으며, 추후 설정 값을 제공할 예정입니다.
권한 기반 기능 제어
권한이 없는 작업(옵션 저장·삭제·관리자 초대 취소 등)은 버튼이 노출되지 않거나, 권한 부재 안내로 일관 처리됩니다. 이를 통해 역할 범위를 벗어난 조작이 원천 차단됩니다.ARGOS는 더 강력한 보안과 더 나은 사용자 경험을 위해 본인 인증 서비스를 지속적으로 개선하고 있습니다. ARGOS Identity를 이용해 주셔서 감사합니다. ARGOS Identity 팀