Skip to content

v1.0.0

Choose a tag to compare

@BrunoAFK BrunoAFK released this 05 Apr 23:01
· 24 commits to main since this release

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.txt first 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_BUSY errors 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.txt first for Sitemap: directives (supports multiple entries)
  • Falls back to /sitemap.xml and /sitemap_index.xml
  • Uses normalizeTags: true for 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 main when docs/ 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, added deploy-static stage

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.yml links to documentation site

Upgrade Notes

  • The ssl-labs handler no longer requires network access to api.ssllabs.com. If you had firewall rules allowing that endpoint, they can be removed.
  • The tls handler no longer requires network access to tls-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.