Files
mtusi2026lab7/student-tests/check_hardening.py
T

123 lines
7.4 KiB
Python
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
"""lab7: проверка hardening контейнеров.
python student-tests/check_hardening.py # по docker compose config (стенд не нужен)
python student-tests/check_hardening.py --runtime # плюс docker inspect запущенных контейнеров
Для каждого сервиса: нет privileged / host network / Docker socket; cap_drop ALL и никаких cap_add
(кроме объяснённых исключений); no-new-privileges; корневая ФС только для чтения; не root; лимиты CPU, RAM, PID;
наружу (на 127.0.0.1) опубликованы только TLS-ingress и локальные админ-интерфейсы.
Исключения перечислены в EXCEPTIONS с причиной; результат — evidence/hardening.json.
"""
import json
import subprocess
import sys
from common import EVIDENCE, ROOT
# сервис -> {проверка: причина исключения}
EXCEPTIONS = {
"rabbitmq": {"read_only": "Erlang/RabbitMQ пишет cookie, схему и plugins-expand в /var/lib/rabbitmq и "
"служебные файлы в /etc/rabbitmq при старте; данные — в volume, корень оставлен "
"записываемым, но без capabilities, не root (user rabbitmq) и с no-new-privileges"},
"telemetry-init": {"cap_add": "одноразовый chown volumes Loki/Tempo для uid 10001: только CAP_CHOWN, "
"без сети (network_mode none), сразу завершается",
"non_root": "chown требует uid 0 (+CAP_CHOWN)"},
"otel-collector": {"network": "network_mode service:otel-gate — общий namespace с mTLS-шлюзом, Collector "
"слушает только 127.0.0.1"},
}
# Образы, где не-root задан в самом образе (USER), а не в compose
IMAGE_USER = {"api": "10001 (Dockerfile)", "worker": "10001 (Dockerfile)", "dispatcher": "10001 (Dockerfile)",
"janitor": "10001 (Dockerfile)", "migrate": "10001 (Dockerfile)", "s3-init": "10001 (Dockerfile)",
"probe": "10001 (Dockerfile)", "lb": "haproxy (образ)", "otel-gate": "haproxy (образ)",
"otel-collector": "10001 (образ)", "prometheus": "nobody (образ)", "loki": "10001 (образ)",
"tempo": "10001 (образ)", "grafana": "472 (образ)"}
ALLOWED_PORTS = {8443: "HTTPS ingress (lb)", 8404: "статистика HAProxy, mTLS оператора",
8200: "OpenBao (оператор: unseal/настройка)", 9090: "Prometheus (mTLS)", 3100: "Loki (mTLS)",
3200: "Tempo (mTLS)", 3000: "Grafana (HTTPS + пароль)"}
def compose_config():
result = subprocess.run(["docker", "compose", "--profile", "tools", "config", "--format", "json"], cwd=ROOT,
capture_output=True, check=True)
return json.loads(result.stdout)["services"]
def static_checks(services):
rows = []
def add(service, check, ok, detail=""):
reason = EXCEPTIONS.get(service, {}).get(check)
status = "PASS" if ok else ("EXCEPTION" if reason else "FAIL")
rows.append({"service": service, "check": check, "status": status, "detail": reason or detail})
for name, svc in sorted(services.items()):
add(name, "not_privileged", not svc.get("privileged"))
mode = svc.get("network_mode", "")
add(name, "network", mode != "host" and not mode.startswith("service:") or mode == "none", mode)
mounts = [v.get("source", "") for v in svc.get("volumes", []) if isinstance(v, dict)]
add(name, "no_docker_socket", not any("docker.sock" in m for m in mounts))
add(name, "cap_drop_all", "ALL" in (svc.get("cap_drop") or []))
add(name, "cap_add", not svc.get("cap_add"), ",".join(svc.get("cap_add") or []))
add(name, "no_new_privileges", any("no-new-privileges" in o for o in svc.get("security_opt") or []))
add(name, "read_only", bool(svc.get("read_only")))
user = str(svc.get("user", "") or "")
add(name, "non_root", (user not in ("", "0", "root", "0:0") or name in IMAGE_USER)
and not user.startswith("root") and not user.startswith("0:"), user or IMAGE_USER.get(name, "image default"))
limits = (svc.get("deploy") or {}).get("resources", {}).get("limits", {})
add(name, "limits_cpu_mem_pids", bool(limits.get("cpus") and limits.get("memory") and limits.get("pids")),
json.dumps(limits))
for port in svc.get("ports", []):
published = int(port.get("published", 0))
ok = port.get("host_ip") == "127.0.0.1" and published in ALLOWED_PORTS
add(name, f"port_{published}", ok, f"{port.get('host_ip')}:{published} — {ALLOWED_PORTS.get(published, '?')}")
return rows
def runtime_checks():
ids = subprocess.run(["docker", "compose", "ps", "-q"], cwd=ROOT, capture_output=True, text=True,
check=True).stdout.split()
rows = []
if not ids:
return rows
data = json.loads(subprocess.run(["docker", "inspect", *ids], capture_output=True, check=True).stdout)
for c in data:
name = c["Config"]["Labels"].get("com.docker.compose.service", c["Name"])
host = c["HostConfig"]
rows.append({"service": name, "container": c["Id"][:12], "user": c["Config"].get("User") or "image default",
"privileged": host.get("Privileged"), "readonly_rootfs": host.get("ReadonlyRootfs"),
"cap_drop": host.get("CapDrop"), "cap_add": host.get("CapAdd"),
"security_opt": host.get("SecurityOpt"), "network_mode": host.get("NetworkMode"),
"memory": host.get("Memory"), "nano_cpus": host.get("NanoCpus"),
"pids_limit": host.get("PidsLimit"),
"ports": {k: v for k, v in (c["NetworkSettings"].get("Ports") or {}).items() if v}})
return rows
def main():
rows = static_checks(compose_config())
bad = [r for r in rows if r["status"] == "FAIL"]
for r in rows:
if r["status"] != "PASS":
print(f"{r['status']:<9} {r['service']:<15} {r['check']:<20} {r['detail'][:150]}")
counts = {s: sum(1 for r in rows if r["status"] == s) for s in ("PASS", "EXCEPTION", "FAIL")}
print(f"static: {counts}")
out = {"static": rows}
if "--runtime" in sys.argv:
out["runtime"] = runtime_checks()
for r in out["runtime"]:
print(f"runtime {r['service']:<15} user={r['user']:<12} ro={r['readonly_rootfs']} priv={r['privileged']} "
f"capdrop={r['cap_drop']} capadd={r['cap_add']} nnp={'no-new-privileges:true' in (r['security_opt'] or [])} "
f"mem={r['memory']} pids={r['pids_limit']} ports={list(r['ports'])}")
if r["privileged"] or r["network_mode"] == "host":
bad.append(r)
(EVIDENCE / "hardening.json").write_text(json.dumps(out, ensure_ascii=False, indent=1), encoding="utf-8")
if bad:
print(f"FAIL: {len(bad)} hardening violation(s)")
raise SystemExit(1)
print("PASS: no privileged/host network/docker.sock; caps dropped; no-new-privileges; read-only roots; "
"non-root; CPU/RAM/PID limits; only 127.0.0.1 ports — exceptions are explained")
if __name__ == "__main__":
main()