Перейти к основному содержанию
Аутентификация является новой функцией: @didit-protocol/auth-react-native зависит от релиза. Координаты пакета, версии и сигнатуры вызываемых функций здесь не подтверждены. Не устанавливайте предполагаемый пакет и не используйте SDK верификации личности как SDK аутентификации.

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

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

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

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

​
Предварительный просмотр нативного SDK

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

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

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

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

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