
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.
¿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.
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
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.
Error habitual
Equiparar un elemento DOM oculto con autorización.
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
Pruébalo
¿Qué paso está completo y qué URL real puedes probar?
Comenta tu respuesta con el tutor
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.
- Identifica la dirección funcional y la configuración completada de servidor/proveedor.
- Describe un bloqueo concreto sin publicar la nota ni credenciales.
Archivos de este paso
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.
Error habitual
Comprobar solo que existe una cadena de token.
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.
Pruébalo
¿Quién puede leer la nota y respetó la petición con sesión esa regla?
Comenta tu respuesta con el tutor
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.
- 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.
Archivos de este paso
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.
Error habitual
Utilizar una regla de página privada compartida para registros sensibles por usuario.
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.
Pruébalo
¿Qué devolvieron los intentos directos sin sesión y con sesión?
Comenta tu respuesta con el tutor
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.
- Compara la misma ruta sin sesión y con una sesión autorizada.
- Comprueba que respuestas rechazadas o fallidas no contengan texto privado.
Archivos de este paso
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.
Error habitual
Probar solo el recorrido correcto mediante los botones del navegador.
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.
Pruébalo
Materiales para empezar
Los archivos y contenidos de prueba están incluidos. La verificación real requiere tu propia cuenta, buzón o dominio, según los requisitos. Puedes inspeccionar localmente; registra los pasos reales como no probados hasta ejecutarlos.
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.
Comenta tu respuesta con el tutor
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.
- 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.
Archivos de este paso
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.
Error habitual
Añadir el segundo valor como constante del navegador por comodidad.
¿Te resultó útil esta lección?
Deja un me gusta o compártela con alguien a quien pueda servirle.
Sigue aprendiendo
- Cómo crear tu primer sitio web personal
- Cómo publicar tu sitio web desde GitHub
- Cómo conectar un dominio propio a tu sitio web
- Cómo configurar correo en tu propio dominio
- Cómo hacer que tu sitio web se pueda utilizar en teléfonos
- Cómo acelerar la carga de imágenes de tu sitio web
- Cómo recibir los comentarios de tu sitio web en tu bandeja de entrada
- Cómo añadir suscripciones por correo a tu sitio
- Cómo enviar correos automáticos desde tu sitio web
- Cómo guardar envíos de formularios en una base de datos
- Cómo permitir que las personas inicien sesión en tu sitio web
- Cómo permitir que los usuarios editen su perfil
- Cómo permitir que los usuarios suban imágenes
- Cómo mantener las claves de API fuera del frontend
- Cómo mostrar datos de una API externa en tu sitio web
- Cómo añadir un chatbot de IA a tu sitio web
- Cómo hacer que un chatbot responda desde tu contenido
- Cómo añadir un blog a tu sitio web
- Cómo añadir búsqueda a tu sitio web
- Cómo añadir otro idioma a tu sitio web
- Cómo ayudar a Google a encontrar tu sitio web
- Cómo corregir la vista previa de tu sitio al compartir un enlace
- Cómo medir visitas y acciones útiles en tu sitio web
- Cómo permitir que los visitantes reserven una cita
- Cómo aceptar un pago en tu sitio web
- Cómo previsualizar cambios de tu sitio antes de publicarlos
- Cómo revertir un despliegue defectuoso de tu sitio web
- Cómo hacer copias de seguridad y restaurar los datos de tu sitio
- Cómo encontrar y corregir errores en tu sitio publicado