Skip to content

v0.2.0 — phase 1.5: privileged rules

Choose a tag to compare

@xezpeleta xezpeleta released this 04 Oct 14:28
· 71 commits to main since this release

Phase 1.5: pre-authorized root verbs — the routine you'd automate anyway (enumerated write, validate, reload) runs unattended, root included, but only through exact actions the operator wrote down.

  • Privileged rules execute as root via exact-argv sudo grants written and validated by sysh policy install: no wildcards, no ALL, no NOPASSWD: beyond the enumerated argv; no_new_privs stays on; execution happens in per-exec systemd scopes with journald + auditd events carrying PRIV=true — the record exists on both sides of the elevation
  • Privileged timeouts via sudoers TIMEOUT plus a gateway grace kill, so a hanging root verb dies at the boundary the operator set
  • sysh doctor gains the --allow-groups opt-in check (secondary groups for the sy user), and a Wazuh agent ruleset profile is documented for SIEM shipping
  • examples/webserver: a worked agent-maintained web server — Apache and fail2ban config, logs, validate, reload — with the OS-side setup and the honest limits spelled out
  • Project website with emulated session replays (an agent session and a plain-ssh session, same bounds and same record)

Honest limits: per-exec approvals still deferred (privileged-adjacent argv without a grant refuses at exit 126); no seccomp yet; amd64 only. The approval channel — root the agent can only ask for — is in main for v0.3.0.

curl -LO https://github.com/xezpeleta/sysh/releases/download/v0.2.0/sysh_0.2.0_amd64.deb
apt install ./sysh_0.2.0_amd64.deb
sysh doctor