Skip to content

v0.1.0 — phase 1

Choose a tag to compare

@xezpeleta xezpeleta released this 03 Oct 09:56
· 89 commits to main since this release

First tagged release: the complete phase-1 control layer.

What it is: agents connect as the unprivileged sy user over SSH; the login shell (/usr/bin/sysh) enforces an operator-written argv policy with no shell semantics, and records everything server-side (journald + auditd, kernel-attested).

  • Gateway: printable-ASCII argv split, exact-length matching, opt-in rest patterns, deny rules with prefix semantics, per-rule timeouts with process-group kill backstop, 1 MiB output cap
  • Containment: NoNewPrivs, systemd scope execution (no-scope fallback), ptrace_scope=1, root-only policy tree
  • Observability: journald events with key attribution (fingerprint, key id), policy hash, pre/post phases; auditd keys sysh_exec / sysh_policy / sysh_lockdown
  • Operator channel: sysh auth add/list/remove (option allowlist, canonical lines), sysh policy install/lint (denylist, warn-ack, permissive gated on auditd), sysh doctor (22 checks), sysh lockdown, sysh journal-group
  • One static Go binary, one .deb that does all host-local setup; snapshot-tested on Debian 12 (deployed and cold-reboot verified)

Honest limits: no seccomp yet (phase 2), approvals deferred (privileged rules refuse at exit 126), amd64 only.

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