Repository navigation
v1.0.0
v1.0.0
The first stable release of recon-web — 39 checks, 3 interfaces, fully self-hosted.
Highlights
- Self-hosted SSL grading — no more dependency on SSL Labs API. Grades A+ to F computed locally using Node.js TLS, checking protocol version, cipher strength, certificate validity, forward secrecy, and HSTS. Results are instant (~1s).
- Documentation site — 24-page Astro Starlight docs site with full-text search (Pagefind), dark/light theme, and detailed explanations of all 39 checks including what a good result looks like.
- Rewritten handlers — sitemap, TLS, TXT records, and SSL grade handlers rebuilt for reliability.
Bug Fixes
- Scan completion page refresh — live scan results now update in-place when the scan completes instead of triggering a full page reload.
- Sort reading order — replaced CSS columns with a DOM-aware JS masonry grid that keeps correct left-to-right sort order while maintaining tight vertical packing.
- Sitemap detection — handler now checks
robots.txtfirst for sitemap directives, then falls back to common paths (/sitemap.xml,/sitemap_index.xml). Handles case-insensitive XML tags. - TXT records — added root domain fallback when subdomain has no TXT records (e.g.,
www.example.com→example.com). Fixed duplicate key handling and renderer. - TXT records renderer — now supports key-value format returned by the handler, previously only recognized array format.
- Search input — removed duplicate X button caused by
type="search"native clear button overlapping custom clear button. - SQLite test isolation — each API test file uses a unique temporary database to prevent
SQLITE_BUSYerrors in parallel CI runs.
New Features
Self-Hosted SSL Grade (replaces SSL Labs API)
The ssl-labs handler no longer calls the Qualys SSL Labs API. Instead, it connects directly to the target using Node.js tls module and computes a grade based on:
| Check | A+ | A | B | C/D | F |
|---|---|---|---|---|---|
| Protocol | TLS 1.3 | TLS 1.2 | — | TLS 1.0/1.1 | SSL/no TLS |
| Cipher | AEAD | AEAD | CBC | — | RC4/DES/NULL |
| Certificate | Trusted, >30d | Trusted | Trusted, <30d | — | Expired/untrusted |
| Forward secrecy | ECDHE/DHE | ECDHE/DHE | — | None | — |
| HSTS | ≥1 year | Present | — | Missing | — |
The renderer shows a detailed checklist of each check with pass/fail status.
Native TLS Handler
Replaced the dead Mozilla TLS Observatory API (tls-observatory.services.mozilla.com) with a native Node.js tls connection that returns protocol version, cipher suite, and certificate details directly.
Rewritten Sitemap Handler
- Checks
robots.txtfirst forSitemap:directives (supports multiple entries) - Falls back to
/sitemap.xmland/sitemap_index.xml - Uses
normalizeTags: truefor case-insensitive XML parsing - Recursively extracts all
<loc>values regardless of nesting - Returns structured data:
{ sitemapUrl, source, type, urls }
Documentation
New Astro Starlight documentation site at docs/ with 24 pages:
- Getting Started — Quick Start, Configuration, Your First Scan
- Guides — Web UI, REST API, CLI, Scheduled Scans, Notifications
- Checks Reference — all 39 checks explained with what they do, why they matter, what good/bad results look like
- Deployment — Docker (local build), Docker (pre-built images), Kubernetes (Helm), Standalone (Node.js)
- Development — Architecture, Contributing, Adding a Check
Features: Pagefind full-text search, dark/light theme, edit-on-GitHub links, responsive sidebar.
CI/CD
- GitHub Pages workflow — deploys docs on push to
mainwhendocs/changes - Cloudflare Pages workflow — deploys static lite scan on release or manual trigger (GitHub Actions + GitLab CI)
- GitLab CI — updated Docker registry auth to
CI_JOB_TOKEN, addeddeploy-staticstage
UI Changes
- Footer simplified to single line: brand, Docs, GitHub, © Bruno Pavelja
- "SSL Labs Grade" renamed to "SSL Grade"
- Masonry grid layout with DOM-measured shortest-column-first balancing
Other
- README rewritten with one-liner quick start, full 39-check reference table, and deployment guide links
- PR template and issue templates (bug report, feature request) added
.github/ISSUE_TEMPLATE/config.ymllinks to documentation site
Upgrade Notes
- The
ssl-labshandler no longer requires network access toapi.ssllabs.com. If you had firewall rules allowing that endpoint, they can be removed. - The
tlshandler no longer requires network access totls-observatory.services.mozilla.com. - Sitemap handler returns a new data structure (
{ sitemapUrl, source, type, urls }) instead of raw xml2js output. If you consume the API programmatically, update your parsing. - TXT records handler returns a key-value object instead of the previous format. Keys without
=are stored as-is. Duplicate keys get(2),(3)suffixes.