For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /ru/docs/mobile/authentication.md (or send Accept: text/markdown).
Нативная аутентификация
Обрабатывайте обратный путь из браузера и хранимые сессии на mobile.
Настройка и конфигурация
Перед любым действием прочтите Перед началом работы и Основные сведения о терминале. В этих инструкциях предполагается, что вы открыли полный монорепозиторий 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 до изменения конфигурации провайдера.
Чтобы продолжить настройку, прочитайте Мобильные права доступа.