
Audit uniquement EDR eBPF pour Linux 5.15+ LTS : 14 hooks noyau, 15 actions (13 techniques MITRE), lignage de processus, export SIEM, prêt pour K8s/Docker.
Capteur d'exécution eBPF pour Linux en audit seul - détection d'évasion de conteneur, durci par conception.
19 actions de détection · 24 programmes BPF · règles de chemin résolu BPF-LSM · IPv6 · format de trame v4
Soutenir le projet :
[!IMPORTANT] Détection et audit uniquement, sans application de règles. Aucun programme BPF ne renvoie
-EPERM; aucun appel système n'est jamais bloqué. Il s'agit d'un plan d'observation à l'exécution, non d'un plan de prévention. Voirdocs/SECURITY.mdetTHREAT_MODEL.md.
| 🎯 Fichiers canaris | Placez des chemins invisibles dans une map noyau en O(1) - tout accès déclenche instantanément une alerte CRITICAL, y compris openat2 et les sondes de fichiers inexistants |
| 🛡️ Résistant à l'évasion | openat2 intercepté · unshare(CLONE_NEWUSER) escalade en CRITICAL · l'auto-exclusion est basée sur le PID (non falsifiable via prctl) · release_agent détecté n'importe où sous /sys/fs/cgroup/ |
| 🧠 Mode BPF LSM | Sur les noyaux avec bpf dans la liste LSM active, lsm/file_open classe les chemins résolus par le noyau (bpf_d_path) - les ouvertures io_uring et les courses sur chaînes utilisateur sont fermées en une seule étape ; bascule automatiquement vers les tracepoints |
| 🌐 Vision réseau complète | Connexions IPv4 et IPv6 avec sévérité configurable pour les ports suspects |
| 📈 Observabilité intégrée | /metrics Prometheus fait main (zéro dépendance), alertes synthétiques Sensor_Heartbeat pour la détection de silence SIEM, champs de santé degraded/last_err |
| 🏥 Auto-réparation | systemd Type=notify + WatchdogSec=30 et sondes de liveness K8s sur un heartbeat de 10s - un capteur bloqué se redémarre lui-même (vérifié en direct avec SIGSTOP) |
| 🔐 Déploiement au moindre privilège | privileged: false + CAP_BPF/PERFMON/SYS_ADMIN uniquement, seccomp RuntimeDefault, Secrets pour les jetons SIEM, priorité system-node-critical |
| ⚡ Rapide et léger | ~0,7 % de CPU au repos, 0 perte de ring-buffer à 25 000 forks, 33–43 Mo de RSS, démon Go sans dépendance |
| 📤 Natif SIEM | JSON · ECS 8.11 · OCSF 1.3.0 · CEF · LEEF 2.0 → fichier/stdout/syslog/webhook HTTPS (Splunk HEC) avec traitement par lots, nouvelle tentative et disjoncteur |
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)
Prérequis : noyau ≥ 5.15 avec CONFIG_DEBUG_INFO_BTF (/sys/kernel/btf/vmlinux), root avec CAP_BPF CAP_PERFMON CAP_SYS_ADMIN. make deps/make check-env fonctionnent sur Debian, Ubuntu et WSL2 (docs/WSL2.md).