Human Token

Markdown

Всего по одной фотографии лица вы превращаете своего пользователя в уникального человека. Просто, интуитивно и безопасно.

Один человек. Один токен. Всегда. Human Token создаёт уникальную идентичность для каждого лица на основе единственного селфи, не требуя документа, выданного государством. Это полезно как там, где такой связи нет, так и там, где ваши клиенты предпочитают не передавать номера документов. При необходимости запросите новую проверку и сравните токены: одинаковые токены означают одного и того же человека.

Это позволяет вам:

• Выявлять повторяющихся пользователей и предотвращать создание дублирующих аккаунтов: одно лицо — один токен. Выявляйте дублирующие или поддельные аккаунты при регистрации, входе и восстановлении доступа без официальных документов.
• Интегрироваться через Web, Native или API: используя только селфи в качестве входных данных, без каких-либо дополнительных данных документа.
• Комбинировать с другими сигналами: добавляйте Human Token вместе с другими capabilities по мере необходимости.

Среди самых распространённых сценариев — атаки с использованием дипфейков (подтверждение того, что за каждым действием стоит реальный и присутствующий человек, без CAPTCHA и без SMS), множественные аккаунты, злоупотребление акциями и реферальными программами, восстановление пароля, аутентификация нового устройства и снижение просроченной задолженности. Оценивайте риск до принятия решения, а не после потери.

Что это делает

На основе захваченного селфи Human Token генерирует стабильный непрозрачный биометрический идентификатор (humanToken), который однозначно представляет это лицо. Пользователь не объявляет никакого идентификатора — личность является результатом вызова, а не входными данными. При каждом успешном совпадении ответ возвращает тот же humanToken, что позволяет распознавать одного и того же пользователя в будущих процессах на любом устройстве и в любой сессии.

Privacy by Design: никаких предварительных данных не требуется, а фотографию лица можно удалить после обработки: в вашей системе остаётся токен, а не лицо, — что существенно снижает биометрические риски для вашей компании и ваших клиентов.

Входные данные

Единственные входные данные — селфи. В потоках API Only ваш бэкенд отправляет его в виде imageBase64 в теле запроса Создать процесс. В потоке Human Token Journey flow (humantoken или humantoken+revalidation) селфи захватывается в сценарии.

SDK обязателен для качественного захвата

Чтобы убедиться, что изображение, отправляемое через API, соответствует биометрическим требованиям, используйте Unico SDK для вашей платформы или следуйте стандарту захвата. Human Token не принимает произвольные изображения без контроля качества захвата.

Возможные ответы

Результат возвращается в 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) пользователь проходит сценарий, а ваш бэкенд получает результат через Получение процесса.

Чтобы начать:

1. Настройте Аутентификацию — каждый вызов передаёт ваш ключ доступа в заголовке x-unico-accesskey.
2. Создайте процесс через Создать процесс и прочитайте data.humanToken.
3. При необходимости повторно получите процесс через Получение процесса.

Доступность

Необходимые компоненты интеграции
API Web