Skip to content

docs(prd): add PRD 0007 — Tell SSH compromise apart from SSH background noise - #56

Merged
ralyodio merged 1 commit into
masterfrom
docs/prd-0007-ssh-guard
Jul 28, 2026
Merged

docs(prd): add PRD 0007 — Tell SSH compromise apart from SSH background noise#56
ralyodio merged 1 commit into
masterfrom
docs/prd-0007-ssh-guard

Conversation

@ralyodio

Copy link
Copy Markdown
Contributor

Specification for the ssh-guard core module, listed in PRD.md and not yet specified.

Any internet-facing SSH port sees thousands of failed logins a day from commodity botnets. That is weather, not an attack, and treating it as one is why most SSH monitoring produces noise nobody reads.

The rare events that matter are different in kind: a login that SUCCEEDS from somewhere unusual, a new authorized_keys entry (the standard persistence mechanism), tunneling that turns a foothold into lateral movement, and success after a failure burst. fail2ban already blocks brute force, and blocking is the least valuable half — distributed botnets rotate IPs faster than a ban list matters. The valuable half is knowing someone got in.

Spec only — no implementation in this PR.

…nd noise

Any internet-facing SSH port sees thousands of failed logins a day from commodity botnets. That is weather, not an attack, and treating it as one is why most SSH monitoring produces noise nobody reads.

The rare events that matter are different in kind: a login that SUCCEEDS from somewhere unusual, a new authorized_keys entry (the standard persistence mechanism), tunneling that turns a foothold into lateral movement, and success after a failure burst. fail2ban already blocks brute force, and blocking is the least valuable half — distributed botnets rotate IPs faster than a ban list matters. The valuable half is knowing someone got in.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@ralyodio
ralyodio merged commit d16d4c8 into master Jul 28, 2026
8 checks passed
@ralyodio
ralyodio deleted the docs/prd-0007-ssh-guard branch July 28, 2026 17:43
@github-actions

Copy link
Copy Markdown

vu1nz Security Review

0 finding(s) in PR #?

No security issues found.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant