Referencia
ascua-security
CSP con hashes, cabeceras, cookies firmadas y la comprobación de origen, para usarlos en cualquier servidor.
import {
checkOrigin, contentSecurityPolicy, createCookies, hash, inlineScripts,
parseCookies, securityHeaders, serializeCookie, sign, unsign,
} from "ascua-security";Sin dependencias y con Web Crypto: corre en Node 20+, Deno, Bun y un worker.
El kit de sitios lo aplica solo en mode: "server" (Seguridad);
esto es para usarlo en otro servidor.
CSP
contentSecurityPolicy(html?: string, options?: {
directives?: Record<string, string[] | null | false>;
wasm?: boolean;
}): Promise<string>La política de partida (DEFAULT_DIRECTIVES) más el hash de cada script en
línea de html que el navegador ejecutaría. directives suma fuentes;
null quita la directiva. wasm añade 'wasm-unsafe-eval'.
inlineScripts(html) da el contenido de esos scripts y hash(texto) su
hash, 'sha256-…'.
Cabeceras
securityHeaders(options?: {
csp?: string;
reportOnly?: boolean;
hsts?: boolean;
headers?: Record<string, string | null | false>;
}): Record<string, string>nosniff, Referrer-Policy, Cross-Origin-Opener-Policy, la CSP —como
-Report-Only con reportOnly— y, con hsts, Strict-Transport-Security.
Los nombres van en minúsculas.
Cookies
const cookies = createCookies(request.headers.get("cookie"), { secret, secure });
cookies.get(nombre): string | undefined
cookies.all(): Record<string, string>
cookies.set(nombre, valor, opciones?)
cookies.delete(nombre, opciones?)
await cookies.getSigned(nombre): string | undefined
await cookies.setSigned(nombre, valor, opciones?)
cookies.headers(): string[] // las líneas de Set-CookieLas opciones son path, domain, maxAge (segundos), expires,
httpOnly, secure, sameSite y partitioned. Por defecto HttpOnly,
Secure, SameSite=Lax y Path=/. secret es un texto de 32 caracteres o
más, o una función que lo da cuando hace falta.
Sueltos: parseCookies(cabecera), serializeCookie(nombre, valor, opciones),
sign(valor, secreto) y unsign(firmado, secreto), que devuelve null si
la firma no es de ese secreto.
CSRF
checkOrigin(request: Request, options?: { origins?: string[] }): booleantrue si Origin es el host propio —X-Forwarded-Host o Host— o uno de
origins. Sin Origin pasa, salvo que Sec-Fetch-Site diga cross-site.