peripheral-forensic is designed to parse untrusted Windows
device-installation logs — including those acquired from compromised or
actively hostile systems. Hostile input is the expected case, not an edge case.
Robustness against crafted logs, malformed headers, and garbled encodings is a
core design goal, and we take reports of crashes, hangs, or memory-safety issues
seriously.
| Version | Supported |
|---|---|
| 0.1.x | ✅ — current release line, receives security fixes |
| < 0.1 | ❌ — pre-release, unsupported |
Security fixes are released against the latest published 0.1.x line.
Do not open a public GitHub issue for a security vulnerability.
Report privately, by either:
- GitHub Security Advisories — open a private advisory on the
peripheral-forensicrepository, or - Email — albert@securityronin.com.
Please include:
- the affected version and target triple,
- a minimal reproducing log or byte buffer (a fuzz corpus entry is ideal),
- the observed behaviour (panic, hang, excessive allocation, mis-parse) and the expected behaviour.
We aim to acknowledge a report within a few business days and to coordinate disclosure once a fix is available.
peripheral-forensic is hardened against adversarial input by construction:
#![forbid(unsafe_code)]across both crates — nounsafe, no C bindings, no FFI, anywhere.- No panics on malicious input — parsing is lenient (lossy UTF-8) and bounds-checked; a truncated or garbled log degrades line-by-line rather than crashing. Arithmetic is checked or saturating.
- No length is trusted — VID/PID/serial extraction reads only the leading hex run of each field and range-checks every timestamp component.
- Fail loud where it matters — a genuine error surfaces with context rather than as a silent default or a silently-wrong parse.
Continuous fuzzing with cargo-fuzz
backs the hardening above. Two targets cover the parser that consumes
attacker-controlled bytes:
| Target | Surface |
|---|---|
setupapi |
setupapi.dev.log / setupapi.log header parsing (Vista+ and XP) |
forensic |
the full parse → audit pipeline |
Panics found by fuzzing are fixed and pinned as regression tests.
For how to run the targets yourself, see CONTRIBUTING.md.