얼굴 사진 한 장만으로 사용자를 고유한 인간으로 만들 수 있습니다. 간단하고, 직관적이며, 안전합니다.
한 명의 인간. 하나의 토큰. 언제나. Human Token은 정부 발급 문서 없이 단 한 장의 셀피로 각 얼굴에 대한 고유한 신원을 생성합니다. 이러한 연계가 존재하지 않는 경우뿐만 아니라 고객이 문서 번호 공유를 원하지 않는 경우에도 유용합니다. 필요할 때마다 새로운 인증을 요청하고 토큰을 비교하세요. 토큰이 같으면 같은 인간입니다.
이를 통해 다음을 수행할 수 있습니다:
- 반복 사용자 감지 및 중복 계정 방지: 하나의 얼굴, 하나의 토큰. 공식 문서 없이 가입, 로그인, 계정 복구 시점에 중복 또는 가짜 계정을 식별합니다.
- 웹, 네이티브 또는 API를 통한 통합: 추가 문서 데이터 없이 셀피 이미지만을 입력값으로 사용합니다.
- 다른 신호와 결합: 필요에 따라 Human Token을 다른 capabilities와 함께 추가합니다.
가장 일반적인 시나리오로는 딥페이크 공격(CAPTCHA나 SMS 없이 모든 작업 뒤에 실제로 존재하는 사람이 있는지 확인), 다중 계정, 프로모션 및 추천 남용, 비밀번호 복구, 새 기기 인증, 연체 감소가 있습니다. 손실이 발생한 후가 아니라 결정을 내리기 전에 위험을 확인하세요.
기능 설명
캡처된 셀피에서 Human Token은 해당 얼굴을 고유하게 나타내는 안정적이고 불투명한 생체 식별자(humanToken)를 생성합니다. 사용자는 어떠한 식별자도 선언하지 않습니다 — 신원은 입력값이 아닌 호출의 출력값입니다. 모든 성공적인 일치에서 응답은 동일한 humanToken을 반환하므로, 동일한 사용자를 어떤 기기나 세션에서든 이후 프로세스에서도 인식할 수 있습니다.
Privacy by Design: 사전 데이터가 필요하지 않으며 얼굴 사진은 처리 후 폐기할 수 있습니다. 시스템에 남는 것은 얼굴이 아니라 토큰이므로, 귀사와 고객의 생체 정보 노출을 크게 줄일 수 있습니다.
입력값
유일한 입력값은 셀피입니다. API Only 플로우에서는 백엔드가 프로세스 생성 요청 본문에 imageBase64로 셀피를 전송합니다. Human Token Journey flow (humantoken 또는 humantoken+revalidation)에서는 셀피가 여정에서 캡처됩니다.
가능한 응답
결과는 data.humanToken으로 반환됩니다. value는 식별자이고, state는 프로세스의 진행 상태를 나타냅니다 — 결과가 준비되면 PROCESS_STATE_FINISHED입니다. 프로세스 생성 › 결과 해석을 참조하세요.
humanToken을 생성할 수 없는 경우Human Token이 humanToken을 생성하지 않는 시나리오는 단 하나입니다. 제출된 이미지에서 얼굴을 식별할 수 없는 경우 — 얼굴이 감지되지 않거나, 이미지 품질이 너무 낮거나, 얼굴이 캡처 표준을 벗어난 경우(기울어짐, 옆으로 돌아감)입니다. 캡처 표준을 따르는 것 이 이를 방지하는 방법입니다.
humanToken은 안정적인 불투명 식별자입니다 — 동일한 사용자는 항상 동일한 값으로 확인됩니다. 이후 Human Token 호출에서 동일한 사람을 인식하기 위해 사용자 레코드와 함께 저장하세요.
API 통합
Human Token은 Human API에서 실행됩니다. 백엔드가 프로세스 생성으로 프로세스를 생성합니다. API Only 플로우(api+humantoken, api+liveness+humantoken 또는 api+liveness+humantoken+revalidation)에서는 동일한 응답에서 humanToken이 반환되고, Human Token Journey flow (humantoken 또는 humantoken+revalidation)에서는 사용자가 여정을 진행한 후 백엔드가 프로세스 조회로 결과를 조회합니다.
시작하려면:
- 인증을 설정합니다 — 모든 호출은
x-unico-accesskey헤더에 액세스 키를 전송합니다. - 프로세스 생성으로 프로세스를 생성하고
data.humanToken을 읽습니다. - 필요한 경우 프로세스 조회로 프로세스를 다시 조회합니다.
사용 가능 여부
| 필요한 통합 구성 요소 |
|---|
| API Web |