
Linux 5.15+ LTS向けのeBPF EDR専用監査ツール:14個のカーネルフック、15個のアクション(13個のMITREテクニック)、プロセス系譜、SIEMエクスポート、K8s/Docker対応。
Linux向けの監査専用eBPFランタイムセンサー - コンテナエスケープ検出、設計段階から堅牢化。
19の検出アクション · 24のBPFプログラム · BPF-LSM解決パスルール · IPv6 · ワイヤーフォーマット v4
プロジェクトを支援する:
[!IMPORTANT] 検出と監査のみで、強制は行いません。 いかなるBPFプログラムも
-EPERMを返しません。 システムコールがブロックされることは一切ありません。これはランタイム観測プレーンであり、 防止プレーンではありません。詳細はdocs/SECURITY.mdおよびTHREAT_MODEL.mdを参照してください。
| 🎯 カナリアファイル | カーネルのO(1)マップに不可視のパスを配置 - 触れるだけで即座にCRITICALアラートが発火、openat2や存在しないファイルへのプローブも含む |
| 🛡️ 回避耐性 | openat2をフック · unshare(CLONE_NEWUSER)はCRITICALにエスカレート · 自己除外はPIDベース(prctlによるなりすまし不可) · release_agentは/sys/fs/cgroup/配下のどこでもマッチ |
| 🧠 BPF LSMモード | アクティブなLSMリストにbpfが含まれるカーネルでは、lsm/file_openがカーネル解決済みパス(bpf_d_path)を分類 - io_uringのopenやユーザー文字列レースを一挙に解消。自動的にトレースポイントへフォールバック |
| 🌐 フルスタックのネットワーク可視化 | IPv4およびIPv6の接続、疑わしいポートの重大度を設定可能 |
| 📈 組み込みの可観測性 | 自作のPrometheus /metrics(依存ゼロ)、SIEMの無音検出用Sensor_Heartbeat合成アラート、degraded/last_errヘルスフィールド |
| 🏥 自己修復 | systemd Type=notify + WatchdogSec=30、10秒ハートビートによるK8s livenessプローブ - ハングしたセンサーは自動再起動(SIGSTOPで実機検証済み) |
| 🔐 最小権限デプロイ | privileged: false + CAP_BPF/PERFMON/SYS_ADMINのみ、seccomp RuntimeDefault、SIEMトークンはSecrets、system-node-critical優先度 |
| ⚡ 高速かつ軽量 | アイドル時CPU約0.7%、25,000フォークでリングバッファドロップ0、RSS 33〜43 MB、依存ゼロのGoデーモン |
| 📤 SIEMネイティブ | JSON · ECS 8.11 · OCSF 1.3.0 · CEF · LEEF 2.0 → file/stdout/syslog/HTTPS-webhook(Splunk HEC)、バッチ処理・リトライ・サーキットブレーカー対応 |
git clone https://github.com/0xmfbk/ebpf-container-escape-framework.git
cd ebpf-container-escape-framework
make check-env # read-only probe: toolchain, BTF, tracefs, LSM, systemd
sudo make deps # one-shot bootstrap: clang, libbpf, bpftool, Go 1.26+
make kernel userspace emulation
sudo -E make verify # full suite: 104 checks (97 core + 7 SIEM) on Debian/6.12
sudo ./install.sh # systemd service (hardened unit, config preserved)
要件: カーネル ≥ 5.15 かつ CONFIG_DEBUG_INFO_BTF (/sys/kernel/btf/vmlinux) が有効、root 権限と CAP_BPF CAP_PERFMON CAP_SYS_ADMIN が必要です。make deps/make check-env は Debian、Ubuntu、WSL2 で動作します (docs/WSL2.md)。
| # | アクション | 重大度 | MITRE | フック |
|---|---|---|---|---|
| 1 | Container_Namespace_Unshare | T1611 | kprobe __x64_sys_unshare - CLONE_NEWUSER は | |
| 2 | Container_Pivot_Root_Escape | T1611 | kprobe __x64_sys_pivot_root | |
| 3 | Sensitive_File_Access | T1003.008 | /etc/shadow · ランタイムソケット (docker/containerd/crio/k3s) | |
| 4 | Process_Execution | T1059.004 | sys_enter_execve | |
| 5 | Network_Connection | T1071 | sys_enter_connect - IPv4 + IPv6、不審ポートを設定可能 | |
| 6 | Process_Injection | T1055.008 | sys_enter_ptrace | |
| 7 | Log_Tampering | T1562.001 | unlinkat · truncate · rename/renameat/renameat2 · 書き込み意図の open (O_TRUNC/O_WRONLY) | |
| 8 | Ebpf_Tampering | T1562.001 | sys_enter_bpf (load/attach/link コマンド) | |
| 9 | Perf_Event_Open | T1562.001 | sys_enter_perf_event_open (デフォルトで抑制) | |
| 10 | Suspicious_Mount | T1611 | sys_enter_mount | |
| 11 | Namespace_Switch | T1611 | sys_enter_setns | |
| 12 | Chroot_Escape | T1611 | sys_enter_chroot | |
| 13 | Executable_Memory | T1620 | sys_enter_mprotect (PROT_EXEC) (デフォルトで抑制) | |
| 14 | Core_Pattern_Modification | T1611 | core_pattern · modprobe · uevent_helper | |
| 15 | Cgroup_Release_Agent | T1611 | /sys/fs/cgroup/ 配下の任意の release_agent/notify_on_release | |
| 16 | Canary_Triggered | T1552.001 | canary マップのヒット - 存在しないパスでも発火 | |
| 17 | Memfd_Create | T1055.012 | sys_enter_memfd_create - ファイルレスペイロード | |
| 18 | Execveat | T1620 | sys_enter_execveat - fd/memfd 実行 | |
| 19 | Kernel_Module_Load | T1547.006 | sys_enter_init_module + finit_module |
ファイルパスルール (アクション 3、14、15、16) には 2 つの検出クラスがあります:
open/openat/openat2 トレースポイント上で動作する。これらは対象ファイルが存在しない場合でもシステムコールのエントリ時に発火する。また cgroup-v2 ホストでは、release_agent を探る行為そのものが攻撃である。bpf が含まれる場合は lsm/file_open が担当し(bpf_d_path によるカーネル解決パス、io_uring の open も含む)、それ以外はトレースポイントが担当する。いずれの場合も open ごとに正確に 1 つのイベントとなる。