序文¶
リクエストは、メソッド、パス、いくつかのヘッダー、そしてサーバーの処理を求める要求を携えて届きます。これらのバイトのどれも、そのリクエストに応える価値があることを示しません。Sibunaはリクエストとオリジンの間に一つの判断を置きます。許可するか、拒否するか、送信者に検証可能な作業を求めるかです。本書はこの判断を、数学的なモデルからメモリ上のバイトまで追います。
このシステムには二つの運用構成があります。Gateは作業証明による許可と、ローカルの大量アクセス対策を提供します。Shieldはアプリケーションの検査とポリシーによる判断を加えます。どちらも、ポリシー、レピュテーション、インシデント履歴のために永続ストレージを使えます。ストレージは一つのノードに置くことも、クラスターで共有することもできます。このデプロイをEdgeと呼びます。有効なセッションは許可を確立しますが、リクエストを検査から免除するわけではありません。永続的な状態をクラスターで共有すれば状態は分散されますが、ローカルのレートカウンターがクラスター全体のクォータに変わるわけではありません。
工学上の中心的な問いは、ハッシュが速いかどうかではありません。信頼できないクライアントが入力を選ぶときに、処理経路全体が有界であり続けるかどうかです。パーサーは何バイトまで検査できるでしょうか。チャレンジはどれだけのメモリを消費し得るでしょうか。クライアントはいくつの接続を開いたままにできるでしょうか。どの書き込みなら再試行してよいでしょうか。ノードやデータベースが消えた後に、何が利用できるでしょうか。どの答えも、不変条件とその境界の両方を示さなければなりません。
数学も同じ目的に役立ちます。期待コストはレイテンシーの保証ではありません。固定したコミットメントに対するサンプリングの議論は、あらゆる適応的な証明者に対する証明ではありません。キューはバーストを吸収しますが、恒常的に遅い消費側を補うことはできません。本書では小さなモデルを導き、例題を手で解き、そのうえで実装がモデルからどこで離れるかを問います。
本書は三通りに使えるように書いています。順に読めば、第I部から第VII部は一続きの講座になっています。各章は、読み終えたときにできるようになることを最初に示し、例題を手で解き、演習と、自分の言葉で説明する不変条件で締めくくります。抜粋した解答例を巻末に載せています。第VIII部から第X部はリファレンスです。出所を明記した測定、すべてのフラグと構成、すべてのエンドポイント、ステータス、エラー、テーブルを扱います。第XI部はターミナルのそばに置く2ページの早見表です。最後に用語集と参考文献があります。
第II部では、SibunaをAnubis、SafeLine、Cloudflare WAFと機能ごとに比較します。第VIII部では、単一のプリミティブから製品全体の実行までSibuna自身の測定を示し、同じ負荷生成器の下で製品全体としてSibunaとAnubisを比較します。どちらも読者が主張を確かめられるように書いています。比較はその出典を示し、どの測定も、値を写したコミット済みの結果ファイルを示します。
読者には、プログラミングの基礎、対数、条件付き確率の知識を想定しています。Rustは、言語の概観ではなく、所有権とデータ配置を通して紹介します。各章は順に読めます。コストモデルがプロトコルの動機となり、プロトコルが状態を決め、状態が並行処理とストレージの設計を決めます。後の章では、これらの不変条件を測定と運用手順に落とし込みます。
本書は実装の本です。計算パズルが自動化されたトラフィックをなくすと主張するものではありません。クライアントは計算資源を買えますし、アドレスは共有され得ますし、アプリケーションの構文は上限のある検出器よりも豊かです。本書が目指すのは、コストと限界をスローガンの陰に隠さず、調べ、テストし、変更できるシステムです。
Sibuna 1.0.0-beta.3対応版、2026年11月
ソース、演習、再現可能な測定はSibunaリポジトリにあります。