
Minilección 11 de 30 · Cuentas y acceso
Entiende el recorrido de acceso
¿Para quién es esta lección?
Para quienes quieren acceso con cuenta en un sitio pequeño. El servicio y la aplicación implementan la función; trabaja con un asistente sin escribir autenticación.
Recibir un código y tener sesión iniciada son momentos distintos.
Propósito de esta lección
- Solicita y usa un código real de acceso.
- Verifica los estados con sesión y sin sesión.
- Mantén códigos incorrectos y correos ausentes como fallos reales.
Explicación, ejemplo resuelto y práctica
Antes de empezar
Tu proyecto Supabase de práctica y un buzón permitido o remitente configurado. Usa la página sobre HTTP local o tu HTTPS. El asistente puede guiar la configuración de códigos.
Comprueba tus habilidades iniciales
Son habilidades útiles, no cursos obligatorios bloqueados. Si ya las tienes, empieza aquí; si no, abre la preparación. Los archivos incluidos evitan necesitar un sitio personal previo.
- Cómo publicar tu sitio web desde GitHub
Conecta un repositorio de práctica al alojamiento.
Tiempo estimado: 20–32 min
Estimaciones con los archivos iniciales y las cuentas y herramientas necesarias ya listas. La configuración, las colas de publicación y las esperas de correo o DNS requieren tiempo adicional. La entrega de correo y la configuración de la cuenta pueden añadir esperas. Debes comprobar las restricciones del proveedor y la duración de las sesiones en la cuenta utilizada para el ejercicio.
Comprende la idea
Usa la página con el asistente. La persona introduce su dirección, recibe un código y lo envía antes de que el servicio establezca la sesión.
«Revisa tu buzón» significa que se hizo una solicitud, no que el visitante esté autenticado.
Un ejemplo concreto
Una dirección sola no demuestra que su propietario haya iniciado sesión.
Usa la aplicación Supabase proporcionada. Guía la configuración de códigos con mi buzón permitido; pon solo valores publicables del proyecto en la configuración pública y ejecuta la página sobre HTTP. Ayúdame a solicitar un código, introducirlo, recargar y cerrar sesión. Un código inválido o correo ausente no debe convertirse en una sesión ficticia.Archivos de este paso
Empieza aquíArchivos del taller
Abre o descarga los archivos de abajo. Al guardar el proyecto, conserva las rutas que aparecen en sus nombres.
Pruébalo
¿Qué estados visibles comprobarás entre introducir dirección e iniciar sesión realmente?
Mostrar una solución desarrollada
Ejemplo de respuesta: «Después de Send sign-in code espero un mensaje de solicitud aceptada. Luego debo encontrar el correo. Solo cuando Verify code tenga éxito debería la página identificar mi cuenta conectada».
«Check your inbox» pertenece a la solicitud. No demuestra llegada del correo ni existencia de sesión.
Qué incluye una respuesta adecuada
- Separa solicitar el mensaje, recibir su código y verificar la sesión.
- Identifica la cuenta verificada mostrada, no la dirección introducida, como evidencia de sesión.
Cómo funciona (opcional)
Añade una sesión real de acceso
La autenticación verifica una identidad; mostrar un correo no basta.
Utilizaremos Supabase Auth para enviar un código de un solo uso por correo y establecer una sesión tras verificarlo. El SDK del navegador gestiona el almacenamiento y la renovación de la sesión; no implementamos una base de datos de contraseñas.
Que el endpoint de correo acepte una solicitud no significa que el usuario haya iniciado sesión. La sesión solo aparece tras una verificación válida. Autorizar el acceso a datos privados es otra comprobación posterior e independiente.
Ejemplo resuelto
Escribir el correo de otra persona en un campo no debe conceder su acceso. El código enviado a esa bandeja constituye el paso de verificación.
Supabase: códigos de acceso por correo · Supabase: tipos de claves de API
Ejercicio técnico adicional
La página aceptó un correo y dice “Check your inbox” (revisa tu bandeja). ¿Ya está autenticado el visitante?
Mostrar una solución desarrollada
No. Se ha iniciado la solicitud de acceso. Verifica el código y examina la sesión resultante antes de mostrar que se ha iniciado sesión.
- Mantiene separados los estados de solicitud y verificación.
- Exige una verificación correcta y una sesión.

Paso 1 · Cómo permitir que las personas inicien sesión en tu sitio web
Prepara proveedor y página
Elige el flujo de código esperado por el formulario.
Explicación, ejemplo resuelto y práctica
Comprende la idea
Antes de probar, pide revisar cuatro preparativos obligatorios: proyecto Supabase previsto, buzón permitido por la configuración del remitente, plantilla con código y página servida por HTTP. La plantilla debe corresponder a esta interfaz de código, no contener solo un enlace mágico.
Solo la URL y clave publicable del proyecto van en public/config.js. Excluye claves secretas/service-role del navegador. Comprobar el proveedor y la aplicación es obligatorio; leer o reescribir la autenticación es opcional.
Un ejemplo concreto
Un enlace de correo funcional puede ser el flujo equivocado para una página que pide escribir un código.
Archivos de este paso
Empieza aquíArchivos del taller
Abre o descarga los archivos de abajo. Al guardar el proyecto, conserva las rutas que aparecen en sus nombres.
Pruébalo
¿Coincidían configuración y mensaje recibido con el formulario de código?
Mostrar una solución desarrollada
Ejemplo de preparación: «Proyecto seleccionado; plantilla con código; public/config.js contiene solo URL y clave publicable; la página abre por HTTP local».
Un bloqueo podría decir: «La página abre, pero el correo solo trae enlace. La prueba de código espera que el asistente ayude a corregir la plantilla». Ninguno de los registros incluye una clave o código reutilizable.
Qué incluye una respuesta adecuada
- Identifica el proyecto, la plantilla con código y la disponibilidad de la vista HTTP.
- Distingue configuración pública y claves secretas y registra cualquier bloqueo.
Cómo funciona (opcional)
Configura el proveedor y el cliente del navegador
La plantilla de correo y el tipo de clave deben corresponder al flujo de códigos proporcionado.
En un proyecto Supabase separado, activa la autenticación Email. Comprueba si su remitente puede entregar a tu bandeja de prueba; configura SMTP compatible cuando sea necesario. En la plantilla de correo Magic Link, incluye {{ .Token }} para que el mensaje proporcione el código que espera esta página.
Pon la URL del proyecto y la clave publicable en config.js. Esa clave identifica la aplicación; no es una sesión de usuario ni un secreto administrativo. Nunca pongas una clave secreta o service-role en este archivo del navegador. Sirve public/ mediante HTTP/HTTPS para que funcionen las importaciones de módulos.
La página espera un código de correo (OTP) escrito por el usuario. En la plantilla del proveedor, {{ .Token }} muestra ese código; una plantilla que solo contenga una variable de enlace de confirmación no dará a esta interfaz el código que pide. Utiliza la guía actual de correo sin contraseña para localizar la plantilla, en vez de adivinar el nombre de un ajuste.
La guía oficial “With OTP” de Supabase explica expresamente que los códigos de correo comparten la implementación Magic Link: modifica esa plantilla para incluir {{ .Token }}. El nombre no significa que esta página deba recibir un mensaje que solo tenga un enlace. Sigue esa guía si cambian las etiquetas del panel; no inventes un ajuste de plantilla ajeno a este flujo.
Ejemplo resuelto
El método del SDK se llama signInWithOtp, pero el correo puede contener un enlace o un código según la plantilla. Nuestra interfaz espera la versión con código.
Ejercicio técnico adicional
Tu página pide un código, pero el correo solo contiene un enlace mágico. ¿Qué debes comprobar?
Mostrar una solución desarrollada
Comprueba el valor Token de la plantilla configurada y repite la solicitud después de adaptarla a la interfaz de códigos. Sigue la documentación actual del proveedor para tu proyecto.
- Comprueba la plantilla de correo y el flujo previsto.
- No inventa un código ni afirma que se verificó el mensaje.

Paso 2 · Cómo permitir que las personas inicien sesión en tu sitio web
Completa un acceso real
Usa el correo, no un código inventado.
Explicación, ejemplo resuelto y práctica
Comprende la idea
Comienza sin sesión en una ventana privada nueva. Solicita código a tu buzón y prueba primero uno incorrecto deliberadamente. Verifica el rechazo y que no aparezca cuenta conectada. Después solicita otro código, introduce el real recibido y revisa la identidad mostrada.
Un código rechazado no debe iniciar sesión. Si ya estabas conectado, podría conservarse esa sesión: es otra situación y no prueba que se impida una nueva. Si no llega correo, registra ese bloqueo exacto.
Un ejemplo concreto
Una etiqueta amable de éxito tras rechazar el código falsearía el estado de cuenta.
Archivos de este paso
Empieza aquíArchivos del taller
Abre o descarga los archivos de abajo. Al guardar el proyecto, conserva las rutas que aparecen en sus nombres.
Pruébalo
En una ventana nueva sin sesión, ¿qué ocurrió con el código incorrecto y después con otro código real recién recibido?
Mostrar una solución desarrollada
Ejemplo de test: «En una ventana privada nueva, el código incorrecto mostró Code was not accepted y aún aparecía No signed-in account. Pedí un código nuevo, lo verifiqué y vi mi cuenta controlada identificada».
Sin llegada del correo, un registro válido sería: «Solicitud aceptada; sin código en buzón permitido ni spam; verificación correcta no probada». Un código erróneo probado ya conectado no demuestra prevención de una nueva sesión.
Qué incluye una respuesta adecuada
- Prueba un código incorrecto sin sesión y registra que no se estableció conexión.
- Utiliza después un código real nuevo y comprueba la cuenta resultante.
Cómo funciona (opcional)
Solicita y verifica un código
Cada botón corresponde a una transición de estado diferente.
Lee public/app.js. La primera acción llama a signInWithOtp con el correo introducido; la segunda llama a verifyOtp con ese correo y el token recibido. Un resultado correcto incluye una sesión.
Utiliza tu propia bandeja y copia exactamente el código actual. Un código incorrecto, caducado o ya utilizado debe dejar al usuario sin sesión. No registres códigos ni tokens de acceso en un informe compartido.
Ejemplo resuelto
La interfaz utiliza textContent para el estado y los textos de cuenta. No interpreta un correo como HTML.
const {data,error}=await client.auth.verifyOtp({email,token,type:'email'});
if(error || !data.session) { /* keep the unverified state */ }Ejercicio técnico adicional
Un código incorrecto devuelve un error, pero la aplicación muestra “Signed in” (sesión iniciada) de todos modos. ¿Qué condición debe cambiar?
Mostrar una solución desarrollada
Muestra el estado de sesión iniciada solo cuando la verificación funciona y existe una sesión. No utilices el clic del botón como prueba.
- Comprueba el error devuelto y la sesión.
- Mantiene separado el fallo de la autenticación correcta.

Paso 3 · Cómo permitir que las personas inicien sesión en tu sitio web
Comprueba recarga y cierre de sesión
Asegúrate de que el estado visible siga la sesión real.
Explicación, ejemplo resuelto y práctica
Comprende la idea
Recarga tras iniciar sesión y revisa la cuenta. Usa Sign out y vuelve a revisar la identidad. Para una sesión independiente, usa otro perfil del navegador o cierra todas las ventanas privadas antes de abrir una: las ventanas privadas adicionales pueden compartir la sesión existente.
El proyecto muestra estado de cuenta, no un documento protegido. Si añades contenido privado, el servidor debe verificar acceso antes de devolverlo. Ocultar un botón no aporta esa protección.
Un ejemplo concreto
La página sin sesión no debe seguir actuando como la cuenta anterior porque quede una etiqueta.
Archivos de este paso
Empieza aquíArchivos del taller
Abre o descarga los archivos de abajo. Al guardar el proyecto, conserva las rutas que aparecen en sus nombres.
Pruébalo
¿Qué estado apareció al recargar, al salir y en una ventana privada nueva?
Mostrar una solución desarrollada
Ejemplo de sesión: «La recarga aún identificaba A. Sign out cambió a No signed-in account. Otro perfil del navegador tampoco mostraba cuenta».
Este inicio demuestra estado de cuenta, no documento privado. Si persiste la sesión después de salir, registra el fallo; el acceso a contenido privado se prueba en private-page.
Qué incluye una respuesta adecuada
- Registra el estado tras recarga y cierre de sesión.
- Comprueba otro perfil o una sesión privada recién iniciada en lugar de suponer que otra ventana es independiente.
Cómo funciona (opcional)
Comprueba la persistencia y el cierre de sesión
Prueba más que el primer código correcto.
Después de iniciar sesión, actualiza la página y examina el estado de cuenta. Después cierra sesión y vuelve a actualizar. Utiliza una ventana privada para verificar que otro navegador no hereda la sesión automáticamente.
Cerrar sesión elimina la sesión de este cliente; no significa que todos los tokens copiados en cualquier lugar dejen de funcionar al instante. La duración y la revocación de tokens de acceso importan al crear endpoints de servidor protegidos.
Ejemplo resuelto
La interfaz sin sesión no debe conservar información privada de la cuenta ni adjuntar automáticamente un token antiguo a una solicitud nueva. Los endpoints privados siguen necesitando verificación del servidor.
Ejercicio técnico adicional
¿Bastaría con ocultar el botón Sign in para proteger un documento privado?
Mostrar una solución desarrollada
No. El servidor debe verificar a quien llama antes de devolver contenido protegido. La siguiente lección sobre páginas privadas implementa ese límite.
- Distingue el estado de la interfaz de la autorización del servidor.
- Exige comprobaciones de acceso al solicitar el documento.

Paso 4 · Cómo permitir que las personas inicien sesión en tu sitio web
Registra todo el recorrido de cuenta
Termina con observaciones reproducibles, no solo una captura de éxito.
Explicación, ejemplo resuelto y práctica
Comprende la idea
Repite dirección–correo–código tras corregir. Guarda un registro sin datos sensibles de acceso, recarga, cierre y un intento fallido significativo.
Si restricciones de remitente o cuenta bloquean el test, indica la etapa precisa. No sustituyas un código entregado real por una simulación local.
Un ejemplo concreto
Un informe útil distingue correo ausente, código incorrecto y verificación satisfactoria.
Archivos de este paso
Empieza aquíArchivos del taller
Abre o descarga los archivos de abajo. Al guardar el proyecto, conserva las rutas que aparecen en sus nombres.
Pruébalo
Entrega las comprobaciones de cuenta y lo que sigue bloqueado.
Qué debes entregar: Un registro breve de llegada real del código, acceso, recarga, cierre e intento fallido.
Mostrar una solución desarrollada
Ejemplo completo: «El buzón recibió código; uno erróneo sin sesión fue rechazado; otro válido nuevo identificó A; recargar mantuvo A; salir borró identidad; otro perfil independiente no tenía sesión».
Ejemplo incompleto: «La solicitud falló por restricciones del remitente. No se probaron llegada ni verificación; siguiente acción: revisar destinatario permitido y remitente». Un flujo bloqueado debe quedar incompleto, no reemplazarse por un acceso local fingido.
Qué incluye una respuesta adecuada
- Presenta en orden solicitud, correo, código incorrecto, válido, recarga y salida.
- Identifica pasos de correo/proveedor pendientes sin guardar códigos ni tokens de sesión.
Cómo funciona (opcional)
Tu tarea: verificar el recorrido completo de la cuenta
Documenta los estados de solicitud, fallo, sesión iniciada y sesión cerrada.
Prueba un código incorrecto antes de completar un acceso válido. Comprueba la actualización, el cierre de sesión y una ventana privada. Utiliza solo bandejas que controles.
Mejora un mensaje poco claro sin cambiar su veracidad: un código solicitado está pendiente y un error no es una sesión correcta.
Ejemplo resuelto
El informe debe identificar los estados observados sin revelar el código recibido, el token bearer ni información privada del perfil.
Encontrarás el desarrollo completo de referencia en reference/assignment-walkthrough.txt. Compara sus pasos con tu resultado; rellena el registro de pruebas con observaciones de tu propio proyecto.
Ejercicio técnico adicional
Completa el recorrido de cuenta y explica qué demuestra cada estado observado.
Mostrar una solución desarrollada
Configura la URL del proyecto y la clave publicable y después una plantilla que contenga {{ .Token }}, para que el mensaje incluya el código que espera esta página. Solicita un código para tu propia bandeja. Un correo solicitado no es una sesión verificada.
Introduce un código incorrecto y confirma que no se crea ninguna sesión de usuario. Utiliza un código válido nuevo, verifica la identidad mostrada, recarga y observa la sesión. Cierra sesión y verifica que la pestaña ya no informa de una sesión.
Repite desde una ventana privada: no debe heredar el estado de acceso de la primera. Ocultar un botón no tiene relación con proteger un documento; el servidor debe verificar la autorización antes de devolver contenido privado.
- Los casos de código incorrecto y sesión cerrada siguen sin autenticar.
- Una sesión válida persiste según su configuración y se verifica honestamente el cierre de sesión del cliente.
¿Te resultó útil esta lección?
Deja un me gusta o compártela con alguien a quien pueda servirle.