시작하기
연동 / SDK
사용자 인증
기업 확인
거래 모니터링
변경 내역사용자에게 지원되는 식별자 유형
각 식별자 유형은 자연스러운 접점에서 적용됩니다.
- 얼굴과 문서: 새 세션 중에 적용됩니다.
- 이메일과 전화번호: 이를 수집하는 세션 단계 중이나 거래 페이로드에서 적용됩니다.
- IP와 기기: 세션 중 기기 및 IP 분석 단계에서 적용됩니다.
- 사용자 vendor_data: 세션 또는 거래 생성 시 적용됩니다.
차단 목록에 추가되는 방식
거부된 세션은 어떤 사용자도 차단 목록에 추가하지 않습니다. 세션은
Declined 상태로 끝나고, 사용자는 ACTIVE 상태를 유지하며, 목록 항목도 기록되지 않으므로 같은 사람이 다른 세션을 시작할 수 있습니다. 차단 목록 추가는 수동 작업입니다. Blocklist page에서 항목을 추가하거나 Lists API를 사용하세요. USER 항목(사용자의 vendor_data)을 추가하면 사용자 상태도 BLOCKED로 바뀝니다.1
자동: 차단 목록 일치 시
들어온 세션이 기존 차단 목록 항목과 일치하면, 세션은
blocked_face, blocked_document, blocked_email 등과 같은 사유 코드와 함께 자동으로 거부됩니다.2
수동: 콘솔에서
분석가는 Users → [user] → Actions → Add to blocklist에서 사용자를 차단하고, 차단 목록에 포함할 식별자를 하나 이상 선택합니다.
3
프로그래밍 방식: Lists API 사용
Lists API를 사용해 프로그래밍 방식으로 항목을 추가하세요. 이는 콘솔이 내부적으로 사용하는 것과 같은 API입니다.
시스템 목록과 사용자 지정 목록
모든 애플리케이션에는 식별자 유형마다 하나씩 있는 시스템 차단 목록이 있으며, Didit이 자동으로 관리합니다. 이름을 바꾸거나 삭제할 수 없습니다. 사용자 지정 목록은 직접 만들고, 이름을 붙이고, 범위를 정할 수 있습니다.Lists API로 사용자를 차단 목록에 추가하기
Lists API를 사용해 차단 목록 항목을 추가하세요.vendor_data로 사용자를 차단하려면 해당 차단 목록에 USER 유형 항목을 추가합니다.
entry_type=user와is_system=true로 필터링해 모든 목록 조회를 실행하여 시스템 사용자 차단 목록을 찾습니다.- 해당 목록에
value를 사용자의vendor_data로 설정해 항목 생성을 실행합니다.
value에 적절한 식별자를 입력합니다.
적용 흐름
얼굴과 문서 차단 목록의 경우, 검사는 인증 단계에서 이루어집니다.차단 목록에서 제거하기
- 콘솔: Blocklist → [type] → row actions → Remove.
- API: 목록 UUID와 항목 UUID를 사용하여 항목 삭제 엔드포인트를 호출합니다.
ACTIVE로 돌아가지는 않습니다. 새 세션을 허용하려면 PATCH /v3/users/{vendor_data}/update-status/를 사용해 상태를 변경하세요.
차단 목록 감사 추적
차단 목록에 대한 모든 추가 및 제거는 감사 로그에 기록됩니다.- 항목을 추가한 주체(사용자 이메일 또는
'system','api'). - 추가하거나 제거한 시각.
- 사유를 설명하는 선택적
comment. - 항목이 자동으로 생성된 경우 연결된 세션 또는 거래.
다음 단계
Lists API
차단 목록 및 허용 목록 API 전체 참조.
콘솔 차단 목록
UI에서 차단 목록을 관리합니다.
Faces & biometrics
얼굴 차단 목록의 작동 방식.