> ## 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.

# React Native: быстрый старт с аутентификацией

> Настройте аутентификацию в React Native с Didit: hosted-логин, проверка callback, безопасные сессии и ссылки на верификацию и мониторинг.

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

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

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

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

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

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

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

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

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

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

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


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