LeccionesCómo mantener privada una página

Minilección 12 de 30 · Cuentas y acceso

Elige qué proteger

¿Para quién es esta lección?

Para quienes quieren una página o nota solo tras iniciar sesión. El asistente conecta la protección; aprender programación servidor no es requisito.

Privado significa inaccesible para personas no autorizadas, no solo oculto.

Propósito de esta lección

  • Mantén el contenido privado fuera de la página pública.
  • Prueba el mismo recorrido sin sesión y con sesión.
  • Comprueba un fallo de acceso sin revelar la nota.
Explicación, ejemplo resuelto y práctica

Antes de empezar

La configuración de acceso proporcionada o Supabase equivalente, un proyecto de funciones independiente y un asistente. Usa una PRIVATE_NOTE ficticia solo en el entorno servidor, nunca contenido privado real.

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.

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

    Solicita y usa un código real de acceso.

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. Este ejemplo permite acceso a todos los usuarios válidos del proyecto de práctica. Los registros por usuario y los roles exigen reglas adicionales de autorización.

Comprende la idea

Usa la nota ficticia y proyecto listos. Pide mantenerla en el servidor, no dentro de la página pública descargada.

El visitante puede examinar archivos públicos aunque un elemento esté oculto. No pongas información privada real en el ejercicio.

Un ejemplo concreto

Un párrafo oculto por estilos sigue dentro del archivo público.

Usa este taller completo y mi proyecto de acceso gestionado. Mantén PRIVATE_NOTE solo en el entorno privado del servidor y conserva los controles. Ayúdame a ejecutar y comparar acceso directo sin sesión con acceso verificado. No consideres ocultar un párrafo como protección ni expongas datos ajenos.

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é nota pruebas y cómo comprobarás que un visitante sin sesión no la obtiene?

Mostrar una solución desarrollada

Ejemplo de plan: «Mi nota ficticia recuerda una reunión de práctica. Cualquier usuario de prueba verificado y conectado puede leerla. Probaré la ruta desde una sesión desconectada y confirmaré que no incluya la nota».

La nota debe quedar fuera de los archivos públicos. Ocultar visualmente un párrafo no impediría leer el código descargado.

Qué incluye una respuesta adecuada

  • Usa una nota ficticia solo de servidor e identifica la audiencia de usuarios conectados del laboratorio.
  • Planea petición directa sin sesión, no depende de un elemento oculto.
Cómo funciona (opcional)

Protege la respuesta, no solo el botón

El contenido privado no debe enviarse nunca a un navegador no autorizado.

Ocultar con CSS o desactivar botones cambia la interfaz, no la respuesta. Cualquiera puede examinar archivos públicos y realizar una solicitud directa a un endpoint.

Nuestro servidor lee una nota del entorno y la devuelve solo después de verificar un token de usuario. La nota ficticia sirve para el laboratorio; los datos privados reales deben estar en una fuente protegida, no en un repositorio público.

Ejemplo resuelto

Un archivo JavaScript público que contiene una nota «oculta» sigue siendo una copia pública. El ejemplo mantiene el valor fuera de public/.

Ejercicio técnico adicional

La página oculta un párrafo hasta iniciar sesión, pero el párrafo está en el HTML fuente. ¿Es privado?

Mostrar una solución desarrollada

No. Controla la respuesta del servidor antes de enviar el contenido. Ocultar un valor recibido no puede convertirlo en secreto.

  • Reconoce que el navegador ya lo recibió.
  • Sitúa el control de acceso antes de la respuesta protegida.

Paso 1 · Cómo mantener privada una página

Conecta la protección lista

Deja al asistente configurar los controles servidor existentes.

Explicación, ejemplo resuelto y práctica

Comprende la idea

Sigue run-locally.txt con el asistente. Confirma proyecto de autenticación, valores públicos, configuración privada del servidor y PRIVATE_NOTE ficticia. Arranca el proyecto completo y abre la URL real del proxy; una vista de archivo no ejecuta su protección.

Estos preparativos de cuenta y servidor son obligatorios. Leer la función es opcional. El servicio debe verificar la sesión antes de entregar la nota; escribir otro ID en una solicitud no prueba identidad.

Un ejemplo concreto

Una identidad dada por el usuario no equivale a una sesión confirmada.

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é paso está completo y qué URL real puedes probar?

Mostrar una solución desarrollada

Ejemplo de preparación: «La aplicación corre en la URL del proxy indicada. El proyecto de autenticación y la nota ficticia del servidor están configurados. La nota no aparece en los archivos públicos».

Un bloqueo podría ser: «La página abre, pero devuelve Auth not configured; el asistente debe revisar el entorno privado antes de probar acceso». Abrir la página no demuestra protección del servidor.

Qué incluye una respuesta adecuada

  • Identifica la dirección funcional y la configuración completada de servidor/proveedor.
  • Describe un bloqueo concreto sin publicar la nota ni credenciales.
Cómo funciona (opcional)

Envía un token de sesión al servidor

El cliente aporta un token bearer; el servidor lo verifica de forma independiente.

Configura los archivos de acceso y el entorno del servidor según START-HERE.txt. El cliente obtiene su sesión actual y envía su token de acceso en el encabezado Authorization al solicitar el endpoint privado.

El servidor llama al endpoint de usuario del proveedor con ese token y la clave publicable de aplicación del proyecto. Rechaza tokens ausentes o inválidos y distingue una caída del proveedor de una identidad aceptada. Decodificar un token sin verificarlo no basta.

Sigue la solicitud en orden: el navegador envía su token de usuario → el servidor pregunta al proveedor de identidad si el token representa a un usuario → solo un resultado verificado permite devolver la nota. La clave publicable identifica la aplicación; por sí sola no identifica ni autoriza a la persona.

Para la secuencia local completa, abre run-locally.txt: prepara el entorno privado de la raíz, vincula solo el proyecto de práctica e inicia el proxy de funciones de Netlify. server-env.example.txt enumera variables sin secretos reales. Abrir solo el HTML no ejecuta el servidor.

Ejemplo resuelto

Un campo userId aportado por quien llama no demuestra que le pertenezca ese ID. Utiliza la identidad devuelta por la verificación.

const r=await fetch('/.netlify/functions/mini-private-note', {
 headers:{Authorization:'Bearer '+session.access_token}
});

Supabase: obtener un usuario verificado · Node.js: estado de soporte de versiones

Ejercicio técnico adicional

¿Podría autorizar el servidor una solicitud confiando en userId del JSON del navegador?

Mostrar una solución desarrollada

No. El navegador puede cambiar ese campo. Verifica la credencial y utiliza la identidad verificada.

  • Trata las afirmaciones de identidad del cliente como no fiables.
  • Utiliza un token verificado y la identidad resultante.

Paso 2 · Cómo mantener privada una página

Prueba el público permitido

Decide quién puede leer este elemento concreto.

Explicación, ejemplo resuelto y práctica

Comprende la idea

Inicia sesión con tu cuenta controlada y solicita la nota. En este laboratorio se permite cualquier usuario con sesión verificada; pide conservar ese alcance.

Si después almacenas datos de una persona, esa regla amplia no basta. Especifica el público sin suponer permisos idénticos para todo dato privado.

Un ejemplo concreto

Una nota compartida entre miembros y un registro individual requieren decisiones de acceso distintas.

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

¿Quién puede leer la nota y respetó la petición con sesión esa regla?

Mostrar una solución desarrollada

Ejemplo de acceso: «A está verificado y recibió la nota ficticia de miembros. La regla permite cualquier usuario conectado verificado, así que otro miembro de prueba verificado también está autorizado».

Es una regla compartida entre miembros. No serviría para el perfil personal de A, reservado a A; ese límite requiere verificar propiedad.

Qué incluye una respuesta adecuada

  • Explica que el laboratorio permite cualquier usuario conectado verificado, no solo al dueño de una nota.
  • Registra el resultado autorizado sin extender esta regla a datos personales.
Cómo funciona (opcional)

Devuelve solo los datos protegidos previstos

Una identidad válida no concede automáticamente acceso a los registros de todos los usuarios.

Este ejemplo pequeño concede acceso a una nota compartida a todos los usuarios válidos del proyecto. Es una regla de autorización explícita, no una definición universal de contenido privado.

La respuesta utiliza caché private, no-store para que una caché compartida no deba retener la nota. Una lección posterior utiliza reglas de propiedad para registros por usuario. No conviertas este controlador en un volcado global de base de datos.

Ejemplo resuelto

El viewerId del servidor procede de la verificación. La nota viene de su entorno, no de datos aportados en la solicitud.

Ejercicio técnico adicional

Si sustituyeras la nota por datos de cuenta de otra persona, ¿seguiría siendo adecuada la regla «cualquier usuario con sesión»?

Mostrar una solución desarrollada

No. Añade una regla que relacione la identidad autenticada con el registro o rol solicitado. Iniciar sesión no concede por sí solo acceso a otra cuenta.

  • Distingue autenticación de autorización por registro.
  • Exige propiedad o un rol adecuado para datos individuales.

Paso 3 · Cómo mantener privada una página

Prueba lo mismo sin sesión

Una petición directa importa tanto como el botón normal.

Explicación, ejemplo resuelto y práctica

Comprende la idea

Usa un perfil realmente desconectado, o cierra sesión y comprueba su estado, y pide al asistente la misma nota directamente. Otra ventana privada puede compartir una sesión existente. Repite con una conexión verificada.

El resultado sin sesión no debe contener la nota; la sesión autorizada debe recibirla. Un fallo debe seguir siendo error sin filtrar contenido.

Un ejemplo concreto

Quitar un enlace del menú no protege la dirección que abría.

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é devolvieron los intentos directos sin sesión y con sesión?

Mostrar una solución desarrollada

Ejemplo directo: «Sin sesión: la ruta devolvió Sign in required sin nota. Con A conectado: la misma ruta entregó la nota ficticia. El asistente ayudó a revisar los cuerpos sin compartir tokens».

Si la respuesta sin sesión contiene la nota, la protección falló aunque la página la oculte. Registra aparte una caída del servicio de autenticación y una denegación normal.

Qué incluye una respuesta adecuada

  • Compara la misma ruta sin sesión y con una sesión autorizada.
  • Comprueba que respuestas rechazadas o fallidas no contengan texto privado.
Cómo funciona (opcional)

Prueba el endpoint sin la interfaz

Una prueba real de acceso se dirige directamente a la solicitud de datos.

Solicita la URL de la función en una ventana nueva sin encabezado Authorization; no debe devolver la nota. Prueba un token bearer mal formado y después utiliza la interfaz con sesión para realizar una solicitud autorizada.

Cierra sesión y comprueba que la aplicación borra la nota mostrada y no vuelve a enviar un token. Un token ya emitido puede seguir siendo válido hasta su caducidad configurada; la revocación global inmediata es un requisito independiente.

Ejemplo resuelto

Una solicitud directa denegada demuestra más que una captura de un botón de acceso. Conserva en el registro el estado de respuesta y si estaba presente el texto protegido.

Ejercicio técnico adicional

Una solicitud directa devuelve 401 sin nota, mientras una sesión verificada la recibe. ¿Qué límite probaste?

Mostrar una solución desarrollada

Probaste que este endpoint verifica la identidad antes de devolver la nota compartida. Otros endpoints y reglas de propiedad necesitan sus propias pruebas.

  • Identifica el límite de la respuesta del servidor.
  • No afirma revocación universal de tokens ni autorización individual más allá del ejemplo.

Paso 4 · Cómo mantener privada una página

Protege otro valor de prueba

Repite los controles tras un cambio pequeño.

Explicación, ejemplo resuelto y práctica

Comprende la idea

Pide añadir un segundo valor ficticio solo en servidor con la misma regla de público. No traslades ninguno a archivos públicos por comodidad.

Repite permiso, denegación y fallo. Elimina datos sensibles de la entrega e identifica pruebas no realizadas.

Un ejemplo concreto

Añadir un campo no debe hacer pública accidentalmente la nota original.

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 la protección del nuevo valor y los resultados observados.

Qué debes entregar: El recorrido funcional y controles observados de acceso sin sesión/con sesión/error.

Mostrar una solución desarrollada

Ejemplo de ampliación: «Añadí un lugar ficticio de reunión junto a la nota. Un miembro verificado recibió ambos; la petición directa sin sesión, ninguno. Al inutilizar deliberadamente la autenticación en el entorno desechable, la respuesta fue un error sin ninguno de los valores».

La entrega puede identificar ambos campos y sus resultados sin reproducir el contenido privado. Si no realizaste un caso de fallo, indícalo como no probado en vez de considerar una lectura autorizada correcta como prueba de todas las fronteras de acceso.

Qué incluye una respuesta adecuada

  • Mantiene ambos valores ficticios solo en servidor bajo la regla compartida indicada.
  • Repite respuestas autorizada, denegada y de fallo de servicio para el nuevo valor.
Cómo funciona (opcional)

Tu tarea: añadir un segundo valor protegido

Mantén el valor nuevo fuera de archivos públicos y aplica las mismas comprobaciones de servidor.

Añade otro valor de práctica al entorno del servidor, devuélvelo solo tras verificar y muéstralo de forma segura como texto. Mantén la respuesta sin almacenamiento en caché.

Repite las pruebas de token ausente, inválido y sesión válida. Busca en las fuentes públicas para confirmar que no se incrustó ninguno de los dos valores privados.

Ejemplo resuelto

La tarea amplía la respuesta protegida, no la cantidad de datos enviados antes de iniciar sesión.

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

Protege un segundo valor y aporta pruebas positivas y negativas de acceso.

Mostrar una solución desarrollada

Llama directamente al endpoint private-note sin encabezado Authorization: espera 401 y ninguna nota. Un token bearer inventado también debe fallar. El userId del navegador o un botón oculto no satisfacen la verificación de identidad del servidor.

Con tu token de sesión realmente verificado en tu proyecto de práctica, espera la nota del servidor configurada y Cache-Control: private, no-store. Mantén la nota fuera del HTML y JavaScript públicos. No pegues un token bearer real en un informe compartido.

Tras cerrar sesión, la interfaz debe borrar el contenido privado y dejar de hacer solicitudes autenticadas. Un token de acceso ya copiado puede seguir utilizable hasta caducar: el cierre de sesión en la interfaz no garantiza revocación instantánea. Este laboratorio de nota compartida autoriza usuarios con sesión; la propiedad individual se aborda por separado en el ejercicio de perfil.

  • Ambos valores permanecen en el servidor hasta que se autorice el acceso.
  • Las solicitudes directas no autorizadas no contienen ningún valor; se comprueban el acceso válido y el comportamiento no-store.

¿Te resultó útil esta lección?

Deja un me gusta o compártela con alguien a quien pueda servirle.