
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 열기와 사용자 문자열 경쟁 조건을 한 번에 해결하며, 자동으로 tracepoint로 폴백 |
| 🌐 풀스택 네트워크 가시성 | IPv4 및 IPv6 연결, 의심스러운 포트 심각도 설정 가능 |
| 📈 내장 관측성 | 직접 구현한 Prometheus /metrics(의존성 제로), SIEM 침묵 탐지를 위한 Sensor_Heartbeat 합성 경고, degraded/last_err 상태 필드 |
| 🏥 자가 복구 | systemd Type=notify + WatchdogSec=30 및 10초 하트비트 기반 K8s 라이브니스 프로브 - 멈춘 센서는 스스로 재시작(SIGSTOP으로 실제 검증 완료) |
| 🔐 최소 권한 배포 | privileged: false + CAP_BPF/PERFMON/SYS_ADMIN만 사용, seccomp RuntimeDefault, SIEM 토큰용 Secrets, system-node-critical 우선순위 |
| ⚡ 빠르고 가벼움 | 유휴 CPU 약 0.7%, 25,000회 fork에서 링 버퍼 드롭 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)
요구 사항: CONFIG_DEBUG_INFO_BTF(/sys/kernel/btf/vmlinux)가 활성화된 커널 ≥ 5.15, CAP_BPF CAP_PERFMON CAP_SYS_ADMIN 권한을 가진 root. 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 · 쓰기 의도 열기 (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)에 대한 두 가지 탐지 클래스:
open/openat/openat2 tracepoint에서 발생합니다. 대상 파일이 존재하지 않더라도 syscall 진입 시점에 발생하며, cgroup-v2 호스트에서는 release_agent를 탐색하는 것 자체가 공격입니다.bpf가 포함된 경우 lsm/file_open이 담당하며(bpf_d_path를 통한 커널 해석 경로, io_uring open 포함), 그렇지 않으면 tracepoint가 담당합니다. 어느 경우든 open당 정확히 하나의 이벤트가 발생합니다.