
Auditoría solo con eBPF EDR para Linux 5.15+ LTS: 14 hooks del kernel, 15 acciones (13 técnicas MITRE), linaje de procesos, exportación a SIEM, listo para K8s/Docker.
Sensor de runtime eBPF para Linux solo de auditoría: detección de escape de contenedores, endurecido por diseño.
19 acciones de detección · 24 programas BPF · reglas de rutas resueltas por BPF-LSM · IPv6 · formato de transmisión v4
Apoya el proyecto:
[!IMPORTANT] Solo detección y auditoría, sin aplicación de bloqueos. Ningún programa BPF devuelve
-EPERM; ninguna llamada al sistema se bloquea jamás. Este es un plano de observación en tiempo de ejecución, no un plano de prevención. Consultadocs/SECURITY.mdyTHREAT_MODEL.md.
| 🎯 Archivos canario | Coloca rutas invisibles en un mapa del kernel con O(1): cualquier acceso dispara una alerta CRITICAL al instante, incluidos openat2 y sondeos de archivos inexistentes |
| 🛡️ Resistente a la evasión | openat2 interceptado · unshare(CLONE_NEWUSER) escala a CRITICAL · la autoexclusión se basa en PID (no falsificable mediante prctl) · release_agent se detecta en cualquier punto bajo /sys/fs/cgroup/ |
| 🧠 Modo BPF LSM | En kernels con bpf en la lista de LSM activos, lsm/file_open clasifica rutas resueltas por el kernel (bpf_d_path): las aperturas mediante io_uring y las carreras de cadenas de usuario se cierran en un solo paso; recurre automáticamente a los tracepoints |
| 🌐 Visión de red de pila completa | Conexiones IPv4 e IPv6 con severidad configurable para puertos sospechosos |
| 📈 Observabilidad integrada | /metrics de Prometheus implementado a mano (sin dependencias), alertas sintéticas Sensor_Heartbeat para detección de silencio en el SIEM, campos de estado degraded/last_err |
| 🏥 Autorreparación | Type=notify de systemd + WatchdogSec=30 y sondas de liveness de K8s sobre un latido de 10 s: un sensor colgado se reinicia a sí mismo (verificado en vivo con SIGSTOP) |
| 🔐 Despliegue con mínimo privilegio | privileged: false + solo CAP_BPF/PERFMON/SYS_ADMIN, seccomp RuntimeDefault, Secrets para los tokens del SIEM, prioridad system-node-critical |
| ⚡ Rápido y ligero | ~0,7 % de CPU en reposo, 0 pérdidas en el ring-buffer con 25.000 forks, 33–43 MB de RSS, demonio Go sin dependencias |
| 📤 Nativo para SIEM | JSON · ECS 8.11 · OCSF 1.3.0 · CEF · LEEF 2.0 → archivo/stdout/syslog/webhook HTTPS (Splunk HEC) con batching, reintentos y 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)
Requisitos: 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 funcionan en Debian, Ubuntu y WSL2 (docs/WSL2.md).