Clase 02 · Módulo 08
Registro e ingreso con correo
Registro e ingreso con correo
Qué logras en esta clase
Eliges el método de ingreso por correo que le conviene a tu app y dejas funcionando el ciclo completo: registrarse, confirmar, ingresar y recuperar el acceso.
- Comparas contraseña, código y enlace.
- Haces que el correo abra tu app y no una página web.
- Preparas el envío de correos para usuarios reales.
02
Por qué partir por el correo
- Funciona igual en iPhone y Android, sin depender de Apple ni de Google.
- No exige cuentas de desarrollador ni configuración externa para empezar.
- Una app que solo usa cuentas propias queda fuera de la regla 4.8 de Apple (clase 3).
Lo malo: escribir un correo y una contraseña en un teléfono es lento, y dependes de que el correo llegue.
03
Tres métodos con el mismo correo
| Contraseña | Código de un solo uso | Enlace mágico | |
|---|---|---|---|
| El usuario | Crea y recuerda una clave | Copia 6 dígitos del correo | Toca un enlace del correo |
| Depende del correo | Al registrarse y recuperar | En cada ingreso | En cada ingreso |
| Enlace profundo | Sí, para confirmar y recuperar | No | Sí |
Un código de un solo uso se abrevia OTP (one-time password).
04
Cuándo conviene cada uno
- Contraseña: el usuario entra seguido y no quieres depender del correo en cada ingreso.
- Código: quieres el flujo más simple en móvil y que funcione aunque el correo se lea en otro dispositivo.
- Enlace mágico: cómodo si el correo se abre en el mismo teléfono; frágil si no.
Puedes combinar: contraseña para ingresar y código para confirmar el correo.
05
En móvil, el código suele ganar
Un enlace tiene que volver a la app. Un código de 6 dígitos solo necesita que el usuario lo lea, donde sea que abra su correo.
06
Registro con contraseña, paso a paso
- La app llama a
signUp()con correo y contraseña. - Supabase crea el usuario y envía un correo de confirmación.
- El usuario confirma desde el correo.
- Desde ahí ingresa con
signInWithPassword().
En los proyectos alojados en Supabase la confirmación de correo viene activada por defecto. En desarrollo local viene desactivada: lo que pruebas en tu computador no siempre se comporta igual que en producción.
07
La pantalla que casi todos olvidan
Después de registrarse, el usuario todavía no tiene sesión: tiene un correo por revisar.
08
El viaje del enlace de confirmación
El tramo delicado es el del medio: adónde redirige Supabase. Si no se lo dices, usa la dirección del sitio configurada en el proyecto, que por defecto es localhost:3000.
09
Preparar el enlace profundo
- Define un esquema propio en
app.json, por ejemplo"scheme": "cafeteria". - En la configuración de URL de Auth del panel, agrega la redirección permitida, por ejemplo
cafeteria://**. - Pasa
emailRedirectToal registrar o al pedir el enlace. - En la app, recibe el enlace, extrae los tokens y llama a
setSession().
Solo se aceptan redirecciones que estén en esa lista.
10
El error del enlace que abre el navegador
Compruébalo siempre en un teléfono real con tu development build: un esquema propio no se prueba en un navegador de escritorio.
11
Cómo funciona el código de un solo uso
- La app llama a
signInWithOtp()con el correo. - Supabase envía el correo. Para que lleve un código y no un enlace, la plantilla debe incluir la variable
{{ .Token }}. - El usuario escribe el código en la app.
- La app llama a
verifyOtp()con el correo, el código ytype: 'email'.
Si el código es correcto, Supabase devuelve la sesión.
12
Los números del código
Valores por defecto de Supabase al 18-11-2026:
| Dato | Valor |
|---|---|
| Largo del código | 6 dígitos |
| Vigencia | 1 hora, configurable |
| Nuevo envío al mismo usuario | Uno cada 60 segundos |
Diseña la pantalla con esos datos: un contador de 60 segundos en «Reenviar código» evita que el usuario toque el botón diez veces y crea que no funciona.
13
Registro e ingreso pueden ser la misma pantalla
Por defecto, signInWithOtp() crea la cuenta si el correo no existe. Eso permite una sola pantalla: «escribe tu correo».
14
Recuperar la contraseña
- La app llama a
resetPasswordForEmail()con el correo y unredirectTohacia tu esquema. - El usuario toca el enlace y la app se abre con una sesión temporal.
- La app muestra la pantalla «Nueva contraseña».
- La app llama a
updateUser()con la contraseña nueva.
Es el mismo enlace profundo de la confirmación, con otra pantalla de destino.
15
No reveles si un correo tiene cuenta
resetPasswordForEmail() responde sin error aunque el correo no exista, y en ese caso no envía nada. Es intencional: impide que alguien use tu app para averiguar quién está registrado.
16
El correo de pruebas no es para usuarios reales
El servicio de correo que trae Supabase sirve para explorar. Con usuarios reales necesitas tu propio servicio de envío.
17
Límites del correo incorporado
Según la documentación de Supabase al 18-11-2026:
| Aspecto | Correo incorporado |
|---|---|
| Destinatarios | Solo direcciones del equipo de tu organización |
| Ritmo | 2 mensajes por hora, sujeto a cambio sin aviso |
| Garantía | Ninguna: es de mejor esfuerzo |
A cualquier otra dirección el envío falla con el error «Email address not authorized». Vuelve a comprobar estas cifras en la fuente antes de lanzar.
18
Configurar un SMTP propio
SMTP es el protocolo estándar para enviar correo. Los pasos:
- Contrata un servicio de envío de correo que ofrezca SMTP.
- Obtén sus cuatro datos: servidor, puerto, usuario y contraseña.
- Define un remitente, por ejemplo una dirección «no responder» de tu dominio.
- Actívalo en la configuración de autenticación del proyecto.
Un SMTP recién configurado parte con 30 mensajes por hora, ajustable en los límites de Auth.
19
Las pantallas que necesitas
| Pantalla | Con contraseña | Con código |
|---|---|---|
| Registro | Sí | Opcional |
| Ingreso | Sí | Sí |
| Revisa tu correo / escribe el código | Sí | Sí |
| Recuperar acceso | Sí | No hace falta |
| Nueva contraseña | Sí | No hace falta |
Con código hay menos pantallas y menos casos que probar. Es parte de su ventaja.
20
Detalles del formulario que suman
- Tipo de teclado de correo en el campo de correo, sin mayúscula automática.
- Botón para mostrar la contraseña en vez de pedirla dos veces.
- Autocompletado del sistema activado, para que el teléfono ofrezca guardar la clave.
- Botón deshabilitado mientras el pedido está en curso.
Lo viste en el módulo 5, clase 6; aquí se aplica completo.
21
Mensajes de error que ayudan
En el ingreso no distingas entre «correo no existe» y «contraseña incorrecta»: es la misma filtración de la lámina anterior.
22
Probar el ciclo completo
En un teléfono real, con una dirección de correo que no hayas usado:
- Registro y llegada del correo.
- Confirmación: el enlace abre la app, o el código funciona.
- Cerrar sesión e ingresar otra vez.
- Recuperación de acceso de principio a fin.
- Código vencido o equivocado: ¿el mensaje se entiende?
Repite el paso 2 abriendo el correo en otro dispositivo.
23
Lo que te llevas
- El correo es el método base: funciona en todos los teléfonos y no depende de terceros.
- En móvil, el código de 6 dígitos evita el enlace profundo.
- Todo enlace de correo necesita esquema propio, redirección permitida y
setSession(). - La recuperación no debe revelar qué correos tienen cuenta.
- Antes de lanzar, configura un SMTP propio.
24
Hazlo ahora
En 15 minutos decide el método de tu app y déjalo por escrito en tu especificación:
- Elige contraseña, código o una combinación, con una frase que explique por qué.
- Lista las pantallas que necesitas según la tabla de esta clase.
- Escribe los textos de tres mensajes de error.
- Anota el esquema de tu app y la redirección que tendrás que permitir en Supabase.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026