신규 대시보드와 구 대시보드 비교
ID check 최상의 경험 가이드
새로운 고객을 위한 단계별 설정 가이드입니다. 아래 순서대로 진행하면 하루 안에 운영 가능한 eKYC 파이프라인을 구축할 수 있습니다.대표 시나리오 5가지
1) 금융/PG 온보딩 (실명확인+고보안)
1) 금융/PG 온보딩 (실명확인+고보안)
- 프로젝트 상태: TEST → OPEN 단계 전환
- 보안설정: 프라이빗 모드 + Token ID 사전 등록 + 암호화 전용 모드
- 인증 정책: ARGOS Score 80~85, 중복 사용자 감지
- 위조 방지: 스트리밍 촬영만 허용, Proxy & VPN 감지
2) 글로벌 플랫폼 (지역별 규제/신분증 다양성)
2) 글로벌 플랫폼 (지역별 규제/신분증 다양성)
- 프로젝트: 지역별로 분리하여 관리
- 인증 정책: 범용 신분증 지원, 국가별 제한 설정
- 위조 방지: 지역별 사전심사, 발급국가 검증
- 보안설정: IP 화이트리스트로 지역별 접근 제어
3) 커머스/마켓플레이스 (가짜 계정·다계정 방지)
3) 커머스/마켓플레이스 (가짜 계정·다계정 방지)
- 인증 정책: 얼굴 중복 확인 활성화 (셀피 프로세스 필수)
- 위조 방지: 스트리밍 촬영만 허용, Proxy & VPN 감지
- 제출 제한: Window Sliding 방식으로 제출 건 제한
- 중복 관리: 중복 체크 파이프라인, 중복승인/거절 방지 기간 설정
4) 게임·성인 콘텐츠 (연령·지역 제한 중심)
4) 게임·성인 콘텐츠 (연령·지역 제한 중심)
- 인증 정책: 나이 제한, 블랙리스트 국가, 자동 처리만 진행
- 위조 방지: 얼굴 기반 나이 검증, 지역별 사전심사
- 제출 제한: 강제차단 기능으로 악용 사용자 차단
- 검수자: ARGOS 전문 검수자 또는 클라이언트 API 선택
5) 채용·보험·고객 고위험 심사 (EDD)
5) 채용·보험·고객 고위험 심사 (EDD)
- 추가 정보: 라이브폼 2단계에 최대 5개 커스텀 필드 (텍스트/드롭다운/날짜/전화번호/PDF 업로드)
- 인증 정책: ARGOS Score 사용자 정의 + 클라이언트 API 검수
- 위조 방지: 다중 인증 (정부데이터 확인, 1원 계좌 인증 등)
- AML: Watch list filtering + Ongoing Monitoring
단계별 설정 가이드
1. 프로젝트 기본 정보 설정
- 프로젝트 이름: 사용자가 인식할 수 있는 정확한 서비스명 입력
- 프로젝트 로고: 대시보드에서 프로젝트 구별을 위한 로고 업로드
- 프로젝트 상태: 셋업 중엔 TEST, 실서비스 전환 시 OPEN
- 라이브폼 URL 확인: ID document / Knowledge-based 파이프라인 URL 확인
프로젝트 정보 설정
2. 보안 및 접근 제어 설정
- 접근 제어: 프라이빗 모드 + Token ID 사전 등록 + 토큰 만료 조건
- 데이터 보호: 라이브폼 암호화 설정 (ECB/GCM) + 암호화 전용 모드
- 보안 전송: API 호출 시 모든 데이터 암호화 전송
접근 제어
데이터 보호
3. KYC 프로세스 및 인증 정책 설정
- ARGOS Score 기준값: 점수 높을수록 승인 기준 엄격 (추천: 80~85 시작)
- 자동 처리만 진행: Pending 없이 100% 자동 운영
- 나이 제한: 설정한 연령 미만 사용자 자동 거절
- 블랙리스트 국가: 특정 국가 발급 신분증 제한
KYC 프로세스
4. 인증 데이터 및 중복 관리
- 중복 체크 파이프라인: 기본 방식 또는 사용자 지정 DI 선택
- 제출 건 제한: Window Sliding 방식으로 제출 빈도 제한
- 중복승인/거절 방지 기간: 이미 처리된 사용자의 재제출 방지
인증 데이터
5. 인증강화 및 위조방지 설정
- 신분증 위조 방지: MRZ 검사, PDF417 검사, ID liveness
- 얼굴 인증: 셀피 프로세스, 얼굴 중복 확인, 셀피 라이브니스
- 메타 정보 기반 감지: Proxy & VPN 감지, 지역별 사전심사
- 3rd party 데이터 소스: 1원 계좌 인증, 정부데이터 확인 등
인증강화 및 위조방지
6. AML (자금세탁방지) 설정
- AML Watch list filtering: 위험도 임계값 설정, 전체 생년월일 일치 옵션
- AML Ongoing Monitoring: 주기적 재검사로 지속적 모니터링
AML 설정
7. 연동 정보 및 웹훅 설정
- 웹훅 URL: Endpoint URL로 HTTP POST 전송
- 알림 사용자 관리: 일일 웹훅 리포트 이메일 수신 설정
- 리턴 URL: 인증 완료 후 리다이렉트 URL 설정
- 동적 필드: kycStatus, userid, email, submissionId 등 전달
- 리턴 URL 암호화: 동적 필드 암호화 전송
연동 정보
8. 고지사항 및 추가 정보 수집
- 고지사항: 이용약관 URL, 개인정보 처리 방침 URL 설정
- 추가 정보 수집: 최대 5개 커스텀 필드 (Text/Dropdown/Date/Phone/PDF/Checkbox)
고지사항 및 추가정보
9. 시스템 운영 설정
- 제출 제어 시스템: 긴급 정지 기능으로 전체 제출 중단 가능
- 개인정보 표시 여부: 대시보드에서 개인정보 블러 처리
- 관리자 설정: 관리자 추가/제거, 로그인 기록 확인
- 검수자 설정: ARGOS 전문 검수자 또는 클라이언트 API 선택
- IP 화이트리스트: 지정 IP만 대시보드 및 API 접근 허용
시스템 운영
API 연동 가이드
대시보드는 옵션 활성화를 위한 설정 도구이며, 실제 운영은 API를 통해 이루어집니다. 각 상황에 맞는 API 사용법을 확인하세요.상황별 API 사용 가이드
고객 정보 조회하기
고객 정보 조회하기
GET /submission사용 방법:- Submission ID로 조회: 특정 제출건의 상세 정보 확인
- User ID로 조회: 특정 사용자의 모든 제출건 조회
- Email로 조회: 이메일 주소로 제출건 조회
- 기간별 조회: 날짜 범위로 제출건 목록 조회
GET Submission API
기존 고객 정보 입력하기
기존 고객 정보 입력하기
POST /submission/migration사용 방법:- 기존 시스템의 사용자 데이터를 ARGOS 시스템으로 이전
- 테스트 시나리오를 위한 샘플 데이터 생성
- 특수한 상황에서 직접 데이터 제출
POST Submission API
Token ID 관리하기
Token ID 관리하기
POST /token, GET /token, DELETE /token사용 방법:- Token ID 사전 등록:
POST /token으로 최대 100,000개까지 등록 - Token ID 조회:
GET /token으로 등록된 토큰 목록 및 상태 확인 - Token ID 삭제:
DELETE /token으로 만료되거나 불필요한 토큰 삭제
POST Token
GET Token
DELETE Token
제출건 상태 업데이트하기
제출건 상태 업데이트하기
PATCH /submission, POST /client-review사용 방법:- 제출건 업데이트:
PATCH /submission으로 제출건 정보 수정 - 클라이언트 검수:
POST /client-review로 승인/거절 처리
PATCH Submission API
웹훅 활용 가이드
웹훅을 통해 KYC 프로세스의 모든 단계를 실시간으로 모니터링하고 자동화할 수 있습니다.웹훅 이벤트 종류
| 웹훅 트리거 | 발생 시점 | 활용 예시 |
|---|---|---|
created | 제출건이 생성되었을 때 | 제출 시작 알림, 진행 상황 추적 |
submit | 제출건이 보류(Pending) 상태일 때 | 수동 검수 필요 알림, 검수자에게 할당 |
approved | 제출건이 승인되었을 때 | 계정 개통, 서비스 접근 허용, 승인 알림 |
rejected | 제출건이 거절되었을 때 | 거절 사유 전달, 재시도 안내 |
updated | 제출건이 업데이트되었을 때 | 상태 변경 추적, 로그 기록 |
retry | 재시도가 발생했을 때 | 재시도 알림, 사용자 안내 |
delete | 제출건이 삭제되었을 때 | 삭제 로그 기록, 데이터 정리 |
token_expired | Token ID가 만료되었을 때 | 토큰 재발급, 접근 차단 |
injection | Injection이 진행되었을 때 | 추가 정보 수집 완료 알림 |
aml | AML 검색이 완료되었을 때 | 위험인물 감지 알림, 추가 검토 필요 |
aml_monitor | AML Ongoing Monitoring 결과가 있을 때 | 지속적 모니터링 결과 알림 |
웹훅 설정 방법
-
대시보드에서 웹훅 URL 설정
- 프로젝트 관리 > 프로젝트 설정 > 연동 정보에서 웹훅 URL 입력
- HTTPS 프로토콜 사용 필수
-
웹훅 이벤트 수신 처리
-
웹훅 보안 설정
- 서명 검증 구현 권장
- IP 화이트리스트:
52.78.194.237허용 필수
웹훅 이벤트 가이드
라이브폼 Query String 활용
라이브폼 URL에 Query String을 추가하여 사용자 정보를 미리 입력하거나 프로세스를 커스터마이징할 수 있습니다.기본 Query String 파라미터
| 파라미터 | 설명 | 예시 |
|---|---|---|
pid | 프로젝트 ID (필수) | pid=proj_abc123 |
email | 사용자 이메일 | email=user@example.com |
userid | 내부 사용자 ID | userid=user_12345 |
cf1, cf2, cf3 | 커스텀 필드 | cf1=campaign_summer&cf2=source_web |
tokenid | Token ID (프라이빗 모드 필수) | tokenid=tok_abc123 |
sid | Submission ID (Injection용) | sid=sub_abc123&action=addveri |
Query String 사용 예시
암호화된 Query String 사용
대시보드에서 암호화 전용 모드를 활성화한 경우, 모든 Query String을 암호화해야 합니다.Query String 가이드
재검증 및 애드온 활용
인증된 사용자에 대한 재검증이 필요할 때는 애드온 API를 활용할 수 있습니다.Face Auth API (얼굴 인증 재검증)
상황: 이미 인증된 사용자의 얼굴 인증을 다시 확인하고 싶을 때 사용 API:POST /faceauth, GET /faceauth, DELETE /faceauth
Face Auth API
여러 프로젝트 동시 사용
여러 프로젝트를 동시에 운영하는 경우, 각 프로젝트별로 API Key와 설정을 구분하여 사용해야 합니다.프로젝트별 API Key 관리
프로젝트별 웹훅 처리
- 각 프로젝트는 독립적인 API Key를 가집니다
- 프로젝트별로 웹훅 URL을 다르게 설정할 수 있습니다
- 대시보드에서 프로젝트별 설정을 확인하고 관리하세요
추천 기본값 (첫 운영 기준)
보안
- 프라이빗 모드 ON
- Token ID 사전 등록 ON (1회 만료)
- 암호화 전용 모드 ON
- IP 화이트리스트 등록
정책
- ARGOS Score 80~85 시작 → 지표로 조정
- 중복 체크 파이프라인 ON
- 필요 시 클라이언트 API 검수자 지정
위조 방지
- 셀피 라이브니스 ≥85
- 스트리밍 촬영만 허용
- Proxy & VPN 감지 ON
- MRZ·PDF417 검사 ON
UX
- 결과페이지가 불필요하면 Skip result page
- 암호화된 Dynamic Fields 활용
자주 겪는 상황, 이렇게 해결하세요
인증 뒤에 우리 서비스로 바로 이동하고 싶어요
인증 뒤에 우리 서비스로 바로 이동하고 싶어요
- 프로젝트 관리 > 프로젝트 설정 > 연동 정보에서 Return URL 설정
- 결과 페이지 스킵 옵션 활성화
- 필요한 파라미터는 동적 필드(암호화 가능)로 안전하게 전달
웹훅 알림이 안 와요
웹훅 알림이 안 와요
- Endpoint URL 정확도 확인
- HTTPS/서명 검증 구현 여부
- 웹훅 IP 주소
52.78.194.237방화벽 허용 확인 - 테스트 이벤트 수신 확인
얼굴 중복 확인 옵션이 안 먹혀요
얼굴 중복 확인 옵션이 안 먹혀요
- 셀피 프로세스 활성화가 선행 조건입니다
- 프로젝트 관리 > 정책 및 인증 > 인증강화 및 위조방지에서 셀피 프로세스 먼저 활성화
- 셀피 임계값도 적절히 조정하세요
기존 대시보드에서 사용하던 기능을 찾을 수 없어요
기존 대시보드에서 사용하던 기능을 찾을 수 없어요
- 신규 대시보드와 구 대시보드 비교 페이지에서 옵션 위치 변경 사항을 확인하세요
- 대부분의 기능은 프로젝트 관리 섹션 하위로 이동했습니다
- 대시보드 상단의 검색 기능을 활용하세요