Skip to content

v1.6.0

Latest

Choose a tag to compare

@github-actions github-actions released this 30 Oct 16:41

vulners-cli v1.6.0

Feature release powered by go-vulners v1.5.1, adding reachability-aware repository scanning, structured offline matching, and a unified scan output across host and web targets, with stricter resource bounds and security hardening.

New features

Scanning

  • Reachability-aware vulners scan repo — online Go scans use govulncheck to separate reachable findings from imported-only advisories, enriched with Vulners severity data; --fail-on ignores imported-only findings and fails closed on reachable findings with unknown severity
  • Structured offline matching — match cached bulletins by component name, version, and CPE
  • Affected-product matching — exact, wildcard, CPE, and relational version ranges shared by online and offline scans
  • Unified host and web output — scan host and scan web now emit the common components, findings, and summary structure; --plan works without connections, credential prompts, or API calls
  • Nested npm v1 lockfiles — dependencies are collected recursively and deduplicated
  • Image scan accuracy — preserve SBOM-only OS findings and use Debian package architecture from image PURLs
  • Full offline syncs — replace stored collections so bulletins deleted upstream are removed
  • go.mod path support — pass a go.mod file directly to the Go inventory collector

Configuration

  • VULNERS_HTTP_TIMEOUT / http_timeout — configure the per-request API timeout, including large offline collection downloads (default 120s)

Fixes & improvements

  • SBOM and image scans accept EPSS objects from the API and preserve nested EPSS scores
  • Normalize advisory Go pseudo-versions such as 0.0.0+20231218163308+9d2ee975ef9f
  • Read web CVSS scores from nested metric providers so --fail-on evaluates web findings correctly
  • Populate govulncheck fixed versions and CVE aliases, and merge duplicate findings for the same advisory and module
  • Prefer populated CVSS data when the API returns an empty cvss3 object alongside cvss
  • Use aggregate audit CVSS when host audit findings omit a per-vulnerability score
  • Fail without partial findings on version-range or pagination errors; offline scans fail on lookup errors
  • Usage and configuration errors now exit with code 2; runtime errors remain code 3
  • Missing API keys, unsupported output formats, and invalid --fail-on values are usage errors on every command
  • Scanner and inventory failures abort scans instead of being skipped, and output close errors are propagated
  • Scan inventories are capped at 10,000 components and online matching at 1,000 API search requests; overflow fails without a partial report
  • Require 0600 permissions for Unix config files, report files, cache databases, and SQLite sidecars, and 0750 for the .vulners directory
  • Reject passwords embedded in host URIs, validate host targets before connecting, and require a WinRM username with a warning for cleartext HTTP
  • Sanitize terminal control characters and escape Markdown output
  • Limit Go, Python, SBOM, npm lockfile, and VEX inputs to 64 MiB; cap captured host command output at 64 MiB and stderr at 1 MiB
  • Require products in OpenVEX statements and scope suppression to the matching PURL, CPE, or name@version
  • Address 13 standard-library vulnerabilities by updating to Go 1.26.10

Other changes

  • VScanner support retired — the vscan command group, client wiring, and output schemas are removed
  • Update go-vulners to v1.5.1
  • Update Go to 1.26.10, refresh dependencies, and pin goreleaser to v2.12.7
  • Reorganize documentation with the Diátaxis framework
  • Add opt-in live SBOM and web policy integration tests (just test-integration)

Full Changelog: v1.5.2...v1.6.0