Minilección · Español

Cómo permitir que las personas inicien sesión en tu sitio web

Conecta la página de acceso lista a un servicio gestionado de cuentas y prueba códigos por correo, cierre de sesión e intentos fallidos.

Comenzar la lección interactivaLeer los apuntes

¿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.

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.

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.

Qué aprenderás

  • 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.

Archivos del taller

Paso 1

Entiende el recorrido de acceso

Recibir un código y tener sesión iniciada son momentos distintos.

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.

Supabase: códigos de acceso por correo · Supabase: tipos de claves de API

Archivos de este paso

Start hereArchivos del taller

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

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

Extra implementation exercise

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 2

Prepara proveedor y página

Elige el flujo de código esperado por el formulario.

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

Start hereArchivos del taller

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

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.

Extra implementation exercise

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 3

Completa un acceso real

Usa el correo, no un código inventado.

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

Start hereArchivos del taller

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

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 */ }

Extra implementation exercise

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 4

Comprueba recarga y cierre de sesión

Asegúrate de que el estado visible siga la sesión real.

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

Start hereArchivos del taller

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

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.

Extra implementation exercise

¿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 5

Registra todo el recorrido de cuenta

Termina con observaciones reproducibles, no solo una captura de éxito.

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

Start hereArchivos del taller

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

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.

Extra implementation exercise

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.

Sigue aprendiendo

Explora las otras lecciones