0eb5077551
Closes polling's blind spot (processes that exit between sweeps) with a real
eBPF probe and a declarative, data-driven detection engine — inspired by Snort
(rule language, signature IDs) and OSSEC (host-IDS framing).
New events/ subpackage:
- bcc_source.py : eBPF C tracing execve (filename, argv[1..2], ppid, uid,
parent comm) over a perf buffer, loaded via bcc; lazy import
+ available()/try-except so it fails closed to poll-only when
bcc/root/BTF are absent — a broken probe never downs the daemon
- exec_event.py : the ExecEvent type
- rules.py : ExecRule (sid/msg/severity/classtype + path/exec/parent/argv
conditions) and ExecRuleEngine; 4 shipped rules (fileless exec
100001, reverse-shell argv 100002, web/DB→shell RCE 100003,
curl|sh 100004); operators add more via exec_rules_file TOML
- monitor.py : runs the source on a thread, routes events through the engine
Integration:
- daemon starts the monitor, shares a lock-guarded cooldown with the sweep
loop, and feeds event alerts into the same snapshot pipeline
- Alert gains Snort-style sid + classtype; retrofitted onto all 7 poll
detectors; snapshots and JSON now carry them
- config: ebpf_exec_monitor (default on, degrades), exec_rules_file
- systemd: opt-in ebpf.conf drop-in (relaxes MemoryDenyWriteExecute + widens
caps for bcc's JIT) so the base unit stays hardened for poll-only
- sentinel-redteam: ebpf_exec drill (short-lived /tmp exec + /dev/tcp argv the
poller can't see); footer now uses the Python CLI
Tests: +14 cases for the rule engine (each default rule match/non-match, rule
validation, parent-exclude). 39/39 pass. Graceful non-root degradation verified.
NOTE: the eBPF C follows bcc's execsnoop pattern but could not be run here
(BPF needs root); it wants a root smoke-test on a real host.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
51 lines
1.7 KiB
Python
51 lines
1.7 KiB
Python
# SPDX-License-Identifier: GPL-3.0-or-later
|
|
"""ld_preload — userland rootkit / library-injection indicators.
|
|
|
|
Two signatures:
|
|
* ``/etc/ld.so.preload`` non-empty: injects into *every* dynamically-linked
|
|
process — the classic system-wide rootkit hook.
|
|
* a process whose ``LD_PRELOAD`` points into a writable/temp dir — per-process
|
|
function hooking (hiding files/procs, stealing credentials).
|
|
"""
|
|
from __future__ import annotations
|
|
|
|
from collections.abc import Iterator
|
|
from pathlib import Path
|
|
|
|
from ..alert import Alert, Severity
|
|
from ..config import Config
|
|
from ..system import SystemState
|
|
|
|
_SUSPICIOUS_PREFIXES = ("/tmp/", "/dev/shm/", "/var/tmp/", "/run/user/", "./")
|
|
|
|
|
|
def detect(state: SystemState, cfg: Config) -> Iterator[Alert]:
|
|
preload = Path("/etc/ld.so.preload")
|
|
try:
|
|
contents = preload.read_text().strip() if preload.is_file() else ""
|
|
except OSError:
|
|
contents = ""
|
|
if contents:
|
|
yield Alert(
|
|
severity=Severity.CRITICAL,
|
|
signature="ld_preload",
|
|
key="ldp:global",
|
|
detail=f"/etc/ld.so.preload is non-empty: [{contents.replace(chr(10), ' ')}]",
|
|
sid=100011,
|
|
classtype="rootkit-preload",
|
|
)
|
|
|
|
for proc in state.processes:
|
|
pre = proc.environ.get("LD_PRELOAD", "")
|
|
if not pre:
|
|
continue
|
|
if pre.startswith(_SUSPICIOUS_PREFIXES):
|
|
yield Alert(
|
|
severity=Severity.CRITICAL,
|
|
signature="ld_preload",
|
|
key=f"ldp:{proc.pid}",
|
|
detail=f"pid={proc.pid} comm={proc.comm} LD_PRELOAD=[{pre}]",
|
|
pids=(proc.pid,),
|
|
sid=100011,
|
|
classtype="rootkit-preload",
|
|
)
|