> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Аутентификация Android: быстрый старт

> Быстрый старт аутентификации Didit на Android: размещённый вход, проверка callback-URL, безопасные сессии и ссылки на верификацию и мониторинг.

> [!WARNING]
>
> Функция 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](https://docs.didit.me/ru/authentication/quickstarts/javascript.md) описывает лежащий в основе протокол; в нативном коде используйте платформенную криптографию и обработку URL, а не глобальные объекты браузера.

При обратном вызове проверьте state, время жизни транзакции и адрес назначения обратного вызова, и только после этого обменяйте одноразовый код через `token/`. Используйте исходный verifier и точный redirect URI. Отмена или закрытие браузера не является успешным входом.

Храните refresh-токены в зашифрованном хранилище, защищённом платформой. Никогда не сохраняйте их в незашифрованном файле настроек, в аналитике или в логах сбоев. Проверяйте текущую сессию через `GET session/` с Bearer-токеном конечного пользователя. Сериализуйте операции обновления и заменяйте оба токена одновременно. После выхода из системы очищайте состояние, относящееся к пользователю. Формат запроса и поведение при повторном использовании refresh-токена описаны в разделе [токены и JWKS](https://docs.didit.me/ru/authentication/tokens-and-jwks.md).

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

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

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

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

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

Используйте [SDK верификации личности для Android](https://docs.didit.me/ru/integration/native-sdks/android-sdk.md), когда нужна верификация личности. Для поддержки мониторинга на вашей платформе следуйте инструкции [отправка транзакций в SDK](https://docs.didit.me/ru/transaction-monitoring/sdk-transaction-submission.md). Решения о входе, верификации и транзакциях принимайте отдельно друг от друга.

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

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.