HN 日本語サマリー

← 一覧へ戻る
セキュリティ

Show HN: Z-Jail – 7つの防御レイヤーとゼロ依存性を持つ130KBのLinuxサンドボックス-C99

Show HN: Z-Jail – A 130 KB Linux sandbox-C99 with 7 defense layers and zero deps (github.com)

10 pointsby Zierax4 コメント

要約

Z-Jailは、Linux上でネイティブコードを実行するための多層サンドボックスで、外部依存性がなく、約130KBのPIEバイナリです。7つの独立した防御レイヤー(名前空間、pivot_root、機能、NO_NEW_PRIVS、seccomp-BPF、監査、そして真理判定エンジン)を備えており、最小限のリソースで高いセキュリティを提供します。CIパイプラインやCTFチャレンジ、軽量なコード評価など、コンテナランタイムを必要としない防御が必要な場合に最適です。

全文翻訳

Z-Jail

[画像: Z-Jail]

Linux上でのネイティブコード実行のためのマルチレイヤーサンドボックス。
7つの順序付けられた分離レイヤー — 外部依存関係なし、約81KiBのPIEバイナリ。

[画像] [画像] [画像] [画像]


┌──────────────────────────────────────────────────────┐
│                    Z-Jail                            │
├──────────────────────────────────────────────────────┤
│  rlimits           (CPU, AS, NOFILE, NPROC caps)     │
│  Namespaces       (mount, pid, net, ipc, uts)        │
│  pivot_root       (chroot on steroids)               │
│  NO_NEW_PRIVS     (no privilege escalation)          │
│  Capabilities     (drop all, lock securebits)        │
│  seccomp-BPF      (whitelist-v1: 24 syscalls)        │
│  Audit            (JSON logging + BLAKE2b hashing)   │
└──────────────────────────────────────────────────────┘

目次


クイックスタート

git clone https://github.com/Division-36/Z-Jail.git
cd Z-Jail
make
sudo ./z_jail --root=/path/to/rootfs --seccomp-enforce -- /bin/ls

--root ディレクトリには、ターゲットバイナリとその依存関係を含む最小限のファイルシステムが必要です(静的バイナリの場合は、バイナリのみで十分です)。


Z-Jailの利点

既存のサンドボックスソリューションはトレードオフを伴います。

Z-JailFirecrackergVisorbwrapnsjail
外部依存関係ゼロlibc, seccompGoランタイムlibclibc, protobuf
バイナリサイズ約81KiB20MiB超40MiB超約70KiB約1MiB
VM分離いいえはい (microVM)いいえ (サンドボックス)いいえいいえ
seccompホワイトリストはいいいえはいオプションはい
コンテンツハッシュはいいいえいいえいいえいいえ
Audit JSONはいいいえはいいいえ部分的
ビルドの複雑さ1回のmake複雑複雑簡単中程度

Z-Jailは、bwrap(最小限、デフォルトでseccompなし)とnsjail(多機能、重い依存関係)の間のニッチを埋めます。これは、コンテナランタイムを導入せずに防御を深める必要があるCIパイプライン、CTFジャイルチャレンジ、および軽量コード評価のために設計されています。


アーキテクチャ

データフロー
flowchart LR
    CLI[CLI引数] --> P[引数解析]
    P --> C{名前空間のクローン}
    C -->|子プロセス| CR[子プロセス実行]
    C -->|親プロセス| W[waitpid]
    CR --> RL[rlimit設定]
    RL --> FD[fd >= 3をクローズ]
    FD --> DUMP[PR_SET_DUMPABLE=0]
    DUMP --> PV[pivot_root]
    PV --> NNP[PR_SET_NO_NEW_PRIVS]
    NNP --> CAP[ケーパビリティ削除]
    CAP --> SC[seccomp-BPF]
    SC --> SIG[親プロセスにシグナル送信]
    SIG --> EX[ターゲットexecve]
    W --> A[監査JSON]
    A --> EXIT[終了]

ロード中

レイヤーの順序

各レイヤーは、後続のレイヤーが先行するレイヤーによって取り消されないように順序付けられています。

  1. setrlimit — 最初にCPU、アドレス空間、ファイル数、プロセス数を制限します。
  2. fd scrub — レポートパイプ以外のすべての継承されたfdを閉じます。
  3. PR_SET_DUMPABLE=0 — コアダンプを無効にし、/proc/self/memをロックダウンします。
  4. pivot_root — ホストファイルシステムからデタッチします。古いルートは遅延アンマウントされます。
  5. PR_SET_NO_NEW_PRIVS — この時点以降、setuidバイナリ、ファイルケーパビリティ、またはLSM遷移による権限昇格を防ぎます。
  6. drop_caps — すべてのケーパビリティをゼロにし、securebitsをロックします。
  7. seccomp-BPF — システムコールをホワイトリストのみに制限します。
  8. signal parent — サンドボックスの準備ができたことを親プロセスに伝えます。
  9. execve — プロセスをターゲットバイナリに置き換えます。
sequenceDiagram
    participant P as 親
    participant C as 子
    P->>C: clone (NEWNS|NEWPID|NEWNET|NEWIPC|NEWUTS)
    Note over C: setrlimit(CPU, AS, NOFILE, NPROC)
    Note over C: close(すべてのfd > 2)
    Note over C: PR_SET_DUMPABLE=0
    Note over C: pivot_root → chdir("/") → umount -l
    Note over C: PR_SET_NO_NEW_PRIVS
    Note over C: capset(すべてゼロ) + securebits
    Note over C: seccomp(SECCOMP_MODE_FILTER, ホワイトリスト)
    C->>P: write(パイプ, ready=1)
    Note over C: execve(ターゲット)
    P->>P: waitpid
    P->>P: 監査JSONを書き込む

ロード中


レイヤー

Z-Jailは、execveの前に子プロセスで7つの順序付けられた分離メカニズムを適用します。各メカニズムは、後続のステップが先行するステップによって取り消されないように選択されています。親プロセスは5つの名前空間(マウント、PID、ネットワーク、IPC、UTS)を要求してclone()で子プロセスを作成し、その後、子プロセスは以下のパイプラインを実行します。

1. リソース制限

setrlimitは、ゲストによって影響されるコードが実行される前に、CPU時間、アドレス空間、オープンファイル数、およびプロセス数を制限し、フォーク爆弾やメモリ枯渇を防ぎます。

2. ファイルディスクリプタのクリーニング

親のレポートパイプを除き、継承されたすべてのディスクリプタは閉じられ、漏洩したハンドルがexecveを越えて伝播するのを防ぎます。

3. Dumpabilityオフ

PR_SET_DUMPABLE=0は、コアダンプを無効にし、/proc/self/memへのアクセスを制限します。

4. pivot_root

マウント名前空間のルートは、指定されたルートディレクトリに置き換えられます。ディレクトリはそれ自体にバインドマウントされ、pivot_rootがマウントツリーをスワップし、プロセスは新しいルートにchdirし、古いルートは遅延デタッチされて削除されます。これは、古いルートが単に隠されるのではなくアンマウントされるため、chroot(2)よりも厳密に強力です。

5. NO_NEW_PRIVS

PR_SET_NO_NEW_PRIVSは、setuidバイナリ、ファイルケーパビリティ、またはLSM遷移による後続の権限昇格を防ぎます。これは元に戻せません。

6. Capabilityドロップ

ユーザーIDとグループIDは、CAP_SETUIDがまだ保持されている間に変更されます。その後、capsetですべてのケーパビリティセットがゼロになり、securebitsがロックされるため、ケーパビリティを再度有効にすることはできません。

7. seccomp-BPF (whitelist-v1)

ホワイトリストフィルタがインストールされ、ホワイトリストにない呼び出しは終了させられます。許可されるシステムコールは24個です。

システムコール番号注釈
read0標準入力
write1標準出力/標準エラー出力 + レポートパイプ
openat257ファイルアクセス(openではない)
close3—
lseek8—
brk12ヒープ管理
mmap9引数制限: flags == 0x22 のみ(MAP_PRIVATE
munmap11—
execve59起動時の単一実行
exit_group231プロセスのクリーンな終了
rt_sigaction13シグナルハンドラ
rt_sigprocmask14シグナルマスキング
getrandom318乱数ソース
clock_gettime228タイミング
fstat5ファイルメタデータ
arch_prctl158TLSセットアップ
mprotect10引数制限: prot & PROT_EXEC == 0 (W^Xを維持)
prlimit64302引数制限: new_limit == NULL (64ビット全体、ゲストは読み取りのみ可能、制限の引き上げ不可)
readlinkat267—
rseq334glibc再開可能シーケンス
set_robust_list273glibcスレッド初期化
set_tid_address218glibc初期化
access21—
pread6417—

最後の9つ(arch_prctlからpread64)は、mainの前に最新の静的リンクされたglibcプログラムが必要とするCランタイム起動コールです。BPFフィルタは動的に生成されます。各ホワイトリストエントリに対して、ジャンプチェーンが出力され、システムコールが一致する場合は許可し、一致しない場合はKILLにフォールスルーします。アーキテクチャは最初にチェックされます(AUDIT_ARCH_X86_64)。

3つの引数レベルのルールがポリシーの意図を維持します。

  • mmapはflags == MAP_PRIVATE|ANONYMOUS (0x22)かつPROT_EXECがクリアされている場合にのみ制約されます。
  • mprotectはPROT_EXECが設定されないように制限され(W^Xを強制)、
  • prlimit64はNULLのnew_limit引数に制限され、64ビット全体がチェックされます(ゲストは制限を読み取ることはできますが、引き上げることはできません)。

フィルタは、ルート権限なしでテストケースを実際のprctl(PR_SET_SECCOMP)に対してフォーク+execするスタンドアロンテスト(tests/seccomp_filter_test.c、9/9パス)によって独立して検証されます。

監査レコード

子プロセスが終了した後、親プロセスはバージョン管理されたスキーマ(z-jail.audit/v1)に準拠したJSON監査レコードを発行します。レコードには、実行時間、終了コード、判定フィールド、アクティブなseccompフィルタ名とホワイトリストサイズ、有効な名前空間、およびターゲットバイナリのBLAKE2b-256ダイジェストであるcontent_fingerprintが含まれます。オプションの--self-hashフラグを使用すると、オペレーターは期待されるダイジェストをピン留めして、結果が信頼される前に実行可能ファイルが改ざんされていないかを検出できます。

build/audits/<binary-name>.audit.jsonに書き込まれます。content_fingerprintはターゲットバイナリの正規のBLAKE2b-256ハッシュです(b2sum -l 256で再現可能)。レコードはprev_hashを介してハッシュチェーンを形成し、ファイルはパスコンポーネントでシンボリックリンクをたどらずに開かれ、追記専用(chattr +a)としてマークされるため、切り捨てたりインプレースで上書きしたりできません。詳細はdocs/AUDIT_SCHEMA.mdを参照してください。


使用方法

z_jail --root=<ディレクトリ> [--seccomp-enforce] [--self-hash=<16進数>] 
       [--quiet] [--verbose] -- <プログラム> [引数...]
フラグ説明
--root=<ディレクトリ>サンドボックスのルートディレクトリ(必須)
--seccomp-enforceseccomp-BPFシステムコールホワイトリストを有効にする
--self-hash=<16進数>バイナリが期待されるBLAKE2b-256ハッシュと一致するか検証する
--quiet監査出力を抑制する
--no-audit監査ファイルの作成を完全に無効にする
--verboseデバッグログを有効にする
--versionビルドIDを表示する(Z-Jail/v1+dev)
--help使用方法を表示して終了する
例
# すべての保護機能で静的バイナリを実行する
sudo z_jail --root=./roots --seccomp-enforce -- bin/hello_static

# バイナリ整合性検証付きで実行する
sudo z_jail --root=./roots --seccomp-enforce \
  --self-hash=$(b2sum -l 256 z_jail | cut -c1-64) -- bin/program

# クワイエットモード(監査JSONなし)
sudo z_jail --root=./roots --quiet -- bin/program

# 監査ファイルの作成を完全に無効にする
sudo z_jail --root=./roots --no-audit -- bin/program
終了コード
コード意味
0子プロセスが正常終了(判定: DETERMINISTIC)
1子プロセスがシグナルで終了(判定: REJECT)
2Self-hash: 無効な16進数文字列またはファイルが読み取れない
3Self-hash: 不一致(バイナリが改ざんされた)
101子プロセスセットアップエラー(rlimitなど)
102子プロセスseccompフィルタのインストールに失敗
103子プロセスexecveに失敗(バイナリが見つからない、実行権限がない)
104子プロセスpivot_rootに失敗
105子プロセスケーパビリティドロップに失敗
125名前空間作成に失敗(rootで実行?カーネルサポート?)

ビルドとインストール

要件
  • Linuxカーネル ≥ 5.4 (名前空間、seccomp-BPF、pivot_root)
  • GCC ≥ 11 (11.4, 13.2, 15.2でテスト済み)
  • 外部ライブラリなし — 標準Cツールチェーンのみ
コマンド
make              # z_jailをビルド(約81KiBのストリップなしPIEバイナリ)
make install      # /usr/local/bin + manページにインストール
make clean        # ビルド成果物を削除
make dist         # リリースtarballを作成
make check        # スモークテスト(--version + --help)

バイナリは、-fstack-protector-strong, -D_FORTIFY_SOURCE=2, フルRELRO, および -z now を使用して、Position Independent Executableとしてビルドされます。

コンパイル時オプション
make CC=clang CFLAGS="-O3 -march=native"   # カスタムコンパイラ/フラグ

テスト

クイックテスト(root不要)
# seccompフィルタロジック(9つのテスト)
tests/build/seccomp_filter_test

# BLAKE2b既知値テスト
tests/build/blake2b_known

これらはrootを必要とせず、100ミリ秒未満で実行されます。

フルテストスイート
make -C tests setup          # ペイロードとテストルートをビルド
sudo bash tests/run_tests.sh # 18シナリオ(インデックス0〜17)

名前空間作成のためにrootが必要です。テストスイートは以下をカバーしています。

#シナリオタイプテスト内容
0blake2b_regress既知値BLAKE2b実装の正確性
1seccomp_filterスタンドアロンBPFBPFフィルタロジックの9つのサブテスト
2hello_staticOK基本的な静的バイナリ実行
3hello_dynamickilled動的バイナリが拒否される(W^Xがld.soのPROT_EXECをブロック)
4execve_replacementOK起動時のポリシー準拠の単一execve
5fd_inherited_readOK標準入力/標準出力が正しく継承される
6mmap_bad_flagskilledMAP_SHAREDでのmmapがブロックされる
7mmap_good_allowedOKMAP_PRIVATE
8mmap_prot_execkilledPROT_EXECでのmmapがブロックされる
9mmap_self_modifykilled自己変更コードがブロックされる
10ptracekilledptraceがブロックされる
11socketkilledソケット作成がブロックされる
12chroot_escapekilledchrootシステムコールがブロックされる
13double_chrootkilled二重chrootがブロックされる
14mount_replaykilledmountシステムコールがブロックされる
15cpu_exhaustkilledfork爆弾がRLIMIT_NPROC(CPUではない)で制限される
16signal_parentkilled親プロセスへのシグナルがブロックされる
17self_hashOKバイナリ整合性検証

パフォーマンス

ネイティブUbuntu 26.04 LTS(カーネル7.0.0、Intel i7-11800H、4 vCPU、3.8GiB RAM)で測定、各ツール50サンプル、均一なワークロード(exit_group(0)を本体とするスタンドアロン静的バイナリ)、getrusageハーネスでタイミングを取った。同じハードウェアでのWSL2実行もdocs/BENCHMARKS.mdに報告されています。

メトリック値
バイナリサイズ約81KiB(ストリップなし)(約33KiB(ストリップ済み))
平均サンドボックスレイテンシ2.31 ± 0.56 ms (95% CI [2.16, 2.47])
ピークRSS1.61 MiB
コード行数(コア)約800
直接比較(同じホスト、同じ方法論)
ツールレイテンシ平均 ± sdピークRSSデフォルトseccomp
Z-Jail2.31 ± 0.56 ms1.61 MiBはい
bwrap3.35 ± 0.60 ms2.32 MiBいいえ
nsjail6.28 ± 1.48 ms7.86 MiBはい

テストされた条件下では、Z-Jailは3つのプロセスレベルサンドボックスの中で最小の常駐メモリと最低のレイテンシを持っています。Bubblewrapはデフォルトでseccompフィルタを実行せず、セットアップ作業も少ないですが、ここではわずかに遅いです。Z-Jailはseccompホワイトリストをインストールし、ケーパビリティをドロップし、実行ごとにpivot_rootを実行します。gVisor(runsc)はWSL2カーネルでセグメンテーション違反を起こし(docs/BENCHMARKS.md参照)、そこで測定できませんでした。FirecrackerはmicroVM(VMコールドブート、別のメトリック)で分離し、フォークから実行までのテーブルからは除外されています。これらは単一ホストの数値です — 相対的なものとして扱ってください。

注: 以前に文書化された数値(約8ms、約4MiB、約130KiB)は不正確であり、このコードベースとは一致しません。上記の数値は現在のmakeビルドで再測定されました。ベンチマーク中に発見されたマウント伝播バグはsrc/sandbox.c(バインドマウント前のMS_REC|MS_PRIVATE)で修正されました。再帰的なリモウントが測定されたレイテンシの一部を占めています。


脅威モデル

対象範囲
  • 信頼されていないペイロードによる任意のネイティブコード実行
  • chroot, mount, ptrace, socket, process_vm_writev を介したエスケープ
  • フォーク爆弾、CPU枯渇(RLIMIT_CPU)、メモリ枯渇(RLIMIT_AS)
  • execveを越えるファイルディスクリプタの漏洩
  • setuid / 動的リンカ / LD_PRELOADによるエスカレーション
  • seccompフィルタの削除またはケーパビリティの再有効化
対象外
  • 許可されたシステムコールサーフェスの外にあるカーネルゼロデイ
  • ハードウェアサイドチャネル(Spectre, Meltdown)
  • 共有/proc, /sysマウントを介した共存VMのエスケープ
  • CLONE_NEWNET + ブロックされたsocketを超えるネットワークエグレス
  • 同胞サンドボックスのリソース枯渇(cgroupサポートが必要)
仮定
  • ホストカーネルは変更されていないLinux ≥ 5.4であること
  • clone(CLONE_NEWNS|CLONE_NEWPID|...)が成功すること(CAP_SYS_ADMINが必要)
  • ターゲットバイナリは静的リンクされている必要がある(動的バイナリは、ライブラリが--rootにステージングされていても、W^Xによって拒否される)
  • --self-hash=<16進数>が本番環境のデプロイメントで構成されていること

ドキュメント

ファイル説明
README.mdこのファイル
docs/ARCHITECTURE.mdアーキテクチャ概要
docs/SANDBOX.mdレイヤーごとのサンドボックス内部構造
docs/SECCOMP.mdseccomp-BPFホワイトリスト設計
docs/AUDIT_SCHEMA.md監査JSONスキーマリファレンス
docs/THREAT_MODEL.mdセキュリティ上の仮定と範囲
docs/BLAKE2B.mdBLAKE2b実装の詳細
docs/BENCHMARKS.mdパフォーマンスベンチマーク
docs/BUILD.mdビルド手順
docs/adr/アーキテクチャ決定記録(4件)
man/z_jail.1マニュアルページ
SECURITY.mdセキュリティポリシーと報告
CONTRIBUTING.md貢献方法
CHANGELOG.mdリリース履歴
ROADMAP.md将来計画
TODO.md既知のギャップと計画中の作業

ロードマップ

v1.1.0 (現在)
  • 7つの順序付けられた分離レイヤー
  • BLAKE2b-256コンテンツフィンガープリント
  • append_only追跡とfdatasync耐久性を持つ監査JSON出力
  • seccomp-BPFジャンプオフセット検証(オーバーフロー時にクローズして失敗)
  • 監査ファイル作成を無効にする--no-auditフラグ
  • 自己完結型バイナリのためのSTATIC=1ビルドオプション
  • 18のテストシナリオ(インデックス0〜17)+ 9つのseccomp単体チェック
  • マニュアルページ、補完(bash, zsh, fish)
  • seccomp耐久性ベンチマーク
v2 (計画中)
  • 外部seccompポリシーファイル(JSONまたはBPFソース)
  • サンドボックスインスタンスごとのカスタム名前空間フラグ
  • CLI経由で設定可能なシステムコールホワイトリスト
  • CI統合のためのパフォーマンスプロファイリングフック
  • リリース署名(minisign/signify)
  • ファズ統合(oss-fuzz / libFuzzer)

ステータス

[画像: build] [画像: coverage]


ライセンス

MIT — 全文はLICENSEを参照してください。


Z-JailはWSL2(Kali Linux, GCC 15.2.0)でビルドされ、Linux 5.4+をターゲットとしています。 Division-36がメンテナンスしています。問題はissue trackerに報告してください。