Skip to content

docs(prd): add PRD 0012 — A decoy nobody legitimate touches - #61

Merged
ralyodio merged 1 commit into
masterfrom
docs/prd-0012-honeypot
Jul 28, 2026
Merged

docs(prd): add PRD 0012 — A decoy nobody legitimate touches#61
ralyodio merged 1 commit into
masterfrom
docs/prd-0012-honeypot

Conversation

@ralyodio

Copy link
Copy Markdown
Contributor

Specification for the honeypot core module, listed in PRD.md and not yet specified.

Every other detection module fights the same war: separating attack from noise, paying for it in false positives, baselines and tuning. A honeypot INVERTS the problem. A service that exists for no reason, that nothing legitimate is configured to contact, has exactly one class of visitor — so any interaction is unauthorized by construction, with no baseline, no warmup and no tuning.

That makes it the highest-precision signal available on a host, and the natural corroborating detector for firewall-rules, where the open question is whether blocking should require two signals.

The catch is that it is a service deliberately inviting attackers on a customer's production host. So emulation is structural — no decoy ever executes anything or holds anything real — and captured payloads are hostile input that every downstream consumer must treat as such, since rendering them in an alert is a stored-XSS vector aimed at the defender.

Spec only — no implementation in this PR.

Every other detection module fights the same war: separating attack from noise, paying for it in false positives, baselines and tuning. A honeypot INVERTS the problem. A service that exists for no reason, that nothing legitimate is configured to contact, has exactly one class of visitor — so any interaction is unauthorized by construction, with no baseline, no warmup and no tuning.

That makes it the highest-precision signal available on a host, and the natural corroborating detector for firewall-rules, where the open question is whether blocking should require two signals.

The catch is that it is a service deliberately inviting attackers on a customer's production host. So emulation is structural — no decoy ever executes anything or holds anything real — and captured payloads are hostile input that every downstream consumer must treat as such, since rendering them in an alert is a stored-XSS vector aimed at the defender.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@ralyodio
ralyodio merged commit 9413c68 into master Jul 28, 2026
8 checks passed
@ralyodio
ralyodio deleted the docs/prd-0012-honeypot branch July 28, 2026 17:45
@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