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

# 原生认证

处理移动端的浏览器回跳与已存会话。

## 安装与配置

在执行任何步骤之前，请阅读[开始之前](https://supastack.dev/zh/docs/web/before-you-start.md) 和[终端基础知识](https://supastack.dev/zh/docs/web/terminal-basics.md)。这些说明假设您在 VS Code 中打开了完整的 supastack monorepo；它的根 package.json 标记存储库根。在 pnpm 命令中，工作区包是应用程序或共享代码文件夹；在产品中，工作空间是团队的数据容器和安全边界。 corepack pnpm --filter ... 从 monorepo 选择一个包，同时从其根运行命令。如果您仅打开同步的移动或桌面文件夹，则它不包含 Web 后端、Docker 设置或根脚本：从此 monorepo 或可访问的托管服务器运行后端，并使用平台文件夹自己的脚本。环境变量是存储在本地 .env 文件或托管仪表板中的命名设置；更改后重新启动相关应用程序，并将服务器机密保留在 NEXT_PUBLIC_ 和 EXPO_PUBLIC_ 值之外。

1、在VS Code中打开apps/mobile/src/auth/client.ts和apps/mobile/src/auth/mobile-auth-configuration.ts，找到已有的登录流程。

2.将EXPO_PUBLIC_API_URL和EXPO_PUBLIC_APP_SCHEME放入apps/mobile/.env.local，并确保Web服务器在apps/web/.env.local.中有自己的设置

3. 从 root 启动 Web，使用 corepack pnpm --filter @supastack/web dev，然后在另一个终端中使用 corepack pnpm --filter @supastack/mobile start 启动 Expo。预期：测试登录将打开浏览器并返回到移动应用程序。在实体手机上，使用计算机可连接的 Wi-Fi/LAN 地址作为 API；电话-localhost 表示电话本身。

移动应用使用 Better Auth 的 Expo 集成与原生安全存储。API origin 与应用 scheme 必须与原生配置以及认证服务器允许的返回流程一致。

```
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
```


## 实现流程

沿用现有的原生认证客户端，不要把 Web Cookie 的假设搬到移动端。通过配置的浏览器流程打开供应商认证，处理回调，然后先解析已认证会话，再呈现受保护动作。

请将取消登录与成功登录区分开来。成员可以在“设置 → 安全”中启用生物识别应用锁（`apps/mobile/src/security/app-lock.ts` 中的 Face ID、Touch ID 或指纹），在应用回到前台时要求验证。退出登录时请清除上一位用户的本地界面状态以及按工作区隔离的离线读取缓存（`apps/mobile/src/offline/`），并确认服务端会话无法再执行受保护的操作。


## 验证与排障

如果登录打开浏览器但没有返回到应用程序，请检查 EXPO_PUBLIC_APP_SCHEME 是否与 apps/mobile/app.config.ts. 中的方案匹配。如果应用程序无法到达服务器，请将 localhost 替换为计算机的 LAN 地址，确认两台设备使用相同的网络，然后编辑 apps/mobile/.env.local. 后重新启动 Expo Expo Go 是 UI 预览；本机购买接受需要 EAS 开发版本。

在目标构建上演练冷启动回调、返回运行中的应用、取消登录与过期会话。如果浏览器返回了但应用仍未登录，先检查 scheme 匹配与 API 可达性，再改供应商配置。


如果你想继续完成设置，可以阅读《[移动端权益](https://supastack.dev/zh/docs/mobile/entitlements.md)》。


## 下一篇

[移动端 API](https://supastack.dev/zh/docs/mobile/api.md)