
軽量かつ多層的なLinuxサンドボックスで、namespaces、pivot_root、seccomp-bpf、capability dropping、そしてエビデンスベースの判定エンジン(Truthimatics Public Version)を組み合わせ、安全で監査可能なコード実行を実現します。
Linux上でネイティブコードを実行するための多層サンドボックス。
7つの順序付けられた分離レイヤー — 外部依存なし、約81 KiBの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 | Firecracker | gVisor | bwrap | nsjail | |
|---|---|---|---|---|---|
| 外部依存 | ゼロ | libc, seccomp | Go ランタイム | libc | libc, protobuf |
| バイナリサイズ | ~81 KiB | 20+ MiB | 40+ MiB | ~70 KiB | ~1 MiB |
| VM 分離 | なし | あり (microVM) | なし (サンドボックス) | なし | なし |
| seccomp ホワイトリスト | あり | なし | あり | オプション | あり |
| コンテンツハッシュ | あり | なし | なし | なし | なし |
| 監査 JSON | あり | なし | あり | なし | 部分的 |
| ビルドの複雑さ | make 1 回 | 複雑 | 複雑 | ごく簡単 | 中程度 |
Z-Jail は bwrap(最小限、デフォルトで seccomp なし)と nsjail(多機能、重い依存関係)の間のニッチを埋めます。コンテナランタイムを導入することなく多層防御が必要な CI パイプライン、CTF ジェイルチャレンジ、軽量なコード評価 向けに設計されています。
flowchart LR
CLI[CLI args] --> P[parse_args]
P --> C{clone namespaces}
C -->|child| CR[child_run]
C -->|parent| W[waitpid]
CR --> RL[setrlimit]
RL --> FD[close fds >= 3]
FD --> DUMP[PR_SET_DUMPABLE=0]
DUMP --> PV[pivot_root]
PV --> NNP[PR_SET_NO_NEW_PRIVS]
NNP --> CAP[drop capabilities]
CAP --> SC[seccomp-BPF]
SC --> SIG[signal parent]
SIG --> EX[execve target]
W --> A[audit JSON]
A --> EXIT[exit]
各レイヤーは、後のレイヤーが前のレイヤーによって元に戻されないように順序付けられています:
capset による権限昇格も不可sequenceDiagram
participant P as Parent
participant C as Child
P->>C: clone (NEWNS|NEWPID|NEWNET|NEWIPC|NEWUTS)
Note over C: setrlimit(CPU, AS, NOFILE, NPROC)
Note over C: close(all fds > 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(all zero) + securebits
Note over C: seccomp(SECCOMP_MODE_FILTER, whitelist)
C->>P: write(pipe, ready=1)
Note over C: execve(target)
P->>P: waitpid
P->>P: write audit JSON
Z-Jailは、execveの前に子プロセス内で7つの順序付けられた分離メカニズムを適用します。それぞれは、後のステップが前のステップを再実行することによって元に戻せないように選択されています。
親プロセスはclone()で子プロセスを作成し、5つの名前空間(mount、PID、network、IPC、UTS)を要求します。その後、子プロセスは以下のパイプラインを実行します:
setrlimitは、ゲストの影響を受けるコードが実行される前にCPU時間、アドレス空間、オープンファイル数、プロセス数を制限し、フォーク爆弾やメモリ枯渇を抑止します。
親のレポートパイプを除くすべての継承されたディスクリプタが閉じられ、リークしたハンドルがexecveを越えて引き継がれるのを防ぎます。
PR_SET_DUMPABLE=0はコアダンプを無効にし、/proc/self/memへのアクセスを制限します。
pivot_rootマウント名前空間のルートが指定されたルートディレクトリに置き換えられます:ディレクトリは自身にバインドマウントされ、pivot_rootがマウントツリーを交換し、プロセスは新しいルートにchdirし、古いルートは遅延的にデタッチされて削除されます。これはchroot(2)よりも厳密に強力です。なぜなら、以前のルートは単に隠されるのではなくアンマウントされるからです。
NO_NEW_PRIVSPR_SET_NO_NEW_PRIVSは、setuidバイナリ、ファイルケーパビリティ、またはLSM遷移を通じた後続の特権獲得を防ぎます。不可逆です。
CAP_SETUIDをまだ保持している間にユーザーIDとグループIDが変更され、その後capsetがすべてのケーパビリティセットをゼロにし、セキュアビットがロックされるため、ケーパビリティを再度有効にすることはできません。
ホワイトリストフィルタがインストールされ、ホワイトリストにない呼び出しは終了されます。 24のシステムコールの許可リスト:
| システムコール | 番号 | 備考 |
|---|---|---|
read | 0 | stdin |
write | 1 | stdout/stderr + レポートパイプ |
openat | 257 | ファイルアクセス(openではない) |
close | 3 | — |
lseek | 8 | — |
brk | 12 | ヒープ管理 |
mmap | 9 | 引数制限:flags == 0x22 完全一致(MAP_PRIVATE|MAP_ANONYMOUS)かつ prot & PROT_EXEC == 0 |
munmap | 11 | — |
execve | 59 | 起動時の単一exec |
exit_group | 231 | クリーンなプロセス終了 |
rt_sigaction | 13 | シグナルハンドラ |
rt_sigprocmask | 14 | シグナルマスキング |
getrandom | 318 | 乱数ソース |
clock_gettime | 228 | タイミング |
fstat | 5 | ファイルメタデータ |
arch_prctl | 158 | TLSセットアップ |
mprotect | 10 | 引数制限:prot & PROT_EXEC == 0(W^Xを保持) |
prlimit64 | 302 | 引数制限:new_limit == NULL 完全64ビット(下位+上位ワードの両方がゼロ、読み取り専用) |
readlinkat | 267 | — |
rseq | 334 | glibcの再開可能シーケンス |
set_robust_list | 273 | glibcスレッド初期化 |
set_tid_address | 218 | glibc初期化 |
access | 21 | — |
pread64 | 17 | — |
最後の9つ(arch_prctl .. pread64)は、最新の静的リンクされたglibcプログラムがmainの前に必要とするCランタイム起動呼び出しです。BPFフィルタは動的に生成されます:各ホワイトリストエントリに対して、システムコールが一致する場合は許可し、そうでない場合はKILLにフォールスルーするジャンプチェーンが出力されます。アーキテクチャが最初にチェックされます(AUDIT_ARCH_X86_64)。
3つの引数レベルのルールがポリシーの意図を保持します:
mmapはflags == MAP_PRIVATE|MAP_ANONYMOUS (0x22)かつPROT_EXECクリアに制限mprotectはPROT_EXECが決して設定されないように制限(W^Xを強制)prlimit64はNULLの新規制限引数に制限され、完全64ビットでチェック(ゲストは読み取り可能だが制限を引き上げることはできない)フィルタは、rootを必要とせずに実際のprctl(PR_SET_SECCOMP)に対してテストケースをfork+execveする独立したテスト(tests/seccomp_filter_test.c、9/9合格)によって個別に検証されます。
子プロセスが終了した後、親プロセスはバージョン管理されたスキーマ(z-jail.audit/v1)に準拠した JSON 監査レコードを出力します。このレコードには、実行時間、終了コード、判定フィールド、アクティブな seccomp フィルタ名とホワイトリストのサイズ、有効化された名前空間、および content_fingerprint(親プロセスが計算した対象バイナリの BLAKE2b-256 ダイジェスト)が含まれます。オプションの --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=<dir> [--seccomp-enforce] [--self-hash=<hex>]
[--quiet] [--verbose] -- <program> [args...]