> ## 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.

# 2026년 4월 업데이트 안내

> 2026년 4월 ARGOS Identity 제품 업데이트 안내

안녕하세요, ARGOS Identity입니다.

4월에 제공되는 신규 기능과 개선 사항을 안내드립니다.

***

## Device Info 탭 신설과 Fingerprint option 추가

<span style={{backgroundColor: '#EEF4FF', color: '#0064FF', padding: '4px 12px', borderRadius: '16px', fontSize: '13px', fontWeight: '600'}}>신규 기능</span>

**인증강화 및 위조방지** 설정의 탭 구조가 3개로 확장되었습니다. 기존 "추가 인증 & 메타정보" 탭에 포함되어 있던 Device Verification 옵션은 **Device Info** 전용 탭으로 이동되었으며, 디바이스 Fingerprint 기반의 **Fingerprint option**과 **Device 중복 검사**가 신규로 추가되었습니다.

<Info>
  **Device Info는 라이브폼 진입 시 가장 먼저 수행되는 검증입니다.** Device Info 단계에서 차단되면 Turnstile·Proxy & VPN 감지·KYC 본 프로세스로 진입하지 못합니다.
</Info>

### 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`인 상태에서 허용 횟수 초과 감지 |

오류 페이지에는 에러 코드와 정의가 함께 노출되어 고객사가 차단 사유를 즉시 식별할 수 있습니다.

<Tip>
  자세한 설정 방법은 [인증강화 및 위조방지 — Device Info](/dashboard/ko/project-management/policy-and-authentication/anti-fraud-and-forgery-prevention#device-info) 가이드를, 결과 확인 방법은 [Device Verification 사전 검증 목록](/dashboard/ko/preverification/device-verification) 가이드를 참고하세요.
</Tip>

***

## 정부데이터 확인 파이프라인 신분증별 분할

<span style={{backgroundColor: '#EEF4FF', color: '#0064FF', padding: '4px 12px', borderRadius: '16px', fontSize: '13px', fontWeight: '600'}}>기능 개선</span>

**정부데이터 확인 - 한국**이 기존 단일 ON/OFF 토글에서 **신분증 종류별 개별 스위치**로 분할되어, 고객사 요구에 맞춰 특정 신분증에 한해 진위확인을 수행할 수 있습니다. 진위확인 서버의 일시적 이슈 상황에도 영향받는 신분증만 선택적으로 OFF 할 수 있어 운영 유연성이 향상됩니다.

### 개별 제어 스위치

| 스위치    | 대상 신분증                                   |
| ------ | ---------------------------------------- |
| 주민등록증  | 주민등록증                                    |
| 운전면허증  | 운전면허증                                    |
| 여권     | 여권                                       |
| 외국인등록증 | 외국인등록증 / 외국국적동포 국내거소신고증 / 영주증 (3종 통합 제어) |

<Info>
  외국인등록증 스위치는 **외국인등록증, 외국국적동포 국내거소신고증, 영주증** 3가지 신분증 종류를 동시에 제어합니다.
</Info>

<Warning>
  진위확인에 필요한 값(이름, 생년월일, 주민등록번호 등)이 누락된 경우에는 해당 스위치가 ON 이어도 항상 미적용됩니다.
</Warning>

<Tip>
  설정 방법은 [인증강화 및 위조방지 — 정부데이터 확인 - 한국](/dashboard/ko/project-management/policy-and-authentication/anti-fraud-and-forgery-prevention#정부데이터-확인---한국) 가이드를 참고하세요.
</Tip>

***

## Return URL 에러 코드 전달 지원

<span style={{backgroundColor: '#EEF4FF', color: '#0064FF', padding: '4px 12px', borderRadius: '16px', fontSize: '13px', fontWeight: '600'}}>기능 업데이트</span>

Dashboard **연동 정보 > 리턴 URL** 설정의 동적 필드에 \*\*에러 코드(`errorCode`)\*\*가 신규 추가되었습니다. 사용자가 사전 검증(Device Info 등) 또는 토큰 검증에서 차단되어 오류 페이지로 이동한 경우에도, 리턴 URL 버튼으로 고객사 서비스에 복귀할 수 있습니다. 이때 URL 쿼리스트링에 `errorCode` 값이 포함되어 고객사 측에서 차단 사유를 식별할 수 있습니다.

**리턴 URL 예시 (오류 페이지 → 리턴 URL):**

```
https://yourapp.com/verification-complete?kycStatus=rejected&errorCode=DE-20000
```

<Info>
  전체 에러 코드 매핑은 [에러 코드와 에러 페이지](/ko/idcheck/reference_tables/Error-codes-and-pages) 문서에서 확인할 수 있습니다.
</Info>

<Tip>
  설정 방법은 [연동 정보 — 동적 필드](/dashboard/ko/project-management/project-settings/integration-info#동적-필드) 가이드와 [리턴 URL 가이드](/ko/idcheck/getting-started/liveform-url/return-url-guide)를 참고하세요.
</Tip>

***

## 토큰 에러 코드 표준화 (TK-10000 \~ TK-10004)

<span style={{backgroundColor: '#EEF4FF', color: '#0064FF', padding: '4px 12px', borderRadius: '16px', fontSize: '13px', fontWeight: '600'}}>기능 개선</span>

토큰 관련 오류 페이지에 **TK-** 접두사의 에러 코드가 부여되고, 사용자 메시지가 명확하게 개선되었습니다. 기존에는 개발자 코드(`token-missing` 등)만 노출되어 고객사 문의가 반복 발생했으나, 이제는 에러 코드와 정의가 함께 제공되어 트러블슈팅이 용이해집니다.

| 유형       | 에러 코드      | 사용자 메시지             |
| -------- | ---------- | ------------------- |
| 토큰 누락    | `TK-10000` | "유효한 링크가 아닙니다"      |
| 토큰 만료    | `TK-10001` | "링크가 만료되었습니다"       |
| 토큰 승인 완료 | `TK-10002` | "이미 인증이 완료되었습니다"    |
| 토큰 검토 중  | `TK-10003` | "현재 검토가 진행 중입니다"    |
| 토큰 거부    | `TK-10004` | "기존 요청이 승인되지 않았습니다" |

<Tip>
  상세 메시지와 발생 조건은 [에러 코드와 에러 페이지 — 토큰 에러 페이지](/ko/idcheck/reference_tables/Error-codes-and-pages#-토큰-에러-페이지-error-pagetoken-) 문서를 참고하세요.
</Tip>

***

## 만료된 신분증(Expired ID) 후속 처리 옵션 추가

<span style={{backgroundColor: '#EEF4FF', color: '#0064FF', padding: '4px 12px', borderRadius: '16px', fontSize: '13px', fontWeight: '600'}}>기능 업데이트</span>

만료된 신분증이 제출되었을 때의 후속 처리 방식을 고객사가 직접 선택할 수 있는 **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을 트리거 조건으로 활용할 수 있습니다.

<Tip>
  정책 설정 방법은 [KYC 프로세스](/dashboard/ko/project-management/policy-and-authentication/kyc-process) 대시보드 가이드를 참고하세요.
</Tip>

***

## ID Liveness 업로드 모드 Warning 자동 전환

<span style={{backgroundColor: '#EEF4FF', color: '#0064FF', padding: '4px 12px', borderRadius: '16px', fontSize: '13px', fontWeight: '600'}}>기능 업데이트</span>

ID Liveness 정책의 각 파이프라인(**화면 재생 / 종이 출력물 / 초상화 교체**)에서 **Retry**를 선택하면, 하위 체크박스 \*\*업로드 시 Warning 적용(Apply Warning on Upload)\*\*이 새로 노출됩니다. 체크 시, 해당 파이프라인의 Retry는 사용자가 **업로드(Upload) 모드**로 신분증을 제출한 경우에 한해 **Warning으로 전환**됩니다. 업로드 모드 사용자에게는 재촬영 수단이 제공되지 않으므로, Retry 대신 Warning으로 처리해 프로세스를 이어갈 수 있게 합니다.

<Frame caption="ID liveness — 각 파이프라인의 Retry 하위에 추가된 '업로드 시 Warning 적용' 체크박스">
  <img src="https://mintcdn.com/argosidentity/fpDstxKfAm-MWyjA/images/dashboard/new/pj/policy-and-aythentication/anti-fraud-and-forgery/id_liveness.png?fit=max&auto=format&n=fpDstxKfAm-MWyjA&q=85&s=cfde129275c6c0d91a3e69880d4bda47" alt="ID liveness 설정에서 화면 재생·종이 출력물·초상화 교체 각각의 Retry 하위에 '업로드 시 Warning 적용' 체크박스가 노출된 화면" width="1732" height="433" data-path="images/dashboard/new/pj/policy-and-aythentication/anti-fraud-and-forgery/id_liveness.png" />
</Frame>

* 파이프라인별로 독립적으로 설정할 수 있습니다.
* 체크박스는 **Retry가 선택된 경우에만** 활성화됩니다. Warning 선택 시에는 노출되지 않습니다.

### Custom Policy 노출

업로드 모드에서 자동 전환된 Warning 데이터가 Custom Policy 목록에 노출됩니다.

| 필드              | 값                           |
| --------------- | --------------------------- |
| `userDataType`  | `ID_card_uploaded`          |
| `relatedEngine` | `ID Liveness Screen replay` |

<Tip>
  정책 설정은 [KYC 프로세스](/dashboard/ko/project-management/policy-and-authentication/kyc-process) 대시보드 가이드를 참고하세요.
</Tip>

***

## 계정 비밀번호 변경 기능 추가

<span style={{backgroundColor: '#EEF4FF', color: '#0064FF', padding: '4px 12px', borderRadius: '16px', fontSize: '13px', fontWeight: '600'}}>신규 기능</span>

기존에는 비밀번호를 변경하려면 로그아웃 후 **비밀번호 찾기** 플로우를 통해서만 가능했습니다. 이제 로그인된 상태에서 대시보드 **계정 메뉴바 > 비밀번호 변경**을 통해 직접 변경할 수 있습니다. **OTP 설정 여부**에 따라 분기 처리됩니다.

| 조건          | 동작                                   |
| ----------- | ------------------------------------ |
| **OTP 미설정** | 모달에서 현재 비밀번호와 새 비밀번호를 입력하여 즉시 변경합니다. |
| **OTP 설정**  | OTP 인증을 거친 후 새 비밀번호로 변경합니다.          |

***

## Submission 검색 최소 글자 수 축소 (3 → 2)

<span style={{backgroundColor: '#EEF4FF', color: '#0064FF', padding: '4px 12px', borderRadius: '16px', fontSize: '13px', fontWeight: '600'}}>UX 개선</span>

Submission 목록 검색 시 기존 **3글자 이상** 입력해야 결과가 표시되던 조건이 **2글자 이상**으로 완화되었습니다. 2자리 `userId`를 사용하는 고객사 환경에서도 정상적으로 검색할 수 있습니다.

***

## Passive Face Auto Capture 기능 추가

<span style={{backgroundColor: '#EEF4FF', color: '#0064FF', padding: '4px 12px', borderRadius: '16px', fontSize: '13px', fontWeight: '600'}}>신규 기능</span>

라이브폼 패시브 얼굴 촬영에 **자동 캡처(Auto Capture)** 기능이 추가되었습니다. 사용자가 가이드에 맞춰 얼굴을 위치시키면 별도의 버튼 입력 없이 촬영이 자동으로 완료됩니다.

### 변경 사항

* 안내 문구가 **화면 상단**으로 이동되어 가이드 가시성이 향상되었습니다.
* 신규 캡처 타입 `face-passive-auto-capture`가 추가되었습니다.
* 촬영 대기 시간이 **2초 → 1초**로 단축되었습니다.

***

## 한국 외국인 등록증 만료일 OCR 추출 지원

<span style={{backgroundColor: '#EEF4FF', color: '#0064FF', padding: '4px 12px', borderRadius: '16px', fontSize: '13px', fontWeight: '600'}}>기능 업데이트</span>

한국 **외국인 등록증**의 만료일(`expiry_date`) 인식 설정이 활성화되었습니다. 외국인 등록증에서도 만료일을 자동으로 추출하여 만료 검증 및 Custom Policy에 활용할 수 있습니다.

<Note>
  외국인 등록증에 **체류 만료일**로 표시된 값을 신분증의 `expiry_date`로 사용합니다.
</Note>

### 동작 방식

OCR 추출 시 `expiry_date` 및 `expiry_date0` 값을 **우선순위 순서대로** 참조하며, 인식된 값은 **GET Submission API** 응답의 `data.idcard_expireDate` 필드를 통해 확인할 수 있습니다.

| 우선순위 | 필드             |
| ---- | -------------- |
| 1    | `expiry_date`  |
| 2    | `expiry_date0` |

```json API 응답 예시 theme={null}
{
  "data": {
    "idcard_expireDate": "2030-12-31"
  }
}
```

<Tip>
  전체 응답 필드는 [GET Result API](/ko/idcheck/api-reference/api-reference-guide/get-result) 문서를 참고하세요.
</Tip>

***

## Submission 응답에 영문 이름(`full_name_en`) 추가

<span style={{backgroundColor: '#EEF4FF', color: '#0064FF', padding: '4px 12px', borderRadius: '16px', fontSize: '13px', fontWeight: '600'}}>신규 기능</span>

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 상세에서 표시되며, 관리자가 수정할 수 있습니다.                                                                                                                           |

<Tip>
  응답 필드의 전체 정의는 [GET/Submission 응답 필드 정의](/ko/idcheck/api-reference/api-reference-guide/get-submission-response-fields) 문서를 참고하세요.
</Tip>

***

## 라이브폼 스트리밍 — 업로드 이미지 Quality Check 옵션

<span style={{backgroundColor: '#EEF4FF', color: '#0064FF', padding: '4px 12px', borderRadius: '16px', fontSize: '13px', fontWeight: '600'}}>기능 업데이트</span>

대시보드 **인증강화 및 위조방지 → 신분증 위조 방지 → 라이브폼 스트리밍 촬영만 진행 → 신분증 업로드 허용** 하위에 **Image Quality Check** 토글이 신규 추가되었습니다. 업로드 환경에 따라 IQC 가 반복 실패하는 케이스가 발견되는 경우 토글을 OFF 로 전환해 사용자가 인증 흐름을 완료할 수 있도록 조정할 수 있습니다.

| Image Quality Check | 동작                                                                          |
| ------------------- | --------------------------------------------------------------------------- |
| **ON** (기본값)        | 업로드 이미지에 대해 FE Image Quality Check 를 수행합니다. 내부 품질 기준 미달 시 alert 메시지가 노출됩니다. |
| **OFF**             | 업로드 이미지에 대해 FE Image Quality Check 를 스킵하고, 후속 백엔드 프로세스 및 기존 후속 정책으로 진행합니다.  |

<Frame caption="신분증 업로드 허용과 Image Quality Check 토글">
  <img src="https://mintcdn.com/argosidentity/4M_TnZ33jmdbgWtf/images/dashboard/new/pj/policy-and-aythentication/anti-fraud-and-forgery/image_quality_check.png?fit=max&auto=format&n=4M_TnZ33jmdbgWtf&q=85&s=3fe11e58c576b4447b1d2fc680e242af" alt="Image Quality Check 설정" width="1096" height="258" data-path="images/dashboard/new/pj/policy-and-aythentication/anti-fraud-and-forgery/image_quality_check.png" />
</Frame>

<Note>
  Image Quality Check 토글은 **라이브폼 스트리밍 ON + 신분증 업로드 허용 ON** 인 경우에만 노출됩니다.
</Note>

<Tip>
  설정 방법은 [인증강화 및 위조방지 — 라이브폼 스트리밍 촬영만 진행](/dashboard/ko/project-management/policy-and-authentication/anti-fraud-and-forgery-prevention#라이브폼-스트리밍-촬영만-진행) 가이드를 참고하세요.
</Tip>

***

## startValidUntil — 인증 시작 전 유효시간 설정

<span style={{backgroundColor: '#EEF4FF', color: '#0064FF', padding: '4px 12px', borderRadius: '16px', fontSize: '13px', fontWeight: '600'}}>신규 기능</span>

쿼리스트링 옵션 `startValidUntil` 이 추가되어, **사용자가 라이브폼 링크에 진입하기 전에** 만료시킬 수 있는 유효시간을 설정할 수 있습니다. 미성년자 보호자 인증처럼 별도 프로젝트로 발송한 인증 링크에 일정 시간 내 진입을 강제하고 싶은 경우 사용합니다. 기존의 "인증 시작 후 유효시간"과는 별개로 동작합니다.

```json theme={null}
{
  "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." 가 노출됩니다. |

<Tip>
  쿼리스트링 사용법은 [쿼리 스트링 및 토큰 가이드](/ko/idcheck/getting-started/liveform-url/querystring-and-token-guide) 문서를, 에러 코드 매핑은 [에러 코드와 에러 페이지](/ko/idcheck/reference_tables/Error-codes-and-pages#-pv--parameter-validation) 문서를 참고하세요.
</Tip>

***

ARGOS는 더 강력한 보안과 더 나은 사용자 경험을 위해 본인 인증 서비스를 지속적으로 개선하고 있습니다.

ARGOS Identity를 이용해 주셔서 감사합니다.
**ARGOS Identity 팀**