Guía

Seguridad

Cada página sale con una CSP sin unsafe-inline en los scripts —también en un sitio estático—, y con servidor, cabeceras seguras, cookies HttpOnly y firmadas, y formularios solo del mismo origen. Sin configurar nada.

En mode: "server" —y en desarrollo— el kit aplica ascua-security a cada respuesta. Un sitio estático lleva al menos la política de contenido, dentro de cada página. No hay que instalar ni configurar nada.

Content-Security-Policy

Cada página HTML sale con una política cerrada:

default-src 'self'; script-src 'self' 'sha256-…'; style-src 'self' 'unsafe-inline';
img-src 'self' data: blob:; font-src 'self'; connect-src 'self'; object-src 'none';
base-uri 'self'; form-action 'self'; frame-ancestors 'none'

Lo importante está en script-src: sin 'unsafe-inline'. El kit calcula el hash de cada script en línea sobre el HTML que se envía —el del esqueleto, por ejemplo—, así que lo que la página trae funciona y lo que se cuele por una plantilla no corre. La lista de islas es JSON y no necesita hash; el script que las hidrata va con src.

  • Si el cliente lleva WebAssembly, añade 'wasm-unsafe-eval', sin el que el navegador no lo compila.
  • Si base está en otro origen —un CDN—, ese origen entra en la política.
  • Los estilos admiten 'unsafe-inline': los atributos style no se pueden contar con hashes, y un estilo inyectado no ejecuta código.

En desarrollo va como Content-Security-Policy-Report-Only: la consola del navegador avisa de lo que se bloquearía, sin romper nada.

En un sitio estático

Un sitio estático no manda cabeceras, así que el build escribe la misma política en cada página, como <meta http-equiv="Content-Security-Policy"> justo detrás del <meta charset>, con los hashes de sus scripts en línea. Es la que avisaba en desarrollo. Dos diferencias con la cabecera:

  • No lleva frame-ancestors: en un <meta> el navegador la ignora. Si el sitio no debe verse dentro de un <iframe> ajeno, la cabecera la tiene que poner quien lo sirve.
  • Solo cubre las páginas de las rutas del kit. Un .html que Vite construya por su cuenta —una entrada de build.rollupOptions.input— sale como está.

URLs en atributos

El runtime no escribe una URL javascript: que llegue por un hueco a href, src, action, formaction o data, ni en el cliente ni en el HTML del servidor (detalle). Es una red, no la validación: una URL de un tercero que solo debería ser https: se comprueba antes de pintarla.

Tampoco escribe un srcdoc que llegue por un hueco si el <iframe> no lleva sandbox en la plantilla (detalle).

Cabeceras

X-Content-Type-Options: nosniff El navegador no adivina tipos; también en los archivos de dist/client/
Referrer-Policy: strict-origin-when-cross-origin A otro sitio solo llega el origen, no la ruta
Cross-Origin-Opener-Policy: same-origin Una ventana abierta desde otro sitio no toca esta
Strict-Transport-Security: max-age=31536000 Solo si la petición llegó por HTTPS, también tras un proxy (X-Forwarded-Proto)

Lo que responde a un POST o escribe cookies lleva además Cache-Control: private, no-store.

Formularios

  • Solo del mismo origen. Una acción corre únicamente si el Origin de la petición es el del sitio —X-Forwarded-Host detrás de un proxy—. Un formulario enviado desde otro sitio recibe un 403. Todo navegador manda Origin en un POST y otro sitio no puede falsificarlo, así que no hacen falta tokens en cada formulario.
  • Cuerpo limitado a 1 MiB: más es un 413.

Cookies

cookies.set las escribe HttpOnly (no se leen desde JavaScript), SameSite=Lax (no viajan en el POST de otro sitio), Secure (salvo en localhost) y Path=/. Cualquiera se cambia en las opciones.

cookies.setSigned y getSigned las firman con HMAC-SHA256 y la clave de la variable de entorno ASCUA_SECRET, de 32 caracteres o más:

sh
ASCUA_SECRET="$(openssl rand -base64 48)" node dist/server/index.mjs

El valor viaja legible —firmar no es cifrar—, pero una cookie tocada se lee como si no estuviera. El secreto sale del entorno y nunca del build: dist/server/ se copia y se sube. En desarrollo, sin ASCUA_SECRET, se usa una clave aleatoria por proceso.

Ajustarlo

ts
ascua({
  site: {
    mode: "server",
    security: {
      csp: { "img-src": ["https://cdn.ejemplo.cl"], "frame-ancestors": null },
      headers: { "Permissions-Policy": "camera=()" },
      origins: ["https://admin.ejemplo.cl"],
      bodyLimit: 10 * 1024 * 1024,
    },
  },
});
csp Suma fuentes a cada directiva; null la quita. false no manda la política
headers Añade o reemplaza cabeceras; null quita una
origins Otros orígenes de confianza para las acciones
bodyLimit Bytes aceptados en un POST

security: false lo apaga todo, y csp: false solo la política, también la del <meta> de un sitio estático. Las demás opciones solo valen con servidor: un sitio estático no manda cabeceras —las pone quien lo sirve— ni recibe formularios.