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

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

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

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

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

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

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

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

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

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

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

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

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

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


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