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
baseestá en otro origen —un CDN—, ese origen entra en la política. - Los estilos admiten
'unsafe-inline': los atributosstyleno 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
.htmlque Vite construya por su cuenta —una entrada debuild.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
Originde la petición es el del sitio —X-Forwarded-Hostdetrás de un proxy—. Un formulario enviado desde otro sitio recibe un 403. Todo navegador mandaOriginen unPOSTy 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:
ASCUA_SECRET="$(openssl rand -base64 48)" node dist/server/index.mjsEl 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
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.