Skip to content

Releases

jt-waf-mgr 0.4.89

Choose a tag to compare

@jasoncheng7115 jasoncheng7115 released this 17 Nov 17:22

Verify before installing:

sha256sum -c jt-waf-mgr-0.4.89.tar.gz.sha256
openssl dgst -sha256 -verify release-key.pem -signature jt-waf-mgr-0.4.89.tar.gz.sig jt-waf-mgr-0.4.89.tar.gz

SHA-256 976c286d790cdd9d34df1fafe4985a45873bca4e5f5b7130da5361edfa7b4db7

English

  • nginx updates, approved by an admin: once a module passed with the next nginx, the nginx updates page proposes the update as a change; approving it takes an admin's one-time code and a note. The apply program checks again as root: the module's SHA-256, both the new and the current package against the SHA-256 in apt's signed index (files the service user downloaded are not trusted for themselves), and the module once more with the new nginx. A dedicated unit, jt-waf-mgr-nginxswap (no network), then puts the module in place, installs the package with dpkg -i and upgrades nginx live (no interruption); the new master must run the new program, nginx -t must pass and the health URLs must answer as before, else the previous module and package go back. nginx is held again afterwards.
  • Finishing an interrupted update: when nginx was updated and the module left behind (the old program still running, nginx -t failing, the next restart would fail), upload a module for the installed nginx; once it passes, propose finishing the update (module in place, live upgrade).
  • Hold nginx button (apt-mark hold by the apply program).
  • A module is used only once root trusts it: done by itself when the build script runs as root on the host; for a module built elsewhere, put the file on the host and run sudo jt-waf-mgr nginx-module-trust FILE --sha256 <SHA-256 from the build output>. Root copies the module into its own directory, checks the SHA-256 and uses only that copy for the update; root's re-test of the module runs as nobody.
  • Only a single nginx package is supported (nginx.org packages); with packaged modules, or an nginx that needs other packages of the same version (Debian's nginx-common), the page shows packaging not supported.
  • build-modsecurity-module.sh takes a package version (such as 1.30.7-1~bookworm).

繁體中文

  • nginx 更新 (經管理者核准):「nginx 更新」頁在新版模組驗證通過後可提出更新變更,核准要管理者的一次性密碼與說明。套用程式以 root 重新驗證:模組 SHA-256、新舊兩個套件都要符合 apt 簽章索引的 SHA-256 (服務使用者下載的檔案不直接信任)、再用新 nginx 試一次模組;接著由專用單元 jt-waf-mgr-nginxswap (沒有網路) 換上模組、dpkg -i 安裝並熱升級 (不中斷),確認新 master 跑的是新程式、nginx -t 通過、健康檢查網址與更新前相同;任何一步失敗就換回原本的模組與套件。完成後重新鎖定 nginx。
  • 完成中斷的更新:nginx 已被更新但模組沒跟上時 (舊程式還在跑、nginx -t 失敗、下次重新啟動就會失敗),上傳給已安裝 nginx 的模組,驗證後可提出「完成更新」(換上模組並熱升級)。
  • 「鎖定 nginx 版本」按鈕 (由套用程式執行 apt-mark hold)。
  • 模組要經 root 信任才會被使用:在主機上以 root 執行編譯腳本時自動信任;在別台編譯時,把檔案放到主機後執行 sudo jt-waf-mgr nginx-module-trust 檔案 --sha256 <編譯輸出的 SHA-256>。root 會把模組複製到自己的目錄並核對 SHA-256,更新時只用這份複本;root 重新試模組時以 nobody 身分執行。
  • 只支援單一 nginx 套件 (nginx.org 套件);有套件提供的模組、或 nginx 需要同版本的其他套件 (Debian 的 nginx-common) 時顯示「此套件組合不支援」。
  • build-modsecurity-module.sh 可直接指定套件版本 (例如 1.30.7-1~bookworm)。

日本語

  • nginx の更新 (管理者の承認):次の nginx でモジュールの検証に通ると、「nginx の更新」ページから更新を変更として提案できます。承認には管理者のワンタイムコードと説明が必要です。適用プログラムが root で再検証します:モジュールの SHA-256、新旧両方のパッケージを apt の署名付きインデックスの SHA-256 と照合 (サービスユーザーがダウンロードしたファイルをそのまま信用しない)、新しい nginx でもう一度モジュールを試験。その後、専用ユニット jt-waf-mgr-nginxswap (ネットワークなし) がモジュールを配置し、dpkg -i でインストールしてライブアップグレード (中断なし) します。新しい master が新しいプログラムで動き、nginx -t が通り、ヘルスチェック URL が更新前と同じであることを確認し、どこかで失敗すれば元のモジュールとパッケージに戻します。その後 nginx を再び固定します。
  • 中断された更新の完了:nginx が更新されモジュールが追いついていない場合 (古いプログラムが動いたまま、nginx -t が失敗、次の再起動で失敗)、インストール済み nginx 用のモジュールをアップロードし、検証に通れば「更新の完了」を提案できます (モジュール配置とライブアップグレード)。
  • 「nginx のバージョンを固定」ボタン (適用プログラムが apt-mark hold を実行)。
  • モジュールは root が信頼して初めて使われます:ホストで root としてビルドスクリプトを実行すれば自動、別のホストでビルドした場合はファイルをホストに置いて sudo jt-waf-mgr nginx-module-trust ファイル --sha256 <ビルド出力の SHA-256> を実行します。root はモジュールを自分のディレクトリにコピーして SHA-256 を照合し、更新にはそのコピーだけを使います。root によるモジュールの再試験は nobody で実行します。
  • 対応するのは単一の nginx パッケージ (nginx.org のパッケージ) です。パッケージ提供のモジュールがある場合や、nginx が同じバージョンの別パッケージを必要とする場合 (Debian の nginx-common) は「このパッケージ構成は非対応」と表示します。
  • build-modsecurity-module.sh にパッケージのバージョンを指定できます (例:1.30.7-1~bookworm)。

jt-waf-mgr 0.4.88

Choose a tag to compare

@jasoncheng7115 jasoncheng7115 released this 17 Nov 15:53

Verify before installing:

sha256sum -c jt-waf-mgr-0.4.88.tar.gz.sha256
openssl dgst -sha256 -verify release-key.pem -signature jt-waf-mgr-0.4.88.tar.gz.sig jt-waf-mgr-0.4.88.tar.gz

SHA-256 aa0c0757ede7a4dd8604864f15bd84ed6b31042c77a71d5712f6e853e97f548a

English

  • nginx updates verified before they happen (new page Admin → nginx updates): when a newer nginx is available and the ModSecurity module is built by hand, a separate background job (jt-waf-mgr-nginxup, daily or on request) downloads the new nginx package (not installed), unpacks it, loads the waiting new module into that nginx on a local port and checks that a test request is refused (403) and an ordinary one passes (200); only then it shows ready to update. Packaged modules are tried at their new versions too; other modules built by hand are reported.
  • The new module is uploaded by an admin (in parts; SHA-256, ELF format and the module.json description are checked). The release includes deploy/build-modsecurity-module.sh, which builds only the module (seconds) on the same system: nginx from the repository's source package, the ModSecurity-nginx connector pinned by version and SHA-256.
  • The health check nginx_module adds update_ready.
  • Rules page: CrowdSec virtual patching rules are listed on the CrowdSec page until one is applied.
  • Next: holding nginx and an approved nginx update (only with a verified module, live upgrade, automatic rollback).

繁體中文

  • nginx 更新前先驗證 WAF 模組 (新頁面「管理 → nginx 更新」):系統有新版 nginx、而 ModSecurity 模組是手動編譯時,獨立的背景工作 (jt-waf-mgr-nginxup,每天一次,也可立即檢查) 會下載新版 nginx 套件 (不安裝)、解開後用它實際載入等待中的新模組,在本機連接埠送測試請求,確認會封鎖 (403) 且一般請求正常 (200) 才標示「可以更新」。套件提供的模組會一起取新版試;還有其他手動編譯模組時會提示。
  • 新版模組由管理者上傳 (分段送出,檢查 SHA-256 與 ELF 格式、與 module.json 的描述一致);發行檔附 deploy/build-modsecurity-module.sh,在相同系統上只編模組 (數秒),nginx 原始碼取自套件庫的原始碼套件,ModSecurity-nginx 連接器固定版本與 SHA-256。
  • health 的 nginx_module 檢查多 update_ready。
  • 規則頁說明:CrowdSec 虛擬修補規則套用前只在 CrowdSec 頁檢視。
  • 下一版:鎖定 nginx、經核准的 nginx 更新 (只用驗證通過的模組、熱升級、失敗自動還原)。

日本語

  • nginx 更新前の WAF モジュール検証 (新ページ「管理 → nginx の更新」):新しい nginx があり、ModSecurity モジュールが手動ビルドの場合、独立したバックグラウンドジョブ (jt-waf-mgr-nginxup、毎日または依頼時) が新しい nginx パッケージをダウンロード (インストールしない) して展開し、待機中の新モジュールをその nginx で実際に読み込み、ローカルポートでテストリクエストが拒否 (403) され通常のリクエストが通る (200) ことを確認してから「更新できます」と表示します。パッケージのモジュールも新しい版で試し、他の手動ビルドモジュールがあれば知らせます。
  • 新しいモジュールは管理者がアップロードします (分割送信、SHA-256・ELF 形式・module.json の記述を照合)。リリースに deploy/build-modsecurity-module.sh を同梱し、同じシステムでモジュールだけを数秒でビルドします (nginx はリポジトリのソースパッケージ、ModSecurity-nginx コネクタはバージョンと SHA-256 を固定)。
  • health の nginx_module に update_ready を追加。
  • ルールページ:CrowdSec 仮想パッチルールは適用されるまで CrowdSec ページだけに表示されることを説明。
  • 次の版:nginx の固定と、承認を経た nginx 更新 (検証済みモジュールのみ、ライブアップグレード、失敗時の自動復元)。

jt-waf-mgr 0.4.87

Choose a tag to compare

@jasoncheng7115 jasoncheng7115 released this 17 Nov 15:26

Verify before installing:

sha256sum -c jt-waf-mgr-0.4.87.tar.gz.sha256
openssl dgst -sha256 -verify release-key.pem -signature jt-waf-mgr-0.4.87.tar.gz.sig jt-waf-mgr-0.4.87.tar.gz

SHA-256 e3471582fdf167aec8c2b5fe2c258eef9e29a8855e6f2bc99f88bf35fc5b44aa

English

  • CrowdSec virtual patching rules: the rule column is wide enough for the names; "this site's software" compares only the rule's product and name, no longer the description that may mention other software in passing (a Wing FTP rule that mentions Lua).
  • CRS: without gpg on the host the error says to apt install gpg, and the system check warns (no CRS release signature can be checked without it).

繁體中文

  • CrowdSec 虛擬修補規則:規則欄給足寬度,名稱不再逐段換行;「本站軟體」只比對規則的產品名稱與規則名稱,不再因說明順帶提到其他軟體而誤配 (例如提到 Lua 的 Wing FTP 規則)。
  • CRS:主機沒有安裝 gpg 時,錯誤訊息直接說明要 apt install gpg,系統檢查也會提醒 (沒有 gpg 就無法驗證任何 CRS 發行檔的簽章)。

日本語

  • CrowdSec 仮想パッチルール:ルール列の幅を確保し、名前が細かく折り返さないようにしました。「本サイトのソフトウェア」はルールの製品名とルール名だけで照合し、説明で触れているだけの別のソフトウェアに誤って一致しないようにしました (Lua に触れている Wing FTP のルールなど)。
  • CRS:ホストに gpg がない場合、エラーで apt install gpg が必要と説明し、システムチェックでも警告します (gpg がないと CRS リリースの署名を検証できません)。

jt-waf-mgr 0.4.86

Choose a tag to compare

@jasoncheng7115 jasoncheng7115 released this 17 Nov 14:56

Verify before installing:

sha256sum -c jt-waf-mgr-0.4.86.tar.gz.sha256
openssl dgst -sha256 -verify release-key.pem -signature jt-waf-mgr-0.4.86.tar.gz.sig jt-waf-mgr-0.4.86.tar.gz

SHA-256 3cae154b01969777ffab371315aebc657f4ef30eef1f17f9812b99f48b5a2e20

English

  • Sandbox: in the ModSecurity files copied into the sandbox (the main file, files whose audit log settings are rewritten), settings that name another file by a relative path (SecUnicodeMapFile unicode.mapping 20127, Include, SecGeoLookupDb, and the data files of @pmFromFile / @ipMatchFromFile) were looked up in the sandbox directory and failed; they are now made absolute against the directory of the original file, with no change to the configuration. Tested with nginx + ModSecurity on Ubuntu 26.04: the sandbox starts and both rules reading relative data files refuse as they should. (GitHub issue #1)

繁體中文

  • 沙箱:複製到沙箱的 ModSecurity 設定檔 (主設定檔、要改寫稽核記錄位置的檔案) 裡,用相對路徑指到其他檔案的設定 (SecUnicodeMapFile unicode.mapping 20127、Include、SecGeoLookupDb,以及 @pmFromFile、@ipMatchFromFile 讀的資料檔) 會被解析到沙箱目錄而失敗;現在一律換成相對於原設定檔所在目錄的絕對路徑,原本的設定不用動。用 Ubuntu 26.04 的 nginx+ModSecurity 實測:沙箱可以啟動,兩條讀相對資料檔的規則都正確封鎖。(GitHub issue #1)

日本語

  • サンドボックス:サンドボックスにコピーする ModSecurity 設定ファイル (メインファイル、監査記録の設定を書き換えるファイル) の中で、相対パスで別のファイルを指す設定 (SecUnicodeMapFile unicode.mapping 20127、Include、SecGeoLookupDb、@pmFromFile / @ipMatchFromFile が読むデータファイル) がサンドボックスのディレクトリで探されて失敗していました。元の設定ファイルのディレクトリを基準に絶対パスに変換するようにしました。設定の変更は不要です。Ubuntu 26.04 の nginx+ModSecurity で、サンドボックスが起動し、相対パスのデータファイルを読む 2 つのルールが正しくブロックすることを確認しました。(GitHub issue #1)

jt-waf-mgr 0.4.85

Choose a tag to compare

@jasoncheng7115 jasoncheng7115 released this 17 Nov 14:41

Verify before installing:

sha256sum -c jt-waf-mgr-0.4.85.tar.gz.sha256
openssl dgst -sha256 -verify release-key.pem -signature jt-waf-mgr-0.4.85.tar.gz.sig jt-waf-mgr-0.4.85.tar.gz

SHA-256 5d800dba9284246955ba99c085ee77310a3a465b77e583e9b336bba4ba50e99e

English

  • nginx and the ModSecurity module (so an nginx update never takes the WAF away):
    • Every 6 hours the production load_module modules are loaded once with a throwaway configuration (nginx -t as the service user, never the production configuration) to see that the installed nginx loads them; a module that does not load is a critical alert.
    • From the package lists apt already has (nothing downloaded): when nginx has a newer version but the ModSecurity module package wants another nginx-abi, or the module is built by hand and nginx is not held, an alert says so with the apt-mark hold way out. Debian / Ubuntu only; elsewhere it says it cannot tell.
    • The system check has "nginx and the ModSecurity module"; the health API has nginx_module (seen by the LibreNMS plugin).
  • CrowdSec virtual patching rules: the page shows a running sync and refreshes by itself; four files at a time (about half a minute for a first sync); a sync started by an upload never reaches the internet while the sync is off; with several uploads waiting the newest is read; a zip's entry count is checked before its directory is read; YAML values starting with "- " are refused; space between the source card's buttons and the fields above.
  • CRS uploads: the upload folder is renamed to a private one first; an upload arriving meanwhile waits for the next run.

繁體中文

  • nginx 與 ModSecurity 模組相容性 (避免 nginx 更新後 WAF 失效):
    • 每 6 小時用暫存設定實際載入一次正式的 load_module 模組 (以服務帳號執行 nginx -t,不碰正式設定),確認目前的 nginx 載得起來;載不起來是嚴重警示。
    • 讀 apt 已有的可更新清單 (不連外):nginx 有新版、但 ModSecurity 模組套件要求的 nginx-abi 對不上,或模組是手動編譯的且 nginx 沒有鎖定時,發警示並寫出 apt-mark hold 的做法。只支援 Debian / Ubuntu,其他系統標示無法判斷。
    • 系統檢查新增「nginx 與 ModSecurity 模組」,健康檢查 API 新增 nginx_module (LibreNMS 外掛會看到)。
  • CrowdSec 虛擬修補規則:同步進行中頁面會顯示「同步中」並自動更新;一次下載四個檔案,第一次同步約半分鐘;上傳觸發的同步在自動同步關閉時不會連外;多個上傳同時在等時取最新的;zip 在讀入目錄前先檢查項目數;YAML 以 - 開頭的值一律拒絕;來源與同步卡片的按鈕與上方欄位留出間距。
  • CRS 上傳:處理時先把上傳資料夾改名成私有資料夾,處理期間的新上傳留給下一次。

日本語

  • nginx と ModSecurity モジュールの互換性 (nginx の更新で WAF が消えないように):
    • 6 時間ごとに本番の load_module モジュールを一時的な設定で 1 回読み込み (サービスアカウントで nginx -t、本番設定には触れません)、インストール済みの nginx が読み込めるかを確認します。読み込めない場合は重大な警告です。
    • apt が持つ更新可能な一覧から (ダウンロードなし):nginx に新しいバージョンがあるのに ModSecurity モジュールのパッケージが求める nginx-abi が合わない場合、またはモジュールが手動ビルドで nginx が固定されていない場合に、apt-mark hold の方法を添えて警告します。Debian / Ubuntu のみ対応で、それ以外は判定できないと表示します。
    • システムチェックに「nginx と ModSecurity モジュール」、ヘルスチェック API に nginx_module を追加しました (LibreNMS プラグインで確認できます)。
  • CrowdSec 仮想パッチルール:同期中はページに表示して自動更新し、4 ファイルずつ取得します (初回の同期は約 30 秒)。アップロードによる同期は自動同期が無効なら外部に接続しません。複数のアップロードが待っている場合は最新のものを読みます。zip は目録を読む前に項目数を確認し、YAML の「- 」で始まる値は拒否します。ソースと同期カードのボタンと上の項目の間隔を空けました。
  • CRS のアップロード:処理の前にアップロードフォルダーを非公開のフォルダーに移し、処理中に届いたアップロードは次回に回します。

jt-waf-mgr 0.4.84

Choose a tag to compare

@jasoncheng7115 jasoncheng7115 released this 17 Nov 14:21

Verify before installing:

sha256sum -c jt-waf-mgr-0.4.84.tar.gz.sha256
openssl dgst -sha256 -verify release-key.pem -signature jt-waf-mgr-0.4.84.tar.gz.sig jt-waf-mgr-0.4.84.tar.gz

SHA-256 69353fbd2c50cd7faec0ffb6195e97de73dcad28cf3b6b80b131bfb4c30717c6

English

  • CrowdSec virtual patching rules (Rules → CrowdSec virtual patches, phase 1: review):
    • The appsec rules and the LICENSE of one commit of crowdsecurity/hub on GitHub (MIT licence, about 0.2 MB) are read and converted into ModSecurity rules on this host, by their own job jt-waf-mgr-hub once a day (switched on in Settings; nothing is fetched again while the commit is the same) or with "Sync now"; the web service never reaches the internet.
    • Only rules whose conditions keep their exact meaning are converted ("and" as a chain, "or" as several rules); the others are listed as "not supported yet" with the reason, and a rule never loses part of its conditions. Of the hub's 243 rules today, 230 convert, all checked with nginx -t on nginx + ModSecurity.
    • Stat tiles, the rules that name this site's software (the confirmed list of threat intelligence), what is new or changed; each rule shows the upstream text and the converted rule. The MIT licence of the same commit is kept and can be shown.
    • A host that cannot reach the internet can upload a hub archive (GitHub's "Download ZIP" or a tar.gz); only appsec-rules and LICENSE are read.
    • Proposing a rule as a change for the sites comes in the next version.
  • Offline CRS: a host that cannot reach GitHub can upload the release and its .asc signature on the CRS page; it is checked against the CRS release key and staged, then compared in the sandbox and approved as usual.
  • Hub rule files are read only by the built-in restricted YAML reader: ambiguous forms, overlong lines and deep nesting are refused, never guessed; every converted line must have a fixed shape, and names and descriptions keep only safe characters.
  • Uploads are sent in parts (the web service and nginx take requests of up to 1 MB) and checked for size and SHA-256; the web service only stores the file, the jobs unpack and verify it.

繁體中文

  • CrowdSec 虛擬修補規則 (規則 → CrowdSec 虛擬修補規則,第一期:檢視):
    • 從 GitHub 的 crowdsecurity/hub (MIT 授權) 取一個 commit 的 appsec 規則與 LICENSE (約 0.2 MB),在本機讀取並轉成 ModSecurity 規則。由獨立的下載服務 jt-waf-mgr-hub 每天一次 (要在設定頁啟用;commit 沒變就不重抓),也可按「立即同步」;網頁服務不連外。
    • 只轉能完整保留原始比對條件的規則 (「且」用串接規則,「或」拆成多條),其他列為「尚不支援轉換」並寫出原因;條件只轉得出一部分的規則整條不轉。目前 hub 的 243 條中 230 條可以轉換,全部在 nginx+ModSecurity 上 nginx -t 驗證過。
    • 頁面有統計卡片、與本站軟體 (威脅情報已確認的清單) 相關的規則、新增或更新的規則;每條可看上游原文與轉出的規則。保存並可顯示同一個 commit 的 MIT 授權全文。
    • 不能連外的主機可上傳 hub 壓縮檔 (GitHub「Download ZIP」或 tar.gz),只讀其中的 appsec-rules 與 LICENSE。
    • 提出成變更並套用到站台在下一版。
  • CRS 離線上傳:不能連到 GitHub 的主機,可在 CRS 頁上傳官方發行檔與 .asc 簽章檔;用 CRS 官方公鑰驗證後暫存,之後照常沙箱比對與核准。
  • hub 規則檔只用內建的受限 YAML 讀取器:有歧義的寫法、過長的行、太深的巢狀一律拒絕,不猜;轉出的每一行都要符合固定格式,名稱與說明只保留安全字元。
  • 上傳一律分段送出 (網頁服務與 nginx 都只收 1 MB 以內的請求),完成時核對大小與 SHA-256;網頁服務只存檔,解開與驗證由各自的下載服務做。

日本語

  • CrowdSec 仮想パッチルール (ルール → CrowdSec 仮想パッチ、第 1 段階:閲覧):
    • GitHub の crowdsecurity/hub (MIT ライセンス) から 1 つの commit の appsec ルールと LICENSE (約 0.2 MB) を取得し、このホストで ModSecurity ルールに変換します。専用のジョブ jt-waf-mgr-hub が 1 日 1 回 (設定で有効化、commit が同じなら再取得しません)、または「今すぐ同期」で実行し、Web サービスは外部に接続しません。
    • 元の一致条件をそのまま保てるルールだけを変換し (「かつ」はチェーン、「または」は複数ルール)、それ以外は「未対応」として理由を示します。条件の一部しか変換できないルールは変換しません。現在 Hub の 243 件のうち 230 件を変換でき、すべて nginx+ModSecurity の nginx -t で確認しました。
    • 統計カード、本サイトのソフトウェア (脅威インテリジェンスの確認済み一覧) に関連するルール、新規・更新されたルールを表示し、各ルールの元の記述と変換後のルールを確認できます。同じ commit の MIT ライセンス全文を保存・表示します。
    • 外部に接続できないホストでは Hub のアーカイブ (GitHub の「Download ZIP」または tar.gz) をアップロードできます。読むのは appsec-rules と LICENSE だけです。
    • 変更として提案しサイトに適用する機能は次のバージョンです。
  • CRS のオフライン更新:GitHub に接続できないホストでは、CRS ページで公式リリースと .asc 署名をアップロードできます。CRS 公式の公開鍵で検証して準備し、その後は通常どおりサンドボックスで比較して承認します。
  • Hub のルールファイルは組み込みの制限付き YAML 読み取り器だけで読みます。あいまいな書き方、長すぎる行、深すぎる入れ子は推測せずに拒否します。変換後の各行は決まった形でなければならず、名前と説明は安全な文字だけを残します。
  • アップロードは分割して送信し (Web サービスと nginx は 1 MB までのリクエストのみ受け付けます)、完了時にサイズと SHA-256 を照合します。Web サービスはファイルを保存するだけで、展開と検証は各ジョブが行います。

jt-waf-mgr 0.4.83

Choose a tag to compare

@jasoncheng7115 jasoncheng7115 released this 17 Nov 13:35

Verify before installing:

sha256sum -c jt-waf-mgr-0.4.83.tar.gz.sha256
openssl dgst -sha256 -verify release-key.pem -signature jt-waf-mgr-0.4.83.tar.gz.sig jt-waf-mgr-0.4.83.tar.gz

SHA-256 d84edd5b47313a6a9b25d5d0422fff59171dda8cbd011a49800c414335371162

English

  • Health API: an engine set to detection only with rules that switch blocking on for what they match (confident blocks, the score refusal for outside sources) is fine ("blocking through rules"), no longer "detection only: nothing is blocked".
  • Tests: every system path of a test configuration (the apply spool, the managed rule files, the IP block list, the database...) points at a temporary directory, with a test that checks it. A test wrote an IP block list request into the default spool: when the unit tests ran as root on a production host (release gate G10), its block list was replaced by the test entries for about a minute until put back.
  • API tokens: the "Close" button of the new-token box keeps its distance from the token field.

繁體中文

  • 健康檢查 API:ModSecurity 引擎設定為只偵測、但有規則會對命中的請求切回封鎖 (確定封鎖、外部來源分數超過門檻) 時,判定為正常「由規則封鎖」,不再誤報「只偵測,不會封鎖」。
  • 測試:所有測試用設定的系統路徑 (套用佇列、受管理規則檔、IP 封鎖清單、資料庫等) 一律改到暫存目錄,並有測試把關。之前有測試會把 IP 封鎖清單的套用要求寫進預設的佇列目錄:在正式機上以 root 跑單元測試 (發版關卡 G10) 時,正式機的封鎖清單會被短暫換成測試內容約 1 分鐘後才自動改回。
  • API 權杖頁:新權杖顯示框的「關閉」按鈕與權杖欄位隔開,不再貼在一起。

日本語

  • ヘルスチェック API:ModSecurity のエンジンが検知のみでも、一致したリクエストでブロックを有効にするルール (確定ブロック、外部からのスコア超過) がある場合は「ルールでブロック」として正常と判定し、「検知のみ、ブロックしません」と誤って警告しないようにしました。
  • テスト:テスト用設定のシステムパス (適用キュー、管理ルールファイル、IP ブロックリスト、データベースなど) をすべて一時ディレクトリに向け、それを確認するテストを追加しました。以前は IP ブロックリストの適用要求を既定のキューに書くテストがあり、本番ホストで root として単体テストを実行すると (リリースゲート G10)、本番のブロックリストが約 1 分間テストの内容に置き換わってから元に戻っていました。
  • API トークン:新しいトークンの表示欄の「閉じる」ボタンをトークン欄から離しました。

jt-waf-mgr 0.4.82

Choose a tag to compare

@jasoncheng7115 jasoncheng7115 released this 17 Nov 12:43

Verify before installing:

sha256sum -c jt-waf-mgr-0.4.82.tar.gz.sha256
openssl dgst -sha256 -verify release-key.pem -signature jt-waf-mgr-0.4.82.tar.gz.sig jt-waf-mgr-0.4.82.tar.gz

SHA-256 0c7dc9b171599059cc677ad1b45541316662c5f0497cc1b173274d1f3a12180e

English

  • Pause the WAF (troubleshooting, Admin → Pause the WAF): when a site misbehaves, stop refusing on every site or on one site for a while to see whether the WAF causes it. 1, 3, 12 or 24 hours or until resumed (a daily reminder while it lasts); it ends by itself. "Resume everything" removes only the pause; every other rule stays as it was.
    • While paused: this system's confident blocks, country limits and other own rules do not run; CRS only detects and still logs events; exclusions and masking stay. The IP block list and nginx's own limits stay in force.
    • Pausing takes an administrator, a fresh one-time code and a reason; approvers can resume. API tokens cannot pause, and ordinary changes cannot touch the pause rules. In effect in about a second (no sandbox run, no second person), each time a version like any change; "paused" / "resumed" is logged and notified once in force, a failure gets an urgent notification.
    • One site is matched by the site nginx chose (the ModSecurity transaction id $host-$request_id), which a full URL in the request line cannot hide; without that setting, the Host header, with a warning on the page.
    • A red band with the time left on every page; the health API reports a warning; other changes are tested in the sandbox as without the pause; a rollback leaves the pause as it is.
  • An apply result that cannot be recorded marks the change as failed with an urgent notification (it no longer stays "applying", holding every later change).
  • Only the pause rules may use ctl:ruleEngine=DetectionOnly; no other rule may take their ids or go above them; a rule-removal range (e.g. 10200-19999) that covers the system score-refusal rules is refused.
  • The run history charts of the event analysis share the row; the time axis no longer repeats a date.

繁體中文

  • 暫停 WAF (排查用,管理 → 暫停 WAF):網站出問題時,可以讓全部站台或單一站台暫時不封鎖,確認是不是 WAF 造成。時間可選 1、3、12、24 小時或永久 (永久每天提醒),時間到自動恢復;「一鍵復歸」只拿掉暫停,其他規則的開關不變。
    • 暫停期間:本系統的確定封鎖、國家規則與其他自訂規則不執行,CRS 只偵測並照樣記錄事件,排除與遮蔽規則照常。IP 封鎖清單與 nginx 自己的限制不受影響。
    • 只有管理者加一次性密碼與原因才能暫停,核准者以上可以恢復;API 權杖不能暫停,一般變更也不能改暫停規則。約 1 秒生效 (不跑沙箱、不需第二人核准),每次都是有版本記錄的變更;套用成功才記錄並通知「已暫停 / 已恢復」,失敗另發緊急通知。
    • 單一站台用 nginx 決定的站名比對 (ModSecurity 交易編號 $host-$request_id),請求行寫完整網址也繞不過;沒有這個設定時改看 Host 標頭並在頁面提醒。
    • 暫停期間每一頁頂端顯示紅色橫幅與剩餘時間;健康檢查 API 回 warning;其他變更的沙箱照未暫停的狀態測試;回捲版本不會改變暫停狀態。
  • 套用結果無法記錄時,變更改標為套用失敗並發出緊急通知 (不再停在「套用中」而卡住之後的變更)。
  • 只有暫停規則可以使用 ctl:ruleEngine=DetectionOnly,其他規則也不能使用暫停規則的編號或排在它們前面;移除規則的範圍 (例如 10200-19999) 若涵蓋系統的分數封鎖規則一律拒絕。
  • 事件分析頁的執行記錄圖表改成平分整列;時間軸不再出現重複的日期標籤。

日本語

  • WAF の一時停止 (切り分け用、管理 → WAF の一時停止):サイトに問題があるとき、すべてのサイトまたは 1 つのサイトでブロックを一時的に止め、WAF が原因かを確認できます。1、3、12、24 時間または無期限 (続いている間は毎日お知らせ) を選べ、時間が来ると自動で再開します。「すべて元に戻す」は一時停止だけを外し、他のルールはそのままです。
    • 一時停止中:本システムの確定ブロック、国の制限、その他の独自ルールは実行されず、CRS は検知のみでイベントは記録されます。除外とマスキングは有効のままです。IP ブロックリストと nginx 自身の制限は影響を受けません。
    • 一時停止には管理者、ワンタイムコード、理由が必要で、承認者以上が再開できます。API トークンでは一時停止できず、通常の変更では一時停止ルールを変更できません。約 1 秒で反映され (サンドボックスなし、承認者不要)、毎回バージョン付きの変更になります。「一時停止 / 再開」は適用されてから記録・通知し、失敗した場合は緊急通知を送ります。
    • 1 サイトの一時停止は nginx が選んだサイト名 (ModSecurity のトランザクション ID $host-$request_id) で照合するため、リクエスト行に完全な URL を書いても回避できません。この設定がない場合は Host ヘッダーで照合し、ページに注意を表示します。
    • 一時停止中はすべてのページ上部に赤い帯と残り時間を表示し、ヘルスチェック API は warning を返します。他の変更のサンドボックスは一時停止なしの状態でテストし、ロールバックしても一時停止の状態は変わりません。
  • 適用結果を記録できない場合は変更を適用失敗とし、緊急通知を送るようにしました (「適用中」のまま後続の変更を止めることがなくなりました)。
  • ctl:ruleEngine=DetectionOnly を使えるのは一時停止ルールだけにし、他のルールが一時停止ルールの ID を使うことや、その前に置くことはできません。ルール除外の範囲 (例:10200-19999) がシステムのスコア拒否ルールを含む場合は拒否します。
  • イベント分析の実行記録のグラフが行全体を均等に使うようにし、時間軸に同じ日付が重ならないようにしました。

jt-waf-mgr 0.4.81

Choose a tag to compare

@jasoncheng7115 jasoncheng7115 released this 17 Nov 11:46

Verify before installing:

sha256sum -c jt-waf-mgr-0.4.81.tar.gz.sha256
openssl dgst -sha256 -verify release-key.pem -signature jt-waf-mgr-0.4.81.tar.gz.sig jt-waf-mgr-0.4.81.tar.gz

SHA-256 bab7bdf59cfa4465a792090e4b79bbfafb80177188ff76d47590a38acc404eba

English

  • A failed event analysis says why and keeps a detailed error log: the cause and what to do for each kind of error (502/503/504, unreachable, timeout, key refused, model missing, malformed answer, token limit...), and every try can be opened: time, batch, HTTP status, server headers and the start of the answer (the API key is always masked). Database schema 17.
  • Token charts: the event analysis and threat intelligence pages show the tokens used per day for 30 days (the analysis page split into scheduled analysis and single-event AI analysis).
  • Stat tiles at the top of the rule list: rules, on, partly off, off, not in effect, rules hit in 30 days and their hits (for the source chosen).
  • The "Sites" column of the rule list keeps a readable width; site names no longer wrap a letter at a time.
  • The event analysis status card in two groups (analysis and LLM, schedule and thresholds), laid out like the threat intelligence page; the rule page has a card title and two groups.
  • Table columns whose values open the right-click menu show a small funnel by the heading, and the cell shows it under the pointer.
  • The "formatted / raw" switch and the "Copy" button of a rule's text have the same height.

繁體中文

  • 事件分析失敗時寫出原因與詳細錯誤記錄:依錯誤種類說明原因與處理方式 (502/503/504、連不上、逾時、金鑰被拒、模型不存在、回答格式不對、token 上限等),可展開每一次嘗試的時間、批次、HTTP 狀態、伺服器標頭與回答開頭 (API 金鑰一律遮蔽)。資料庫 schema 17。
  • Token 用量圖表:事件分析頁與威脅情報頁都有最近 30 天每天的 token 用量 (事件分析頁分成排程分析與單一事件 AI 分析)。
  • 規則頁上方加上統計卡片:規則總數、啟用、部分停用、停用、未生效、30 天有命中的規則數與命中次數 (依目前選的來源)。
  • 規則清單的「站台」欄有足夠寬度,站名不再逐字換行。
  • 事件分析頁的狀態卡改成兩組 (分析與 LLM、排程與條件),排法與威脅情報頁相同;規則詳細頁加上卡片標題並分成「比對與動作」「來源、範圍與命中」兩組。
  • 表格中可以按右鍵開選單的欄位,標題旁有篩選小圖示,滑過值時游標與底線也會提示。
  • 規則內容的「排版 / 原始」切換與「複製」按鈕高度一致。

日本語

  • イベント分析が失敗したときに原因と詳細なエラー記録を表示:エラーの種類ごとに原因と対処 (502/503/504、接続不可、タイムアウト、キーの拒否、モデルなし、応答形式の誤り、トークン上限など) を示し、各試行の時刻、バッチ、HTTP ステータス、サーバーのヘッダー、応答の先頭を展開して確認できます (API キーは常に伏せます)。データベース schema 17。
  • トークン使用量のグラフ:イベント分析ページと脅威インテリジェンスページに直近 30 日の 1 日あたりの使用量を表示 (イベント分析ページは定期分析と単一イベントの AI 分析に分けて表示)。
  • ルール一覧の上部に統計カード:ルール総数、有効、一部無効、無効、未適用、30 日間にヒットしたルール数とヒット数 (選択中のソース)。
  • ルール一覧の「サイト」列に十分な幅を確保し、サイト名が 1 文字ずつ折り返さないようにしました。
  • イベント分析の状態カードを 2 グループ (分析と LLM、スケジュールと条件) に分け、脅威インテリジェンスページと同じ配置にしました。ルール詳細ページにカードの見出しを付け、2 グループに分けました。
  • 右クリックでメニューを開ける表の列は、見出しに小さな絞り込みアイコンを表示し、ポインターを置くとセルでも分かるようにしました。
  • ルール本文の「整形 / 原文」切り替えと「コピー」ボタンの高さを揃えました。

jt-waf-mgr 0.4.80

Choose a tag to compare

@jasoncheng7115 jasoncheng7115 released this 17 Nov 11:20

Verify before installing:

sha256sum -c jt-waf-mgr-0.4.80.tar.gz.sha256
openssl dgst -sha256 -verify release-key.pem -signature jt-waf-mgr-0.4.80.tar.gz.sig jt-waf-mgr-0.4.80.tar.gz

SHA-256 ffafc7bca285c4220d0943414edab5af48a9115d886103f5487c520f31d37f33

English

  • New GET /api/v1/health (API token scope status:read): whether the WAF works, for a monitoring system. Always 200; status is ok, warning or critical. It checks the nginx master process, ModSecurity in blocking mode, managed rule files changed outside jt-waf-mgr, the last apply, the event collector still reading the audit log, the IP block list loaded, program integrity, the audit chain, outside configuration changes in the last 24 hours and repeated event analysis failures, plus numbers for graphs. It uses the results the background checks keep and is cheap to ask every minute. The LibreNMS / Nagios plugin check_jt_waf_mgr (jt-lnms-plugins) reads it.
  • The rule list opens on all sources (it opened on the site rules only, so OWASP CRS seemed missing); "All sources" is first in the source menu.

繁體中文

  • 新增 GET /api/v1/health (API 權杖 scope status:read):給監控系統看 WAF 是否正常運作,一律回 200,status 是 ok、warning 或 critical。檢查 nginx 主程序、ModSecurity 是否為封鎖模式、受管理規則檔是否被外部修改、最近一次套用、事件收集是否仍在讀稽核記錄、IP 封鎖清單是否載入、程式完整性、稽核鏈、24 小時內設定是否被外部修改、事件分析是否連續失敗;另附給圖表用的數字。只用背景檢查已有的結果,每分鐘問一次也沒負擔。LibreNMS / Nagios 外掛 check_jt_waf_mgr (jt-lnms-plugins) 讀的就是它。
  • 規則頁預設改為「所有來源」(之前預設只看站台規則,看不到 OWASP CRS);來源選單把「所有來源」放第一個。

日本語

  • GET /api/v1/health を追加 (API トークンのスコープ status:read):監視システム向けに WAF が正常に動作しているかを返します。常に 200 で、status は ok、warning、critical のいずれかです。nginx のマスタープロセス、ModSecurity がブロックモードか、管理ルールファイルの外部変更、直近の適用、イベント収集が監査記録を読み続けているか、IP ブロックリストの読み込み、プログラムの完全性、監査チェーン、24 時間以内の外部による設定変更、イベント分析の連続失敗をチェックし、グラフ用の数値も返します。バックグラウンドのチェック結果を使うので、毎分問い合わせても負荷はありません。LibreNMS / Nagios プラグイン check_jt_waf_mgr (jt-lnms-plugins) がこれを読みます。
  • ルール一覧の既定を「すべてのソース」にしました (以前はサイトのルールだけが表示され、OWASP CRS が見えませんでした)。ソースのメニューでも「すべてのソース」を先頭にしました。