Documentación de El libro de Sibuna 1.0.0-beta.3
Idioma: Español
English简体中文한국어日本語EspañolDeutschहिन्दीالعربية
En esta página

Glosario

Admisión

La decisión de reenviar una petición al origen. En Sibuna la toma una sesión válida, una regla ALLOW, una ruta estática exenta o un prefijo de reputación allow, y nunca anula una denegación del WAF.

Autómata Aho-Corasick

Un autómata finito que encuentra cualquiera de un conjunto fijo de patrones en una sola pasada sobre la entrada. Sibuna integra los enlaces de fallo en una tabla de transiciones densa, de modo que cada byte cuesta una carga de la tabla.

Tabla de bloqueos

4.096 posiciones sin cerrojos (lock-free) de direcciones de clientes bloqueadas, con caducidad; las escriben el honeypot y la reputación compartida en un clúster, y se leen en cada petición.

Campaña

Un grupo de incidentes de seguridad cuyos embeddings de carga útil están a una distancia coseno de 0,35 o menos entre sí; una agrupación heurística, no una prueba de origen común.

Registro de desafío

El identificador sin estado de 70 caracteres que un cliente debe resolver: versión, algoritmo, dificultad, aperturas, hora de emisión, huella del cliente, nonce PRF, hash de regla y una etiqueta BLAKE3 con clave de 16 bytes. Emitir uno no escribe nada en el servidor.

Dificultad, bits de trabajo

El único entero que escala ambos niveles: el número de bits iniciales a cero para Hashcash, o tres más que la profundidad del árbol para el trabajo secuencial.

Edge

Un despliegue de Sibuna con --data-dir (un archivo SQLite en un nodo), o con --database-url y --cluster-node (una base de datos PostgreSQL compartida por un clúster), que aporta políticas persistentes, reputación compartida y análisis forense de incidentes a cualquiera de los dos modos de protección.

Espacio del motor

El lugar donde vive el motor de políticas publicado, como un puntero con recuento de referencias. Los workers mantienen una referencia mientras clasifican; el hilo de almacenamiento construye un motor nuevo fuera del camino de la petición y lo publica intercambiando el puntero, y el motor antiguo se libera cuando su último lector lo libera.

Huella

Un hash con clave de la dirección del cliente y del User-Agent, vinculado a los desafíos y los tokens para que ninguno pueda reutilizarse desde otro cliente.

Forward auth

Modo de despliegue en el que un proxy de entrada pregunta a Sibuna si debe admitir una petición (200) o desafiarla, denegarla o limitarla (401, 403, 429), y hace él mismo de proxy hacia el origen.

Gate

El modo de protección con admisión por prueba de trabajo, sesiones, reglas, reputación, límites GCRA y bloqueos, pero sin inspección de aplicaciones (--gate).

GCRA

El Generic Cell Rate Algorithm: un tiempo teórico de llegada por cliente que admite una ráfaga de \(N\) y después una petición por intervalo de emisión, sin fronteras entre ventanas.

Hashcash

Primer nivel: encontrar un nonce tal que el SHA-256 del desafío, dos puntos y el nonce decimal tenga \(b\) bits iniciales a cero. Se esperan \(2^b\) intentos, y se verifica con un hash.

Honeypot

Un enlace invisible a /__sibuna/honeypot; un cliente que lo sigue queda bloqueado y se registra un incidente con reputación \(-100\).

Recolector de conexiones inactivas

Un hilo que cierra las conexiones que llevan en silencio más de --idle-timeout, para que un cliente lento no pueda acaparar un hilo de conexión.

Página intermedia

La página HTML integrada que se sirve en lugar de una página protegida; obtiene un desafío, lo resuelve en un Web Worker, envía la solución y recarga.

JA4

Una huella de 36 caracteres, definida por FoxIO, de cómo abre un cliente una conexión TLS: protocolo, versión de TLS, nombre de servidor, número de cifrados y de extensiones, ALPN, y los hashes de las suites de cifrado y de las extensiones, ordenadas. Sibuna no la calcula; lee el valor que un proxy de entrada de confianza reenvía en la cabecera nombrada por --ja4-header, y las reglas la comparan con el campo ja4 (SID 0014). No tiene relación con la huella del cliente vinculada a los desafíos y los tokens.

BLAKE3 con clave

La función pseudoaleatoria en la que se basan la derivación de claves de Sibuna, las etiquetas de desafíos, las etiquetas de sesión, las huellas y los nonces de los desafíos.

Token MAC

La cookie de sesión por defecto: una carga útil de 40 bytes (versión, nivel de trabajo, marca de tiempo, caducidad, hash de regla, huella) y una etiqueta BLAKE3 con clave de 16 bytes, verificada en tiempo constante.

Nivel de trabajo

El mecanismo y los bits de trabajo que el titular de una sesión resolvió realmente, guardados en el token; una ruta admite una sesión solo cuando su nivel alcanza el requisito de la ruta.

Apertura

En una prueba de trabajo secuencial, la etiqueta de una hoja más las etiquetas hermanas a lo largo de su camino hasta la raíz; el verificador recalcula el camino y lo compara con el compromiso.

Prueba de trabajo secuencial (Proof of Sequential Work, PoSW)

Segundo nivel: el grafo de hashes de Cohen-Pietrzak cuyas etiquetas dependen de todas las etiquetas anteriores, lo que obliga a calcular \(2^{n+1}-1\) hashes secuenciales con independencia de cuántos núcleos tenga el probador. Se verifica con \(t(n+1)\) hashes.

Trie de reputación

El trie radix de 128 bits que contiene los prefijos allow, deny y challenge del archivo de políticas y de la tabla ip_reputation.

Conjunto Robin Hood de desafíos gastados

La tabla de direccionamiento abierto y capacidad fija con las etiquetas de los desafíos resueltos, que impide enviar dos veces una solución válida.

Hash de regla

Un hash de 64 bits del nombre de la regla que exigió un desafío; viaja en el desafío, en el token y en la cabecera X-Sibuna-Rule-Hash.

Shield

El modo de protección por defecto: Gate más el cortafuegos semántico (--shield).

SID

Un registro Sibuna Discussion: un documento de diseño con formato de artículo en docs/sid/records que recoge los supuestos, las demostraciones y las mediciones de una parte del sistema.

Modo de protección

Una de las dos formas del producto, Gate o Shield; el almacenamiento y el clúster son opcionales en ambas.

WEIGH

Una acción de regla que suma un peso con signo a la puntuación de una petición en lugar de decidir; los totales iguales o superiores a los umbrales desafían con bits de trabajo adicionales o deniegan.

Zaxonlite

El motor integrado de replicación de SQLite (Multi-Paxos) del SID 0005, sustituido por el almacenamiento en SQLite y PostgreSQL en el SID 0011; sus opciones de clúster ahora detienen el arranque con RemovedOption.

Bibliografía

  • Aho, A. V. y Corasick, M. J. "Efficient string matching: an aid to bibliographic search." Communications of the ACM 18(6), 1975.
  • ATM Forum. Traffic Management Specification Version 4.0, af-tm-0056.000, 1996 (el Generic Cell Rate Algorithm).
  • Back, A. "Hashcash: a denial of service counter-measure." Informe técnico, 2002.
  • Blocki, J., Lee, S. y Zhou, S. "On the security of proofs of sequential work in a post-quantum world." Information-Theoretic Cryptography (ITC), 2021.
  • Celis, P. Robin Hood Hashing. Tesis doctoral, University of Waterloo, 1986.
  • Cohen, B. y Pietrzak, K. "Simple proofs of sequential work." EUROCRYPT, 2018.
  • Dwork, C. y Naor, M. "Pricing via processing or combatting junk mail." CRYPTO, 1992.
  • Fiat, A. y Shamir, A. "How to prove yourself: practical solutions to identification and signature problems." CRYPTO, 1986.
  • Fielding, R., Nottingham, M. y Reschke, J. HTTP Semantics, RFC 9110, y HTTP/1.1, RFC 9112. IETF, 2022.
  • FoxIO. JA4+ Network Fingerprinting. https://github.com/FoxIO-LLC/ja4, 2023 (la huella de cliente TLS JA4).
  • Hanson, N. «libinjection: SQL injection detection by tokenization.» Black Hat USA, 2012.
  • Juels, A. y Brainard, J. "Client puzzles: a cryptographic countermeasure against connection depletion attacks." NDSS, 1999.
  • Lamport, L. "The part-time parliament." ACM Transactions on Computer Systems 16(2), 1998; y "Paxos made simple." ACM SIGACT News 32(4), 2001.
  • Mahmoody, M., Moran, T. y Vadhan, S. "Publicly verifiable proofs of sequential work." Innovations in Theoretical Computer Science (ITCS), 2013.
  • O'Connor, J., Aumasson, J.-P., Neves, S. y Wilcox-O'Hearn, Z. BLAKE3: one function, fast everywhere. Especificación, 2020.
  • Vyukov, D. "Bounded MPMC queue." 1024cores.net, 2011 (el anillo con números de secuencia usado para la cola de incidentes).
  • Wang, X., Hong, Y., Chang, H., Park, K., Langdale, G., Hu, J. y Zhu, H. "Hyperscan: a fast multi-pattern regex matcher for modern CPUs." NSDI, 2019.
  • Sibuna Discussions 0001 a 0014, docs/sid/records, 2026: proceso, arquitectura base, motor declarativo de políticas, inspección semántica, arquitectura de almacenamiento Zaxonlite, fundamentos matemáticos, interfaz de gestión de la consola, monitorización del tráfico de bots de IA, cuerpos de petición chunked, la migración a Rust, el almacenamiento mediante sqlx, TLS saliente para la consola mediante rustls, el almacenamiento de la consola y las huellas JA4 de confianza desde el proxy de entrada.