El modelo de permisos
Por defecto, un programa de Node.js puede hacer todo: leer cualquier archivo, ejecutar comandos, abrir conexiones. Con --permission, todo queda prohibido salvo lo que permitas:
node --permission \
--allow-fs-read=./publico --allow-fs-read=./config.json \
--allow-fs-write=./subidas \
servidor.mjs
Si una dependencia comprometida intenta leer ~/.ssh o lanzar un proceso, Node.js lo bloquea con un error ERR_ACCESS_DENIED. Desde el código, process.permission.has("fs.read", ruta) dice si un permiso está concedido.
Secretos fuera del código
Las claves de las APIs, las contraseñas de las bases de datos y los tokens van en variables de entorno, nunca en el código ni en el repositorio:
# .env (en el .gitignore)
DATABASE_URL=postgres://usuario:clave@localhost/tienda
STRIPE_KEY=sk_live_…
node --env-file=.env servidor.mjs
const url = process.env.DATABASE_URL;
if (!url) throw new Error("Falta DATABASE_URL"); // falla al arrancar, no a mitad de camino
Un secreto que llegó alguna vez al historial de Git está filtrado, aunque lo borres después: hay que cambiarlo.
Valida todo lo que entra
El cuerpo, la URL, los parámetros, los encabezados y los archivos subidos vienen de afuera. Comprueba tipo, forma y tamaño antes de usarlos. Librerías como Zod o Valibot describen la forma esperada y validan en una línea:
import { z } from "zod";
const NuevoPedido = z.object({
producto: z.string().min(1).max(100),
cantidad: z.number().int().positive().max(50),
email: z.email(),
});
const resultado = NuevoPedido.safeParse(cuerpo);
if (!resultado.success) return json(res, 400, { error: "datos inválidos" });
const pedido = resultado.data; // ya tiene la forma correcta
Limita también el tamaño de los cuerpos: sin límite, alguien puede enviar un JSON de varios gigas y agotar la memoria.
Inyecciones
Cada vez que un dato de afuera se mezcla con código (SQL, comandos, rutas), hay riesgo de inyección:
- SQL: usa siempre consultas con parámetros (
db.query("SELECT * FROM usuarios WHERE email = $1", [email])), nunca concatenes. - Comandos:
execFileospawncon argumentos separados, nuncaexeccon texto armado. - Rutas (path traversal): un pedido de
/archivos/../../.envpuede leer lo que no debería. Resuelve la ruta y comprueba que siga dentro de la carpeta permitida:
import path from "node:path";
const PUBLICA = path.resolve("publico");
function rutaPermitida(pedido) {
const ruta = path.resolve(PUBLICA, "." + path.posix.normalize("/" + pedido));
return ruta.startsWith(PUBLICA + path.sep) ? ruta : null;
}
- Contaminación de prototipos: mezclar un JSON de afuera con
Object.assigno un “merge profundo” puede escribir en__proto__y cambiarObject.prototypepara todo el programa. Usa librerías que lo eviten, oObject.create(null)para los diccionarios.
Encabezados y límites
- Encabezados de seguridad en las respuestas:
Content-Security-Policy,Strict-Transport-Security,X-Content-Type-Options: nosniff… El paquete helmet (o el middleware de tu framework) los pone por ti. - Límites de uso (rate limiting): pocas peticiones por minuto en el login, por ejemplo, para frenar los ataques de fuerza bruta.
- Contraseñas: nunca en texto plano. Guárdalas con un algoritmo lento pensado para eso:
scrypt(incluido ennode:crypto), bcrypt o argon2. - Errores: registra el detalle en el servidor, pero al cliente devuélvele solo un mensaje genérico.
Dependencias
Cada paquete que instalas, y cada dependencia de ese paquete, corre con tus permisos. Los ataques a la cadena de suministro (paquetes comprometidos o con nombres parecidos a los reales) son de los más comunes:
- Usa un lockfile y súbelo al repositorio: fija las versiones exactas.
npm audit(o el equivalente de tu gestor) avisa de vulnerabilidades conocidas.- Revisa qué instalas: popularidad, mantenimiento, cuántas dependencias trae.
- Desactiva los scripts de instalación cuando no hacen falta (
ignore-scripts), o usa un gestor que pida permiso para ejecutarlos, como pnpm.
Resumen
--permissionlimita lo que puede hacer el programa, y con él cualquier dependencia.- Secretos en variables de entorno, nunca en el código ni en el repositorio.
- Valida todo lo que entra (forma y tamaño), por ejemplo con Zod.
- Contra las inyecciones: consultas con parámetros,
execFile, rutas resueltas y comprobadas. - Encabezados de seguridad, límites de uso, contraseñas con
scrypty errores genéricos hacia afuera. - Lockfiles, auditorías y cuidado con lo que instalas.
¡A practicar!
Tu progreso se guarda en este navegador.
Autoevaluación: Proteger el servidor
Resuelto
Elige una respuesta en cada pregunta.
¿Qué hace el modelo de permisos de Node.js (
node --permission)?¿Dónde van las claves de una API o la contraseña de la base de datos?
¿Qué es un ataque de path traversal?
¿Qué ayuda a protegerse de dependencias maliciosas?
Ordena la salida: Rutas que intentan escapar
Resuelto
Una comprobación contra el path traversal, con cuatro pedidos. Ordena lo que aparecería en la consola.
1function rutaSegura(pedido) {2 const url = new URL(pedido, "http://x/publico/");3 return url.pathname.startsWith("/publico/") ? url.pathname : `bloqueado (${url.pathname})`;4}5 6console.log(rutaSegura("logo.png"));7console.log(rutaSegura("../secreto.env"));8console.log(rutaSegura("img/../../etc/passwd"));9console.log(rutaSegura("%2e%2e/%2e%2e/clave.pem"));Consola, de arriba abajo
- bloqueado (/etc/passwd)
- /publico/logo.png
- bloqueado (/clave.pem)
- bloqueado (/secreto.env)
La regla: primero resolver la ruta (los .., incluso escritos como %2e%2e) y después comprobar que siga dentro de la carpeta permitida. Comprobar el texto antes de resolverlo, buscando "..", es fácil de burlar.
Detective: Un permiso que falta
Resuelto
Con el modelo de permisos activado, el programa no puede leer su configuración. Encuentra la línea y elige el arreglo.
Consola
node:internal/fs/promises:639
return new FileHandle(await binding.openFileHandle(path, flags, mode, kUsePromises));
^
Error: Access to this API has been restricted. Use --allow-fs-read to manage permissions.
at async readFile (node:internal/fs/promises:1242:14) {
code: 'ERR_ACCESS_DENIED',
permission: 'FileSystemRead',
resource: '/proyecto/config.json'
}Paso 1: toca la línea de código que causa el error.
Paso 2: ¿cómo lo arreglas?