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

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

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

​
Реализация hosted-потока

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

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

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

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

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

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

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