Das Sibuna-Handbuch 1.0.0-beta.3 Dokumentation
Sprache: Deutsch
English简体中文한국어日本語EspañolDeutschहिन्दीالعربية
Auf dieser Seite

Glossar

Zulassung

Die Entscheidung, eine Anfrage an den Ursprungsserver weiterzuleiten. In Sibuna wird sie durch eine gültige Sitzung, eine ALLOW-Regel, einen statischen Bypass-Pfad oder ein allow-Präfix der Reputation getroffen, und sie hebt nie eine WAF-Ablehnung auf.

Aho-Corasick-Automat

Ein endlicher Automat, der jedes Muster aus einer festen Menge in einem Durchlauf über die Eingabe findet. Sibuna faltet die Fehlerkanten in eine dichte Übergangstabelle, sodass jedes Byte einen Tabellenzugriff kostet.

Sperrtabelle

4.096 sperrfreie Slots gesperrter Clientadressen mit Ablaufzeit, geschrieben vom Honeypot und von der im Cluster gemeinsam genutzten Reputation, gelesen bei jeder Anfrage.

Kampagne

Eine Gruppe von Sicherheitsvorfällen, deren Nutzlast-Embeddings höchstens den Cosinus-Abstand 0,35 voneinander haben; eine heuristische Gruppierung, kein Beweis gemeinsamer Herkunft.

Challenge-Datensatz

Die 70 Zeichen lange zustandslose Kennung, die ein Client lösen muss: Version, Algorithmus, Schwierigkeit, Öffnungen, Ausgabezeit, Fingerabdruck des Clients, PRF-Nonce, Regelhash und ein 16-Byte-Tag aus BLAKE3 mit Schlüssel. Ihr Ausstellen schreibt nichts auf dem Server.

Schwierigkeit, Arbeitsbits

Die eine Ganzzahl, die beide Stufen skaliert: die Zahl führender Nullbits bei Hashcash oder drei mehr als die Baumtiefe bei sequenzieller Arbeit.

Edge

Ein Sibuna-Einsatz mit --data-dir (eine SQLite-Datei auf einem Knoten) oder mit --database-url und --cluster-node (eine gemeinsame PostgreSQL-Datenbank für einen Cluster), der beiden Betriebsformen persistente Richtlinien, gemeinsame Reputation und Vorfallsforensik gibt.

Engine-Slot

Der Ort, an dem die veröffentlichte Richtlinien-Engine als referenzgezählter Zeiger liegt. Worker halten beim Klassifizieren eine Referenz; der Speicherthread baut eine neue Engine abseits des Anfragepfads und veröffentlicht sie per Zeigertausch, und die alte Engine wird freigegeben, wenn ihr letzter Leser sie loslässt.

Fingerabdruck

Ein schlüsselbasierter Hash von Clientadresse und User-Agent, in Challenges und Tokens gebunden, sodass keines von beiden von einem anderen Client wiederverwendet werden kann.

Forward-Auth

Einsatzmodus, in dem ein Eingangsproxy Sibuna fragt, ob eine Anfrage zugelassen (200) oder mit einer Challenge belegt, abgelehnt oder begrenzt werden soll (401, 403, 429), und die Anfrage selbst an den Ursprungsserver weiterleitet.

Gate

Die Betriebsform mit Proof-of-Work-Zulassung, Sitzungen, Regeln, Reputation, GCRA-Limits und Sperren, aber ohne Anwendungsprüfung (--gate).

GCRA

Der Generic Cell Rate Algorithm: eine theoretische Ankunftszeit pro Client, die einen Burst von \(N\) und danach eine Anfrage pro Emissionsintervall zulässt, ohne Fenstergrenzen.

Hashcash

Stufe eins: eine Nonce finden, sodass SHA-256 über die Challenge, einen Doppelpunkt und die dezimale Nonce \(b\) führende Nullbits hat. Im Erwartungswert \(2^b\) Versuche, verifiziert mit einem einzigen Hash.

Honeypot

Ein unsichtbarer Link zu /__sibuna/honeypot; ein Client, der ihm folgt, wird gesperrt, und ein Vorfall mit der Reputation \(-100\) wird aufgezeichnet.

Idle-Reaper

Ein Thread, der Verbindungen schließt, die länger als --idle-timeout inaktiv waren, sodass ein langsamer Client keinen Verbindungsthread blockieren kann.

Zwischenseite

Die eingebettete HTML-Seite, die anstelle einer geschützten Seite ausgeliefert wird; sie holt eine Challenge, löst sie in einem Web Worker, sendet die Lösung und lädt neu.

JA4

Ein von FoxIO definierter Fingerabdruck aus 36 Zeichen dafür, wie ein Client eine TLS-Verbindung öffnet: Protokoll, TLS-Version, Servername, Anzahl der Cipher Suites und Erweiterungen, ALPN sowie Hashes der sortierten Cipher Suites und Erweiterungen. Sibuna berechnet ihn nicht; es liest den Wert, den ein vertrauenswürdiger Eingangsproxy in dem mit --ja4-header benannten Header weiterleitet, und Regeln gleichen ihn mit dem Feld ja4 ab (SID 0014). Er hat nichts mit dem Fingerabdruck des Clients zu tun, der in Challenges und Tokens gebunden ist.

BLAKE3 mit Schlüssel

Die Pseudozufallsfunktion hinter Sibunas Schlüsselplan, den Challenge-Tags, Sitzungstags, Fingerabdrücken und Challenge-Nonces.

MAC-Token

Das Standard-Sitzungscookie: eine 40-Byte-Nutzlast (Version, Arbeitsstufe, Zeitstempel, Ablauf, Regelhash, Fingerabdruck) und ein 16-Byte-Tag aus BLAKE3 mit Schlüssel, verifiziert in konstanter Zeit.

Arbeitsstufe

Das Verfahren und die Arbeitsbits, die der Inhaber einer Sitzung tatsächlich gelöst hat, getragen im Token; eine Route lässt eine Sitzung nur zu, wenn deren Stufe die Anforderung der Route erreicht.

Öffnung

In einem Nachweis sequenzieller Arbeit ein Blattlabel plus die Geschwisterlabels entlang seines Pfads zur Wurzel; der Verifizierer berechnet den Pfad neu und vergleicht mit dem Commitment.

Proof of Sequential Work (PoSW)

Stufe zwei: der Hash-Graph nach Cohen-Pietrzak, dessen Labels von allen früheren Labels abhängen. Er erzwingt \(2^{n+1}-1\) sequenzielle Hashes, unabhängig davon, wie viele Kerne der Beweiser hat. Verifiziert mit \(t(n+1)\) Hashes.

Reputations-Trie

Der 128-Bit-Radix-Trie mit allow-, deny- und challenge-Präfixen aus der Richtliniendatei und aus der Tabelle ip_reputation.

Robin-Hood-Verbrauchsmenge

Die Open-Addressing-Tabelle fester Kapazität für gelöste Challenge-Tags, die verhindert, dass eine gültige Lösung zweimal eingereicht wird.

Regelhash

Ein 64-Bit-Hash des Namens der Regel, die eine Challenge verlangt hat, getragen in der Challenge, im Token und im Header X-Sibuna-Rule-Hash.

Shield

Die Standard-Betriebsform: Gate plus die semantische Firewall (--shield).

SID

Ein Sibuna-Discussion-Dokument: ein Entwurfsdokument im Stil eines Fachartikels unter docs/sid/records mit den Annahmen, Beweisen und Messungen hinter einem Teil des Systems.

Betriebsform

Eine der beiden Produktformen, Gate oder Shield; Speicherung und Clusterbildung sind für beide optional.

WEIGH

Eine Regelaktion, die einen vorzeichenbehafteten Wert zur Bewertung einer Anfrage addiert, statt zu entscheiden; Summen an oder über den Schwellen führen zu einer Challenge mit zusätzlichen Arbeitsbits oder zur Ablehnung.

Zaxonlite

Die eingebettete SQLite-Replikations-Engine (Multi-Paxos) aus SID 0005, in SID 0011 durch Speicherung in SQLite und PostgreSQL ersetzt; ihre Cluster-Optionen brechen den Start jetzt mit RemovedOption ab.

Literaturverzeichnis

  • Aho, A. V., und 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 (der Generic Cell Rate Algorithm).
  • Back, A. „Hashcash: a denial of service counter-measure.“ Technischer Bericht, 2002.
  • Blocki, J., Lee, S., und 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. Dissertation, University of Waterloo, 1986.
  • Cohen, B., und Pietrzak, K. „Simple proofs of sequential work.“ EUROCRYPT, 2018.
  • Dwork, C., und Naor, M. „Pricing via processing or combatting junk mail.“ CRYPTO, 1992.
  • Fiat, A., und Shamir, A. „How to prove yourself: practical solutions to identification and signature problems.“ CRYPTO, 1986.
  • Fielding, R., Nottingham, M., und Reschke, J. HTTP Semantics, RFC 9110, und HTTP/1.1, RFC 9112. IETF, 2022.
  • FoxIO. JA4+ Network Fingerprinting. https://github.com/FoxIO-LLC/ja4, 2023 (der JA4-Fingerabdruck von TLS-Clients).
  • Hanson, N. „libinjection: SQL injection detection by tokenization.“ Black Hat USA, 2012.
  • Juels, A., und 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; und „Paxos made simple.“ ACM SIGACT News 32(4), 2001.
  • Mahmoody, M., Moran, T., und Vadhan, S. „Publicly verifiable proofs of sequential work.“ Innovations in Theoretical Computer Science (ITCS), 2013.
  • O'Connor, J., Aumasson, J.-P., Neves, S., und Wilcox-O'Hearn, Z. BLAKE3: one function, fast everywhere. Spezifikation, 2020.
  • Vyukov, D. „Bounded MPMC queue.“ 1024cores.net, 2011 (der sequenzmarkierte Ring der Vorfallswarteschlange).
  • Wang, X., Hong, Y., Chang, H., Park, K., Langdale, G., Hu, J., und Zhu, H. „Hyperscan: a fast multi-pattern regex matcher for modern CPUs.“ NSDI, 2019.
  • Sibuna Discussions 0001 bis 0014, docs/sid/records, 2026: Prozess, Grundarchitektur, deklarative Richtlinien-Engine, semantische Prüfung, Speicherarchitektur von Zaxonlite, mathematische Grundlagen, Verwaltungsoberfläche der Konsole, Überwachung des Datenverkehrs von KI-Bots, Chunked-Request-Bodies, die Portierung nach Rust, Speicherung über sqlx, ausgehendes TLS für die Konsole über rustls, Konsolenspeicher und vertrauenswürdige JA4-Fingerabdrücke vom Eingangsproxy.