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 /es/docs/mobile/authentication.md (or send Accept: text/markdown).
Autenticación nativa
Gestiona en móvil la ruta de retorno del navegador y las sesiones guardadas.
Configuración y ajustes
Antes de cualquier paso, lea Antes de comenzar y Conceptos básicos del terminal. Estas instrucciones suponen que abrió el monorepo supastack completo en VS Code; su paquete raíz.json marca la raíz del repositorio. En los comandos pnpm, un paquete de espacio de trabajo es una aplicación o una carpeta de código compartido; En el producto, un espacio de trabajo es el contenedor de datos y el límite de seguridad de un equipo. corepack pnpm --filter ... selecciona un paquete del monorepo mientras los comandos se ejecutan desde su raíz. Si abrió solo una carpeta sincronizada para dispositivos móviles o de escritorio, no contiene el backend web, la configuración de Docker ni los scripts raíz: ejecute el backend desde este monorepo o un servidor alojado accesible y use los propios scripts de la carpeta de la plataforma. Una variable de entorno es una configuración con nombre almacenada en un archivo .env local o en su panel de hosting; reinicie la aplicación correspondiente después de cambiarla y mantenga los secretos del servidor fuera de los valores NEXT_PUBLIC_ y EXPO_PUBLIC_.
1. Abra apps/mobile/src/auth/client.ts y apps/mobile/src/auth/mobile-auth-configuration.ts en VS Code para encontrar el flujo de inicio de sesión existente.
2. Coloque EXPO_PUBLIC_API_URL y EXPO_PUBLIC_APP_SCHEME en apps/mobile/.env.local y asegúrese de que el servidor web tenga su propia configuración en apps/web/.env.local..
3. Desde la raíz, inicie Web con corepack pnpm --filter @supastack/web dev, luego en otra terminal inicie Expo con corepack pnpm --filter @supastack/mobile start. Previsto: un inicio de sesión de prueba abre el navegador y regresa a la aplicación móvil. En un teléfono físico, utilice la dirección Wi-Fi/LAN accesible de la computadora para el API; phone-localhost significa el teléfono en sí.
La aplicación móvil usa la integración Better Auth Expo y almacenamiento seguro nativo. El origen de la API y el esquema de la aplicación deben coincidir con la configuración nativa y el flujo de retorno permitido por el servidor de autenticación.
EXPO_PUBLIC_API_URL=https://your-api.example
EXPO_PUBLIC_APP_SCHEME=supastackComandos para copiar
Siga los comentarios para ver en qué carpeta se ejecuta un comando. Si dos terminales están etiquetados, abra dos ventanas de terminal y mantenga el primer comando ejecutándose mientras usa el segundo.
# 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 startFlujo de implementación
Sigue el cliente de autenticación nativo existente en vez de copiar a móvil las suposiciones de cookies web. Abre la autenticación del proveedor mediante el flujo de navegador configurado, gestiona su callback y luego resuelve la sesión autenticada antes de mostrar acciones protegidas.
Mantenga el inicio de sesión cancelado separado del inicio de sesión exitoso. Los miembros pueden activar el bloqueo biométrico de la aplicación (Face ID, Touch ID o huella digital en apps/mobile/src/security/app-lock.ts dentro de Ajustes → Seguridad) para proteger la reanudación en primer plano. Borre la presentación local del usuario anterior y la caché de lectura sin conexión vinculada al espacio de trabajo (apps/mobile/src/offline/) al cerrar sesión, y verifique que la sesión del servidor ya no pueda realizar trabajo protegido.
Verificación y solución de problemas
Si el inicio de sesión abre un navegador pero no regresa a la aplicación, verifique que EXPO_PUBLIC_APP_SCHEME coincida con el esquema en apps/mobile/app.config.ts.. Si la aplicación no puede llegar al servidor, reemplace localhost con la dirección LAN de la computadora, confirme que ambos dispositivos usan la misma red y luego reinicie Expo después de editar apps/mobile/.env.local.. Expo Go es una vista previa de la interfaz de usuario; La aceptación de compra nativa necesita una compilación de desarrollo EAS.
Prueba callbacks desde el arranque en frío, el retorno a una aplicación en ejecución, la cancelación del inicio de sesión y las sesiones caducadas en la compilación prevista. Si el navegador vuelve pero la aplicación sigue sin iniciar sesión, inspecciona la coincidencia del esquema y el acceso a la API antes de cambiar la configuración del proveedor.
Si quieres continuar la configuración, lee Derechos móviles.