Documentation Index
Fetch the complete documentation index at: https://developers.argosidentity.com/llms.txt
Use this file to discover all available pages before exploring further.
안녕하세요, ARGOS Identity입니다.
4월에 제공되는 신규 기능과 개선 사항을 안내드립니다.
Device Info 탭 신설과 Fingerprint option 추가
신규 기능
인증강화 및 위조방지 설정의 탭 구조가 3개로 확장되었습니다. 기존 “추가 인증 & 메타정보” 탭에 포함되어 있던 Device Verification 옵션은 Device Info 전용 탭으로 이동되었으며, 디바이스 Fingerprint 기반의 Fingerprint option과 Device 중복 검사가 신규로 추가되었습니다.
Device Info는 라이브폼 진입 시 가장 먼저 수행되는 검증입니다. Device Info 단계에서 차단되면 Turnstile·Proxy & VPN 감지·KYC 본 프로세스로 진입하지 못합니다.
Fingerprint option (신규)
차단할 항목을 개별 체크박스로 선택합니다. 하나라도 탐지되면 오류 페이지(DE-30000)로 리다이렉트됩니다.
| 항목 | 차단 대상 |
|---|
| 가상 머신 (Virtual machine) | VMware, Parallels 등 가상화 환경 |
| 에뮬레이터 (Emulator) | 모바일 디바이스를 시뮬레이션하는 안드로이드 앱 플레이어 |
| 악성 봇 (Malicious bot) | 자동화 스크립트, 브라우저 자동화 도구 |
| 브라우저 변조 (Browser tampering) | API 시그니처가 조작·위조된 브라우저 |
Device 중복 검사 (신규)
동일 기기에서 KYC 승인이 발생할 수 있는 횟수를 제한합니다.
| 설정 | 설명 |
|---|
| 디바이스당 허용 횟수 | 동일 Device에서 승인될 수 있는 최대 KYC 건수 (기본 3회) |
| 감지 기간 | 중복 계산 기간. ON 상태에서 일수를 지정(기본 30일), OFF 시 기간 제한 없이 무한 누적 |
| 중복 감지 시 정책 | Fail if duplicate(차단 → DE-40000) 또는 Register and Pass(기록 후 통과) |
신규 에러 코드
| 에러 코드 | 발생 조건 |
|---|
DE-30000 | Fingerprint option 감지 항목 중 하나 이상 탐지 |
DE-40000 | Device Duplicate Check 정책이 Fail if duplicate인 상태에서 허용 횟수 초과 감지 |
정부데이터 확인 파이프라인 신분증별 분할
기능 개선
정부데이터 확인 - 한국이 기존 단일 ON/OFF 토글에서 신분증 종류별 개별 스위치로 분할되어, 고객사 요구에 맞춰 특정 신분증에 한해 진위확인을 수행할 수 있습니다. 진위확인 서버의 일시적 이슈 상황에도 영향받는 신분증만 선택적으로 OFF 할 수 있어 운영 유연성이 향상됩니다.
개별 제어 스위치
| 스위치 | 대상 신분증 |
|---|
| 주민등록증 | 주민등록증 |
| 운전면허증 | 운전면허증 |
| 여권 | 여권 |
| 외국인등록증 | 외국인등록증 / 외국국적동포 국내거소신고증 / 영주증 (3종 통합 제어) |
외국인등록증 스위치는 외국인등록증, 외국국적동포 국내거소신고증, 영주증 3가지 신분증 종류를 동시에 제어합니다.
진위확인에 필요한 값(이름, 생년월일, 주민등록번호 등)이 누락된 경우에는 해당 스위치가 ON 이어도 항상 미적용됩니다.
Return URL 에러 코드 전달 지원
기능 업데이트
Dashboard 연동 정보 > 리턴 URL 설정의 동적 필드에 **에러 코드(errorCode)**가 신규 추가되었습니다. 사용자가 사전 검증(Device Info 등) 또는 토큰 검증에서 차단되어 오류 페이지로 이동한 경우에도, 리턴 URL 버튼으로 고객사 서비스에 복귀할 수 있습니다. 이때 URL 쿼리스트링에 errorCode 값이 포함되어 고객사 측에서 차단 사유를 식별할 수 있습니다.
리턴 URL 예시 (오류 페이지 → 리턴 URL):
https://yourapp.com/verification-complete?kycStatus=rejected&errorCode=DE-20000
토큰 에러 코드 표준화 (TK-10000 ~ TK-10004)
기능 개선
토큰 관련 오류 페이지에 TK- 접두사의 에러 코드가 부여되고, 사용자 메시지가 명확하게 개선되었습니다. 기존에는 개발자 코드(token-missing 등)만 노출되어 고객사 문의가 반복 발생했으나, 이제는 에러 코드와 정의가 함께 제공되어 트러블슈팅이 용이해집니다.
| 유형 | 에러 코드 | 사용자 메시지 |
|---|
| 토큰 누락 | TK-10000 | ”유효한 링크가 아닙니다” |
| 토큰 만료 | TK-10001 | ”링크가 만료되었습니다” |
| 토큰 승인 완료 | TK-10002 | ”이미 인증이 완료되었습니다” |
| 토큰 검토 중 | TK-10003 | ”현재 검토가 진행 중입니다” |
| 토큰 거부 | TK-10004 | ”기존 요청이 승인되지 않았습니다” |
만료된 신분증(Expired ID) 후속 처리 옵션 추가
기능 업데이트
만료된 신분증이 제출되었을 때의 후속 처리 방식을 고객사가 직접 선택할 수 있는 Expired ID 옵션이 인증강화 및 위조방지 > 신분증 및 얼굴 기반 설정에 추가되었습니다. 기존에는 만료 신분증이 자동으로 거절되었으나, 이제 Retry 또는 Warning으로 분기 처리할 수 있습니다.
| 옵션 | 동작 |
|---|
| Retry — 재시도 요청 (기본값) | 사용자에게 신분증 재제출을 요청합니다. |
| Warning — 기록 후 진행 | Step 1·2의 Expired ID 조건을 모두 우회(bypass)하고, Warning 상태로 기록한 후 승인 프로세스를 이어갑니다. Step 2의 자동 만료일 Reject 처리도 Approved + Warning으로 대체됩니다. |
Warning 데이터
Warning 상태로 승인된 제출건은 대시보드에 다음과 같이 Warning 데이터가 남습니다.
| User Data | Related Engine |
|---|
ID Card | Expiry validation |
User Input | Expiry validation |
Custom Policy 트리거 추가
Warning 분기 처리에 맞춰 Custom Policy의 Trigger 목록에 Warning 조건이 추가되어, 만료 신분증으로 인한 Warning을 트리거 조건으로 활용할 수 있습니다.
ID Liveness 업로드 모드 Warning 자동 전환
기능 업데이트
ID Liveness 정책의 각 파이프라인(화면 재생 / 종이 출력물 / 초상화 교체)에서 Retry를 선택하면, 하위 체크박스 **업로드 시 Warning 적용(Apply Warning on Upload)**이 새로 노출됩니다. 체크 시, 해당 파이프라인의 Retry는 사용자가 업로드(Upload) 모드로 신분증을 제출한 경우에 한해 Warning으로 전환됩니다. 업로드 모드 사용자에게는 재촬영 수단이 제공되지 않으므로, Retry 대신 Warning으로 처리해 프로세스를 이어갈 수 있게 합니다.
- 파이프라인별로 독립적으로 설정할 수 있습니다.
- 체크박스는 Retry가 선택된 경우에만 활성화됩니다. Warning 선택 시에는 노출되지 않습니다.
Custom Policy 노출
업로드 모드에서 자동 전환된 Warning 데이터가 Custom Policy 목록에 노출됩니다.
| 필드 | 값 |
|---|
userDataType | ID_card_uploaded |
relatedEngine | ID Liveness Screen replay |
계정 비밀번호 변경 기능 추가
신규 기능
기존에는 비밀번호를 변경하려면 로그아웃 후 비밀번호 찾기 플로우를 통해서만 가능했습니다. 이제 로그인된 상태에서 대시보드 계정 메뉴바 > 비밀번호 변경을 통해 직접 변경할 수 있습니다. OTP 설정 여부에 따라 분기 처리됩니다.
| 조건 | 동작 |
|---|
| OTP 미설정 | 모달에서 현재 비밀번호와 새 비밀번호를 입력하여 즉시 변경합니다. |
| OTP 설정 | OTP 인증을 거친 후 새 비밀번호로 변경합니다. |
Submission 검색 최소 글자 수 축소 (3 → 2)
UX 개선
Submission 목록 검색 시 기존 3글자 이상 입력해야 결과가 표시되던 조건이 2글자 이상으로 완화되었습니다. 2자리 userId를 사용하는 고객사 환경에서도 정상적으로 검색할 수 있습니다.
Passive Face Auto Capture 기능 추가
신규 기능
라이브폼 패시브 얼굴 촬영에 자동 캡처(Auto Capture) 기능이 추가되었습니다. 사용자가 가이드에 맞춰 얼굴을 위치시키면 별도의 버튼 입력 없이 촬영이 자동으로 완료됩니다.
변경 사항
- 안내 문구가 화면 상단으로 이동되어 가이드 가시성이 향상되었습니다.
- 신규 캡처 타입
face-passive-auto-capture가 추가되었습니다.
- 촬영 대기 시간이 2초 → 1초로 단축되었습니다.
한국 외국인 등록증 만료일 OCR 추출 지원
기능 업데이트
한국 외국인 등록증의 만료일(expiry_date) 인식 설정이 활성화되었습니다. 외국인 등록증에서도 만료일을 자동으로 추출하여 만료 검증 및 Custom Policy에 활용할 수 있습니다.
외국인 등록증에 체류 만료일로 표시된 값을 신분증의 expiry_date로 사용합니다.
동작 방식
OCR 추출 시 expiry_date 및 expiry_date0 값을 우선순위 순서대로 참조하며, 인식된 값은 GET Submission API 응답의 data.idcard_expireDate 필드를 통해 확인할 수 있습니다.
| 우선순위 | 필드 |
|---|
| 1 | expiry_date |
| 2 | expiry_date0 |
{
"data": {
"idcard_expireDate": "2030-12-31"
}
}
Submission 응답에 영문 이름(full_name_en) 추가
신규 기능
KYC 가 승인(Approved) 된 시점에 제출자의 Full Name 을 영문으로 변환한 full_name_en (DB: fullNameEn) 필드가 추가됩니다. 한국 운전면허증·주민등록증처럼 한글로 인식된 이름을 해외 시스템에 전달해야 하는 환경에서 별도 변환 작업 없이 활용할 수 있습니다.
처리 정책
| 항목 | 내용 |
|---|
| 트리거 | KYC 승인 시 1회 처리 |
| 변환 방식 | 음역(transliteration). 의역하지 않습니다. (예: 김 산 → KIM SAN이며 KIM Mountain 으로 변환되지 않음) |
| 원본 언어 | 영어인 경우 그대로 full_name_en 에 채워짐 |
| 적용 범위 | Submission API 응답(Get Submission, Partial Delete, Projection 등 data.full_name 이 노출되는 모든 곳), Webhook(idcheck-approved, idcheck-updated), 대시보드 Submission 상세 |
| 제외 범위 | First Name / Last Name 은 영문 변환 미제공. 라이브폼 단계에서는 노출되지 않으며, 비교(중복 검사 등) 로직의 대상이 아닙니다. |
| 대시보드 동작 | Submission 상세에서 표시되며, 관리자가 수정할 수 있습니다. |
라이브폼 스트리밍 — 업로드 이미지 Quality Check 옵션
기능 업데이트
대시보드 인증강화 및 위조방지 → 신분증 위조 방지 → 라이브폼 스트리밍 촬영만 진행 → 신분증 업로드 허용 하위에 Image Quality Check 토글이 신규 추가되었습니다. 업로드 환경에 따라 IQC 가 반복 실패하는 케이스가 발견되는 경우 토글을 OFF 로 전환해 사용자가 인증 흐름을 완료할 수 있도록 조정할 수 있습니다.
| Image Quality Check | 동작 |
|---|
| ON (기본값) | 업로드 이미지에 대해 FE Image Quality Check 를 수행합니다. 내부 품질 기준 미달 시 alert 메시지가 노출됩니다. |
| OFF | 업로드 이미지에 대해 FE Image Quality Check 를 스킵하고, 후속 백엔드 프로세스 및 기존 후속 정책으로 진행합니다. |
Image Quality Check 토글은 라이브폼 스트리밍 ON + 신분증 업로드 허용 ON 인 경우에만 노출됩니다.
startValidUntil — 인증 시작 전 유효시간 설정
신규 기능
쿼리스트링 옵션 startValidUntil 이 추가되어, 사용자가 라이브폼 링크에 진입하기 전에 만료시킬 수 있는 유효시간을 설정할 수 있습니다. 미성년자 보호자 인증처럼 별도 프로젝트로 발송한 인증 링크에 일정 시간 내 진입을 강제하고 싶은 경우 사용합니다. 기존의 “인증 시작 후 유효시간”과는 별개로 동작합니다.
{
"startValidUntil": "2026-04-30T15:00:00Z"
}
| 항목 | 내용 |
|---|
| 시간 기준 | 항상 UTC+0 으로 해석합니다. |
| 전달 방식 | 쿼리스트링 encrypted 안에 포함하여 반드시 암호화 상태로 전달합니다. 평문 사용 불가. |
| 검증 우선순위 | 토큰 ID 검증 등 다른 검증보다 먼저 평가됩니다. 시작 만료가 확인되면 그 이후 검증은 수행되지 않습니다. |
| 지원 파이프라인 | ID Document, Knowledge-based |
| 만료 시 동작 | 오류 페이지 /error-page/expired-start-valid-until (에러 코드 PV-40018) 로 이동하며 사용자에게 “The verification link has expired. Please try again with a new link.” 가 노출됩니다. |
ARGOS는 더 강력한 보안과 더 나은 사용자 경험을 위해 본인 인증 서비스를 지속적으로 개선하고 있습니다.
ARGOS Identity를 이용해 주셔서 감사합니다.
ARGOS Identity 팀
