> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# Нативная аутентификация

Обрабатывайте обратный путь из браузера и хранимые сессии на mobile.

## Настройка и конфигурация

Перед любым действием прочтите [Перед началом работы](https://supastack.dev/ru/docs/web/before-you-start.md) и [Основные сведения о терминале](https://supastack.dev/ru/docs/web/terminal-basics.md). В этих инструкциях предполагается, что вы открыли полный монорепозиторий supastack в VS Code; его корень package.json отмечает корень репозитория. В командах pnpm пакет рабочей области представляет собой папку приложения или общего кода; В продукте рабочее пространство — это контейнер данных и граница безопасности команды. corepack pnpm --filter ... выбирает один пакет из монорепозитория, пока команды выполняются из его корня. Если вы открыли только синхронизированную папку мобильного устройства или рабочего стола, она не содержит веб-серверной части, настройки Docker или корневых сценариев: запустите серверную часть из этого монорепозитория или доступного размещенного сервера и используйте собственные сценарии папки платформы. Переменная среды — это именованный параметр, хранящийся в локальном файле .env или на панели управления хостингом; перезапустите соответствующее приложение после его изменения и не допускайте попадания секретов сервера в значения NEXT_PUBLIC_ и EXPO_PUBLIC_.

1. Откройте apps/mobile/src/auth/client.ts и apps/mobile/src/auth/mobile-auth-configuration.ts в VS Code, чтобы найти существующий процесс входа.

2. Поместите EXPO_PUBLIC_API_URL и EXPO_PUBLIC_APP_SCHEME в apps/mobile/.env.local и убедитесь, что веб-сервер имеет свои собственные настройки в apps/web/.env.local..

3. Из рута запустите Web с corepack pnpm --filter @supastack/web dev, затем в другом терминале запустите Expo с corepack pnpm --filter @supastack/mobile start. Ожидается: при тестовом входе браузер открывается и возвращается в мобильное приложение. На физическом телефоне используйте доступный адрес Wi-Fi/LAN компьютера для API; телефон-localhost означает сам телефон.

Мобильное приложение использует интеграцию Better Auth Expo и нативное защищённое хранилище. Origin API и схема приложения должны согласовываться с нативной конфигурацией и разрешённым обратным потоком сервера аутентификации.

```
EXPO_PUBLIC_API_URL=https://your-api.example
EXPO_PUBLIC_APP_SCHEME=supastack
```


## Команды для копирования

Следуйте комментариям, чтобы узнать, в какой папке запускается команда. Если помечены два терминала, откройте два окна терминала и продолжайте выполнять первую команду, пока используете вторую.

```
# Terminal 1 — Web API (from the monorepo root):
corepack pnpm --filter @supastack/web dev

# Terminal 2 — Expo app (from the monorepo root):
corepack pnpm --filter @supastack/mobile start
```


## Рабочий процесс внедрения

Следуйте существующему нативному клиенту аутентификации вместо переноса предположений о веб-cookie на mobile. Открывайте аутентификацию провайдера через настроенный браузерный поток, обрабатывайте его колбэк, затем разрешайте аутентифицированную сессию до показа защищённых действий.

Четко различайте отмененный и успешный вход. Участники могут включить биометрическую блокировку приложения (Face ID, Touch ID или отпечаток пальца в `apps/mobile/src/security/app-lock.ts` в разделе Настройки → Безопасность) для защиты при возврате приложения на передний план. При выходе очищайте локальное состояние предыдущего пользователя и привязанный к рабочему пространству офлайн-кэш чтения (`apps/mobile/src/offline/`), а также проверяйте, что серверная сессия больше не может выполнять защищенные действия.


## Проверка и устранение неполадок

Если вход открывает браузер, но не возвращает приложение, убедитесь, что EXPO_PUBLIC_APP_SCHEME соответствует схеме в apps/mobile/app.config.ts.. Если приложение не может связаться с сервером, замените localhost на адрес LAN компьютера, подтвердите, что оба устройства используют одну и ту же сеть, а затем перезапустите Expo после редактирования apps/mobile/.env.local. Expo Go — это пользовательский интерфейс. предварительный просмотр; Для принятия встроенной покупки требуется сборка для разработки EAS.

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


Чтобы продолжить настройку, прочитайте [Мобильные права доступа](https://supastack.dev/ru/docs/mobile/entitlements.md).


## Вперёд

[Мобильный API](https://supastack.dev/ru/docs/mobile/api.md)