enodia-sentinal/enodia_sentinel/detectors/new_suid.py
Luna 586f74b929 Relicense under GPL-3.0-or-later
Replace MIT with the full GNU GPLv3 text, update license metadata in
pyproject.toml (+ trove classifiers) and PKGBUILD, and add
SPDX-License-Identifier headers to all Python modules and shell scripts.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-05-31 06:52:34 -07:00

36 lines
1.3 KiB
Python

# SPDX-License-Identifier: GPL-3.0-or-later
"""new_suid — a SUID/SGID binary that wasn't in the baseline.
A new setuid binary is a privilege-escalation persistence trick; one in a
world-writable dir (``/tmp``, ``/home`` …) is almost never legitimate, so it is
escalated to CRITICAL. The filesystem walk is expensive, so the daemon only
populates ``state.suid_binaries`` on its slow scan cadence — when it's absent
this detector is a no-op.
"""
from __future__ import annotations
from collections.abc import Iterator
from ..alert import Alert, Severity
from ..config import Config
from ..system import SystemState
def detect(state: SystemState, cfg: Config) -> Iterator[Alert]:
if state.suid_binaries is None or state.suid_baseline is None:
return
for path in state.suid_binaries:
if path in state.suid_baseline:
continue
hot = any(
path.startswith(d.rstrip("/") + "/") for d in cfg.suid_hot_dirs
)
yield Alert(
severity=Severity.CRITICAL if hot else Severity.HIGH,
signature="new_suid",
key=f"suid:{path}",
detail=(
("SUID/SGID binary in writable dir: " if hot
else "new SUID/SGID binary: ") + path
),
)