리전 안내
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 접근 허용
시스템 운영
10. 라이브폼 커스터마이징 (선택사항)
- 결과 페이지 커스터마이징
- 언어별 설정
- 이미지 및 텍스트 커스터마이징
라이브폼 커스터마이징
API 연동 가이드
대시보드는 옵션 활성화를 위한 설정 도구이며, 실제 운영은 API를 통해 이루어집니다. 각 상황에 맞는 API 사용법을 확인하세요.상황별 API 사용 가이드
고객 정보 조회하기
고객 정보 조회하기
GET /submission사용 방법:- Submission ID로 조회: 특정 제출건의 상세 정보 확인
- User ID로 조회: 특정 사용자의 모든 제출건 조회
- Email로 조회: 이메일 주소로 제출건 조회
- 기간별 조회: 날짜 범위로 제출건 목록 조회
kr.rest-api.argosidentity.com으로 바꿔 호출합니다. 자세한 내용은 리전 안내를 참고하세요.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 프로세스의 모든 단계를 실시간으로 모니터링하고 자동화할 수 있습니다.웹훅 이벤트 종류
웹훅 설정 방법
-
대시보드에서 웹훅 URL 설정
- 프로젝트 관리 > 프로젝트 설정 > 연동 정보에서 웹훅 URL 입력
- HTTPS 프로토콜 사용 필수
-
웹훅 이벤트 수신 처리
-
웹훅 보안 설정
- 서명 검증 구현 권장
- IP 화이트리스트: 프로젝트가 속한 리전의 발신 IP 허용 필수 —
52.78.194.237(US 리전),43.202.228.115(KR 리전). 두 리전을 모두 사용한다면 둘 다 허용
웹훅 이벤트 가이드
라이브폼 Query String 활용
라이브폼 URL에 Query String을 추가하여 사용자 정보를 미리 입력하거나 프로세스를 커스터마이징할 수 있습니다.기본 Query String 파라미터
Query String 사용 예시
암호화된 Query String 사용
대시보드에서 암호화 전용 모드를 활성화한 경우, 모든 Query String을 암호화해야 합니다.Query String 가이드
재검증 및 애드온 활용
인증된 사용자에 대한 재검증이 필요할 때는 애드온 API를 활용할 수 있습니다.Face Auth API (얼굴 인증 재검증)
상황: 이미 인증된 사용자의 얼굴 인증을 다시 확인하고 싶을 때 사용 API:POST /v3/face-auth, GET /v3/face-auth, DELETE /v3/face-auth/{authId}
Face Auth API
여러 프로젝트 동시 사용
여러 프로젝트를 동시에 운영하는 경우, 각 프로젝트별로 API Key와 설정을 구분하여 사용해야 합니다. 프로젝트가 서로 다른 리전에 있다면 API 호스트도 프로젝트별로 구분해야 합니다.프로젝트별 API Key 관리
프로젝트별 웹훅 처리
- 각 프로젝트는 독립적인 API Key를 가집니다
- 프로젝트별로 웹훅 URL을 다르게 설정할 수 있습니다
- 대시보드에서 프로젝트별 설정을 확인하고 관리하세요
추천 기본값 (첫 운영 기준)
보안
정책
위조 방지
UX
자주 겪는 상황, 이렇게 해결하세요
인증 뒤에 우리 서비스로 바로 이동하고 싶어요
인증 뒤에 우리 서비스로 바로 이동하고 싶어요
- 프로젝트 관리 > 프로젝트 설정 > 연동 정보에서 Return URL 설정
- 결과 페이지 스킵 옵션 활성화
- 필요한 파라미터는 동적 필드(암호화 가능)로 안전하게 전달
웹훅 알림이 안 와요
웹훅 알림이 안 와요
- Endpoint URL 정확도 확인
- HTTPS/서명 검증 구현 여부
- 프로젝트가 속한 리전의 웹훅 IP 주소 방화벽 허용 확인:
52.78.194.237(US 리전),43.202.228.115(KR 리전). 두 리전을 모두 사용한다면 둘 다 허용 - 테스트 이벤트 수신 확인
얼굴 중복 확인 옵션이 안 먹혀요
얼굴 중복 확인 옵션이 안 먹혀요
- 셀피 프로세스 활성화가 선행 조건입니다
- 프로젝트 관리 > 정책 및 인증 > 인증강화 및 위조방지에서 셀피 프로세스 먼저 활성화
- 셀피 임계값도 적절히 조정하세요
기존 대시보드에서 사용하던 기능을 찾을 수 없어요
기존 대시보드에서 사용하던 기능을 찾을 수 없어요
- 대부분의 기능은 프로젝트 관리 섹션 하위로 이동했습니다
- 대시보드 상단의 검색 기능을 활용하세요