메인 콘텐츠로 건너뛰기

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.

Device Verification은 KYC 인증에 접근하는 기기 정보를 분석하여 비모바일 기기(데스크탑, 가상환경, 자동화 봇 등)의 접근을 사전에 차단하는 기능입니다. 2026-04 업데이트부터 기존 Static check(Browser / Graphics / Screen)에 더해 Fingerprint 기반 탐지Device 중복 검사가 추가되어, Device Info 탭으로 개편되었습니다.
라이브폼 진입 시 가장 먼저 수행되는 검증입니다Device Info 검증은 사용자가 KYC 라이브폼에 진입하는 순간 모든 사전 검증 중 최초로 실행됩니다. 이 단계에서 차단되면 Turnstile·Proxy & VPN 감지·KYC 본 프로세스로 진입하지 못합니다.
기능 활성화 방법프로젝트 관리 > 정책 및 인증 > 인증강화 및 위조방지 메뉴의 Device Info 탭에서 Device Verification / Fingerprint option을 설정합니다.
Device Info 설정 화면

검증 유형

Device Verification 페이지에서는 두 가지 유형의 검증 결과를 확인할 수 있습니다.
유형설명실패 시 에러 코드
DeviceStatic check — Browser check, Graphics check, Screen check 3종 검사. 비모바일 기기 여부를 판별합니다.DE-20000
FingerprintFingerprint option — 가상 머신, 에뮬레이터, 악성 봇, 브라우저 변조 탐지 및 Device 중복 검사.DE-30000 (탐지) / DE-40000 (중복 초과)

Device (Static check)

기기 정보를 분석하여 모바일 기기 여부를 판별하며, 비모바일 기기로 판단될 경우 FAIL 처리됩니다.
3가지 검증 중 1개라도 FAIL이면 해당 기기의 KYC 접근이 차단되며, 오류 페이지(DE-20000)로 리다이렉트됩니다.
검증 항목검증 대상설명
Browser checkUser-Agent브라우저의 UserAgent 값을 분석하여, 접속 기기가 모바일이 아닌 데스크탑 PC 또는 자동화 도구(봇)인 경우 차단합니다.
Graphics checkWebGL Renderer기기의 WebGL 정보를 통해 GPU/그래픽 카드를 탐지하여, 모바일에 탑재될 수 없는 데스크탑 전용 GPU 또는 가상환경이 감지되면 차단합니다.
Screen checkTouch Points디바이스의 터치스크린 지원 여부를 분석하여, 모바일 기기에서 지원하는 멀티터치 수준에 미달하는 경우 차단합니다.

Fingerprint 2026-04 신규

디바이스 Fingerprint(Visitor ID)를 기반으로 가상 환경·에뮬레이터·자동화 봇·변조 브라우저를 탐지하고, 동일 기기의 반복 승인을 제한합니다.
검증 항목차단 대상실패 시
Virtual machineVMware, Parallels 등 가상화 환경DE-30000
Emulator모바일 디바이스를 시뮬레이션하는 안드로이드 앱 플레이어DE-30000
Malicious bot자동화 스크립트, 브라우저 자동화 도구DE-30000
Browser tamperingAPI 시그니처가 조작·위조된 브라우저DE-30000
Device Duplicate Check허용 횟수를 초과한 동일 Visitor ID의 신규 요청DE-40000 (정책이 “Fail if duplicate”일 때)
검증 기준은 지속적으로 업데이트되며, 구체적인 탐지 로직은 보안상 공개되지 않습니다.

검증 결과 목록

Device Verification이 활성화된 경우, 각 KYC 접근 시도에 대한 기기 검증 결과를 목록에서 확인할 수 있습니다. DeviceFingerprint 두 유형이 하나의 목록에 함께 표시되며, 상단의 Table Columns로 표시 컬럼을 선택할 수 있습니다.
Device Verification 검증 결과 목록 화면

공통 컬럼

항목설명
Submission Time (UTC+9)제출 시도 시간
이메일제출자 이메일
Validation ID사전 검증 공통 식별자
Type검증 유형 (Device / Fingerprint)
Visitor IDFingerprint 기반 디바이스 고유 식별자. Fingerprint 유형 행에만 값이 노출되며, Device 행에서는 - 로 표시됩니다.
Status전체 검증 종합 결과 (Pass / Fail)

Device (Static check) 추가 컬럼

Table Columns에서 활성화하면 Static check 원본 데이터와 세부 결과를 함께 조회할 수 있습니다.
항목설명
UA DeviceUserAgent 원본 데이터
GPU RendererWebGL GPU Renderer 원본 데이터
Touch Pts터치 포인트 원본 수치
UA CheckBrowser check 결과 (Pass/Fail)
Detected UABrowser check에서 감지된 키워드
WebGL CheckGraphics check 결과 (Pass/Fail)
Detected WebGLGraphics check에서 감지된 키워드
Touch CheckScreen check 결과 (Pass/Fail)
Detected TPScreen check에서 감지된 터치 포인트 수
Fingerprint 유형 행에서는 Static check 원본 컬럼이 -로 표시되며, Visitor IDStatus에 값이 노출됩니다. Fingerprint 상세 값은 상세보기 모달에서 확인할 수 있습니다.

검증 상세보기

목록에서 각 데이터를 클릭하면, 해당 검증 건의 상세 정보 모달이 표시됩니다.
Device Verification 상세정보 모달 화면

기본 정보

필드설명
제출시간검증이 발생한 시간
이메일제출자 이메일
Validation ID사전 검증 공통 식별자
Submission ID연결된 제출건 ID (있는 경우)
종류검증 유형 (Device)

디바이스 검증 상태

각 검증 항목별 통과(Pass) 또는 실패(Fail) 여부를 확인할 수 있습니다.
항목설명
UA 검증해당 디바이스의 User-Agent 문자열 검증 여부
WebGL 검증해당 디바이스의 WebGL 렌더러 검증 여부
Touch 검증해당 디바이스의 터치 포인트 검증 여부

디바이스 감지 정보

실제 검증 시 감지된 블랙리스트 키워드 정보입니다.
항목설명
감지된 UAUA 검증 시 감지된 실제 User-Agent 키워드
감지된 WebGLWebGL 검증 시 감지된 실제 렌더러 키워드
감지된 Touch PointsTouch 검증 시 감지된 실제 터치 포인트 수

추가 정보

기기에서 수집된 원본 데이터입니다.
항목설명
UA Device전체 UserAgent 문자열 원본
GPU RendererWebGL을 통해 수집된 GPU Renderer 문자열 원본
Touch Points감지된 동시 터치 포인트 수 원본

제출건 상세보기에서의 확인

사용자 제출건의 상세보기에서 사전 검증 목록 드롭다운을 통해 해당 제출건의 Device Verification 결과에 바로 접근할 수 있습니다.
제출건 상세보기에서 사전 검증 목록 드롭다운
드롭다운을 클릭하면 해당 제출건과 연결된 사전 검증 카테고리(Device Verification, VPN & Proxy)와 Validation ID가 표시되며, 클릭하면 해당 상세 페이지로 이동합니다.

차단 시 사용자 오류 페이지

Device Verification에서 FAIL이 발생하면 사용자에게 실패한 검증 유형에 따라 다른 오류 페이지가 표시됩니다. 모든 오류 페이지에는 에러 코드와 정의가 함께 노출되어, 고객사가 원인을 빠르게 진단할 수 있습니다.
에러 코드발생 조건
DE-20000Device Verification(Static check) — Browser / Graphics / Screen check 중 하나 이상 실패
DE-30000Fingerprint option — 가상 머신 / 에뮬레이터 / 악성 봇 / 브라우저 변조 중 하나 이상 탐지
DE-40000Device Duplicate Check — 허용 횟수를 초과한 중복 기기 감지 + 정책이 Fail if duplicate
Device Verification 차단 시 오류 페이지
인증을 진행할 수 없습니다 아래 항목을 확인한 뒤 다시 시도해 주세요.
  • 모바일 기기에서 접속
  • 브라우저 최신 버전 사용
  • 시크릿 모드/확장 프로그램(광고차단 등) 비활성화 후 재시도
전체 에러 코드 상세는 에러 코드와 에러 페이지 — DE 카테고리를 참고하세요.

검증 프로세스 흐름

Device Info 검증은 사용자가 KYC 라이브폼에 진입하는 순간 가장 먼저 실행되며, Turnstile·Proxy & VPN 감지·KYC 본 프로세스보다 선행합니다.
1

라이브폼 진입

사용자가 KYC 라이브폼에 진입합니다. 시작하기 버튼 클릭 직후 Device Info 검증이 자동으로 수행됩니다.
2

Device Verification (Static check) 실행

Browser check, Graphics check, Screen check 3가지 항목을 순차적으로 검증합니다.
1개라도 FAIL이 발생하면 오류 페이지(DE-20000)로 리다이렉트됩니다.
3

Fingerprint option 실행

Static check를 통과하면 Fingerprint 기반 탐지(가상 머신 / 에뮬레이터 / 악성 봇 / 브라우저 변조)와 Device 중복 검사가 수행됩니다.
감지 항목 중 하나라도 탐지되면 DE-30000, Device Duplicate Check 정책이 Fail if duplicate인 상태에서 중복이 감지되면 DE-40000 오류 페이지로 리다이렉트됩니다.
4

Turnstile 체크

Device Info 검증을 통과하면 Turnstile 검증이 진행됩니다.
5

Proxy & VPN 검증

Turnstile 통과 후 Proxy & VPN 감지가 실행됩니다.
6

KYC 프로세스 진행

모든 사전 검증을 통과하면 정상적으로 KYC 인증 프로세스가 시작됩니다.
모든 검증 항목이 PASS인 경우에만 KYC 프로세스에 진입합니다.

관련 문서

VPN & Proxy

VPN & Proxy 감지 결과를 확인합니다.

인증강화 및 위조방지

Device Verification 옵션 설정 방법을 확인합니다.

사용자 제출건

제출 목록 관리 및 상세 정보를 확인합니다.

오류 코드 및 페이지

전체 오류 코드 목록을 확인합니다.