Руководство по интеграции

Как работает VIS?

От создания сессии до получения результата — полный и понятный обзор процесса идентификации.

Архитектура системы

Обзор архитектуры

Мобильный SDK только управляет процессом. Секретные данные доступа к API остаются на вашем сервере, а VIS безопасно обрабатывает медиа и результаты webhook.

Правило безопасности: секрет клиента OAuth никогда не хранится в мобильном приложении.

  1. Ваше мобильное приложение

    Запускает SDK

  2. Ваш бэкенд

    Отправляет запросы в REST API

  3. Платформа VIS

    Проверяет и возвращает результат

Шаг за шагом

Полный процесс проверки

У каждого этапа своя роль: секреты остаются на сервере, SDK ведёт пользователя, а VIS возвращает результат.

  1. 01

    Бэкенд создаёт сессию

    Ваш сервер получает токен OAuth по client_id и секрету клиента и вызывает с ним POST /api/sdk/v1/session/start. В ответе приходят attempt_id и одноразовый bootstrap-секрет.

    Никогда не храните данные доступа к API в мобильном приложении.

  2. 02

    Передайте секрет в мобильный SDK

    Бэкенд передаёт attempt_id и bootstrap-секрет в приложение. SDK привязывает сессию к устройству и подписывает дальнейшие запросы DPoP.

    Bootstrap-секрет действует не более 5 минут и используется один раз.

  3. 03

    SDK снимает медиа

    SDK открывает камеру, ведёт пользователя и безопасно загружает медиа через POST /api/sdk/v1/session/{attempt_id}/upload.

    JPEG и MP4, до 20 МБ на файл.

  4. 04

    ИИ выполняет проверки

    Загруженные медиа сначала проверяются в карантине, затем VIS выполняет проверку живости, документа и сравнение лиц.

    Вычисления выполняются в защищённой серверной среде.

  5. 05

    Получите результат запросом или webhook

    SDK видит краткий статус через GET /api/sdk/v1/session/{attempt_id}/status. Итоговый результат ваш бэкенд получает через партнёрский API или webhook.

    Webhook подписываются Ed25519 по RFC 9421.

Интерпретация результата

Как читать результаты проверки

Каждый статус обозначен цветом, иконкой и понятным текстом — решение не зависит только от цвета.

  • Подтверждено

    Проверка живости пройдена, подделка не обнаружена.

  • Отклонено

    Проверка живости не пройдена или высок риск мошенничества.

  • Ручная проверка

    Данных недостаточно для автоматического решения. Проверьте результат вручную.

  • Ошибка

    Произошла ошибка обработки. Повторите сессию.