Перейти к основному содержанию
Продукт Authentication новый: didit_auth зависит от выпуска. Координаты распространения, версии и сигнатуры вызовов здесь не подтверждены. Не устанавливайте непроверенный пакет и не используйте SDK верификации личности как SDK Authentication.

​
Подготовка приложения

  1. Убедитесь, что Authentication включён для вашего приложения Didit, и скопируйте из консоли его origin для входа (https://<slug>.auth.didit.me или <slug>.sandbox.auth.didit.me для песочницы).
  2. Зарегистрируйте точный callback URL, который поддерживают ваше приложение и среда выполнения. Проверьте владение ссылкой приложения; не полагайтесь на то, что произвольные пользовательские URL-схемы будут приняты.
  3. Разделяйте конфигурацию песочницы и продакшн-среды, включая обработку callback и сохранённые учётные данные.
  4. Выберите стабильную привязку пользователя к человеку до подключения верификации или мониторинга.
Настраивайте и тестируйте callback-ссылки отдельно для iOS и Android. Обёртка Authentication отделена от didit_sdk, который отвечает за верификацию.

​
Реализация размещённого потока

Откройте системный браузер аутентификации по URL {origin}/sign-in. Передайте свежий случайный state, PKCE-челлендж по методу S256 и зарегистрированный redirect_uri. Храните верификатор только в вашем приложении и только для этой попытки. Быстрый старт для JavaScript описывает лежащий в основе протокол; в нативном коде используйте платформенную криптографию и обработку URL, а не глобальные объекты браузера. При callback проверьте state, время жизни транзакции и адрес назначения callback, и только после этого обменяйте одноразовый код через endpoint token/. Используйте исходный верификатор и точный redirect URI. Отмена или закрытие браузера не означает успешный вход. Храните refresh-токены в защищённом платформой хранилище приложения; никогда не сохраняйте их в обычном файле настроек, в аналитике или в логах сбоев. Проверяйте текущую сессию запросом GET session/ с Bearer-токеном конечного пользователя. Обновление токенов выполняйте последовательно, заменяйте оба токена одновременно и очищайте данные, связанные с пользователем, после выхода. Формат запроса и поведение при повторном использовании refresh-токена описаны в разделе токены и JWKS.

​
Предварительная версия нативного SDK

Нативные модули Authentication планируется выпустить с функциями входа, доступа к текущей сессии, получения токенов, выхода и аутентификации с повышенным уровнем защиты, с автоматической передачей сигналов устройства. Нативные ключи доступа и защищённое хранилище токенов входят в этот выпуск. API обёртки будут соответствовать опубликованным контрактам для платформ; не копируйте предполагаемые аргументы конструкторов или сигнатуры методов из примеров проектирования. До выпуска модуля отключите его адаптер или используйте проверенную реализацию размещённого протокола для приложения, в котором Authentication включена. Не заявляйте о наличии рабочего нативного быстрого старта для Authentication только на основании установки пакета.

​
Подключение верификации и мониторинга

Ваш бэкенд формирует vendor_data на основе данных аутентифицированного пользователя. Он создаёт сессии верификации или выпускает токены мониторинга с ограниченной областью для этого пользователя. В приложение возвращайте только учётные данные сессии или токен с ограниченной областью; API-ключ остаётся на сервере. Используйте Flutter SDK для верификации, когда нужна верификация личности. Для поддержки мониторинга на вашей платформе следуйте разделу отправка транзакций в SDK. Решения по входу, верификации и транзакциям принимайте отдельно друг от друга.

​
Проверка интеграции

Проверьте возврат в приложение, которое было полностью закрыто, переходы в фоновый режим и обратно, отмену в браузере, callback с несовпадающими данными, повторное использование кода, истечение срока токена, параллельное обновление, MFA, выход и вход под другим пользователем. Проверяйте регистрацию и вход с ключами доступа на поддерживаемых устройствах, когда выйдет этот выпуск. Проверка, выполняемая только на устройстве, остаётся непроверенной, пока не выполнена на целевой платформе.
Последнее изменение 7 ноября 2026 г.