
EDR eBPF di sola verifica per Linux 5.15+ LTS: 14 hook del kernel, 15 azioni (13 tecniche MITRE), lineage dei processi, esportazione SIEM, pronto per K8s/Docker.
Sensore runtime eBPF per Linux solo in audit - rilevamento di container escape, hardened by design.
19 azioni di rilevamento · 24 programmi BPF · regole BPF-LSM su percorsi risolti · IPv6 · wire format v4
Supporta il progetto:
[!IMPORTANT] Solo rilevamento e audit, senza enforcement. Nessun programma BPF restituisce
-EPERM; nessuna syscall viene mai bloccata. Questo è un piano di osservazione runtime, non un piano di prevenzione. Vedidocs/SECURITY.mdeTHREAT_MODEL.md.
| 🎯 File canary | Inserisci percorsi invisibili in una mappa kernel O(1) - qualsiasi accesso genera istantaneamente un avviso CRITICAL, inclusi openat2 e tentativi di accesso a file inesistenti |
| 🛡️ Resistente all'evasione | openat2 intercettato · unshare(CLONE_NEWUSER) scala a CRITICAL · l'auto-esclusione è basata sul PID (non falsificabile tramite prctl) · release_agent rilevato ovunque sotto /sys/fs/cgroup/ |
| 🧠 Modalità BPF LSM | Su kernel con bpf nella lista LSM attiva, lsm/file_open classifica i percorsi risolti dal kernel (bpf_d_path) - aperture io_uring e race sulle stringhe utente chiuse in un solo passaggio; ricade automaticamente sui tracepoint |
| 🌐 Visione di rete full-stack | Connessioni IPv4 e IPv6 con severità configurabile per porte sospette |
| 📈 Osservabilità integrata | /metrics Prometheus scritto a mano (zero dipendenze), avvisi sintetici Sensor_Heartbeat per il rilevamento del silenzio SIEM, campi di stato degraded/last_err |
| 🏥 Auto-ripristino | systemd Type=notify + WatchdogSec=30 e probe di liveness K8s su un heartbeat di 10s - un sensore bloccato si riavvia da solo (verificato dal vivo con SIGSTOP) |
| 🔐 Deployment con privilegi minimi | privileged: false + solo CAP_BPF/PERFMON/SYS_ADMIN, seccomp RuntimeDefault, Secrets per i token SIEM, priorità system-node-critical |
| ⚡ Veloce e leggero | ~0,7% CPU in idle, 0 drop del ring-buffer a 25.000 fork, 33–43 MB RSS, daemon Go senza dipendenze |
| 📤 SIEM-native | JSON · ECS 8.11 · OCSF 1.3.0 · CEF · LEEF 2.0 → file/stdout/syslog/webhook HTTPS (Splunk HEC) con batching, retry e 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)
Requisiti: kernel ≥ 5.15 con CONFIG_DEBUG_INFO_BTF (/sys/kernel/btf/vmlinux), root con CAP_BPF CAP_PERFMON CAP_SYS_ADMIN. make deps/make check-env funzionano su Debian, Ubuntu e WSL2 (docs/WSL2.md).