
Audit-fähiges eBPF-EDR für Linux 5.15+ LTS: 14 Kernel-Hooks, 15 Aktionen (13 MITRE-Techniken), Prozess-Lineage, SIEM-Export, K8s/Docker-bereit.
Nur auditierender eBPF-Runtime-Sensor für Linux – Container-Escape-Erkennung, von Grund auf gehärtet.
19 Erkennungsaktionen · 24 BPF-Programme · BPF-LSM-Regeln für aufgelöste Pfade · IPv6 · Wire-Format v4
Unterstütze das Projekt:
[!IMPORTANT] Nur Erkennung & Audit, keine Durchsetzung. Kein BPF-Programm gibt
-EPERMzurück; kein Syscall wird jemals blockiert. Dies ist eine Runtime-Beobachtungsebene, keine Präventionsebene. Siehedocs/SECURITY.mdundTHREAT_MODEL.md.
| 🎯 Canary-Dateien | Unsichtbare Pfade in einer Kernel-O(1)-Map platzieren – jede Berührung löst sofort einen CRITICAL-Alert aus, einschließlich openat2 und Probes auf nicht existierende Dateien |
| 🛡️ Umgehungsresistent | openat2 abgefangen · unshare(CLONE_NEWUSER) eskaliert zu CRITICAL · Selbstausschluss erfolgt PID-basiert (nicht via prctl fälschbar) · release_agent überall unter /sys/fs/cgroup/ erkannt |
| 🧠 BPF-LSM-Modus | Auf Kerneln mit bpf in der aktiven LSM-Liste klassifiziert lsm/file_open kernel-aufgelöste Pfade (bpf_d_path) – io_uring-Opens und User-String-Races in einem Schritt geschlossen; fällt automatisch auf Tracepoints zurück |
| 🌐 Full-Stack-Netzwerk-Sicht | IPv4-und IPv6-Verbindungen mit konfigurierbarer Schwere für verdächtige Ports |
| 📈 Integrierte Observability | Handgeschriebene Prometheus-/metrics (keine Abhängigkeiten), synthetische Sensor_Heartbeat-Alerts zur Erkennung von SIEM-Stille, degraded/last_err-Health-Felder |
| 🏥 Selbstheilung | systemd Type=notify + WatchdogSec=30 und K8s-Liveness-Probes auf einem 10s-Heartbeat – ein hängender Sensor startet sich selbst neu (live mit SIGSTOP verifiziert) |
| 🔐 Least-Privilege-Deployment | privileged: false + nur CAP_BPF/PERFMON/SYS_ADMIN, seccomp RuntimeDefault, Secrets für SIEM-Tokens, system-node-critical-Priorität |
| ⚡ Schnell und klein | ~0,7 % CPU im Leerlauf, 0 Ring-Buffer-Drops bei 25.000 Forks, 33–43 MB RSS, abhängigkeitsfreier Go-Daemon |
| 📤 SIEM-nativ | JSON · ECS 8.11 · OCSF 1.3.0 · CEF · LEEF 2.0 → Datei/stdout/syslog/HTTPS-Webhook (Splunk HEC) mit Batching, Retry und Circuit Breaker |
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)
Voraussetzungen: Kernel ≥ 5.15 mit CONFIG_DEBUG_INFO_BTF (/sys/kernel/btf/vmlinux), root mit CAP_BPF CAP_PERFMON CAP_SYS_ADMIN. make deps/make check-env funktionieren unter Debian, Ubuntu und WSL2 (docs/WSL2.md).