Referencia

ascua-security

CSP con hashes, cabeceras, cookies firmadas y la comprobación de origen, para usarlos en cualquier servidor.

ts
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

ts
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

ts
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

ts
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-Cookie

Las 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

ts
checkOrigin(request: Request, options?: { origins?: string[] }): boolean

true 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.