Minilección · Español

Cómo mantener privada una página

Usa un proyecto de acceso listo para mantener privada una nota de práctica y probar accesos permitidos y denegados.

Comenzar la lección interactivaLeer los apuntes

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

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.

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.

Qué aprenderás

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

Archivos del taller

Paso 1

Elige qué proteger

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

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

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)

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

Extra implementation exercise

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 2

Conecta la protección lista

Deja al asistente configurar los controles servidor existentes.

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.

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

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)

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

Extra implementation exercise

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

Prueba el público permitido

Decide quién puede leer este elemento concreto.

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

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)

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.

Extra implementation exercise

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 4

Prueba lo mismo sin sesión

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

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

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)

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.

Extra implementation exercise

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 5

Protege otro valor de prueba

Repite los controles tras un cambio pequeño.

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

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

Extra implementation exercise

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.

Sigue aprendiendo

Explora las otras lecciones