Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .github/workflows/ci.yml
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@ jobs:
run: python -m unittest discover -s tests -p "test_*.py"
- name: Static security checks for hardened modules
if: runner.os == 'Linux'
run: bandit -r modules/async_scanner.py modules/brute_forcer.py modules/vuln_scanner.py modules/report_store.py -ll
run: bandit -r modules/async_scanner.py modules/brute_forcer.py modules/vuln_scanner.py modules/report_store.py modules/snmp_enum.py modules/mongodb_enum.py modules/redis_enum.py modules/database_enum.py modules/nfs_enum.py modules/rdp_enum.py modules/rtsp_enum.py modules/smtp_enum.py modules/network_services.py -ll
- name: Dependency vulnerability audit
if: runner.os == 'Linux' && matrix.python-version == '3.12'
run: pip-audit -r requirements.txt
25 changes: 25 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -55,6 +55,31 @@ This release records the feature and hardening work present on \`main\`. The rel

---

## [2.2.4b] — Beta prerelease (unreleased)

> **Beta status:** 2.2.4b is an unreleased testing candidate on `fix/2.2.4b-stabilization`. It is not an official release artifact and is not recommended for production use. The stable `main` line remains 2.2.0.

This beta concentrates on protocol wire-format correctness, evidence-based detection, CLI dispatch, and cross-platform regression coverage. No GitHub Release, tag, or PyPI distribution has been published for this candidate.

### Fixed
- Repair SNMP BER integer, OID, and response parsing; use cross-platform executable discovery for the optional snmpwalk fallback.
- Correct MongoDB OP_MSG framing and BSON lengths, nested documents, arrays, and boolean handling.
- Correct Redis RESP parsing and version extraction; only report unauthenticated INFO exposure when that command succeeds.
- Correct MySQL packet-length parsing and PostgreSQL SSLRequest/startup-message framing.
- Correct NFS RPC/XDR record lengths and export parsing; use PATH-based showmount discovery on Windows and POSIX.
- Parse RDP negotiation responses accurately and avoid inferring BlueKeep from an open port; parse RTSP status, headers, and SDP separately.
- Consume complete multiline SMTP responses and avoid claiming plaintext credential exposure solely because STARTTLS is unavailable.
- Route interactive protocol menu actions through their actual protocol modules and preserve per-port results for duplicate service names.
- Accept HTTP(S) URLs as legacy CLI scan targets and handle async scan exceptions without a missing import.

### Beta validation
- Add protocol parser and dispatch regression tests; the complete automated suite passes (48 tests).
- Extend Bandit checks to the modified protocol and aggregator modules.
- The six-job Linux/Windows matrix passes on Python 3.10, 3.11, and 3.12.
- Bandit at `-ll` reports zero medium/high findings; seven low-severity findings remain.
- The dependency audit passes on the Linux Python 3.12 job.
- CI validates automated coverage and static checks, not live interoperability with every real-world service. Continue authorized lab validation before treating the beta as production-ready.

## [Unreleased]

### Planned
Expand Down
49 changes: 47 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@
</a>
<img src="https://img.shields.io/badge/Python-3.10%2B-blue.svg" alt="Python">
<img src="https://img.shields.io/badge/Platform-Linux%20%7C%20macOS%20%7C%20Windows-lightgrey.svg" alt="Platform">
<img src="https://img.shields.io/badge/Status-Stable-brightgreen.svg" alt="Status">
<img src="https://img.shields.io/badge/Status-Beta-orange.svg" alt="Status">
<img src="https://img.shields.io/badge/Code%20Style-Black-000000.svg" alt="Black">
<img src="https://img.shields.io/badge/PRs-Welcome-brightgreen.svg" alt="PRs Welcome">
</p>
Expand All @@ -33,12 +33,57 @@

---

## 📦 Current release: 2.2.0
## 📦 Current stable release: 2.2.0

The current `main` branch contains the 2.2.0 feature set. This release builds on 2.1.0 with an additive async TCP scanner, bounded optional NVD CVE correlation, stricter CLI validation, bounded CIDR scans, safer credential-checking defaults, and more reliable report exports. See [CHANGELOG.md](CHANGELOG.md) for detailed release notes and [SECURITY.md](SECURITY.md) for supported versions and vulnerability reporting.

> **Release integrity:** this documents the `main` code state; it does not claim a GitHub Release or PyPI package has been published.

### 🧪 Beta channel: 2.2.4b Beta

> ⚠️ **Pre-release software — testing only.** The `fix/2.2.4b-stabilization` branch is a beta candidate, not a stable release. It may still contain defects or incomplete protocol coverage. Do not use it as your only security control or as the basis for production decisions.

The current `main` branch remains the stable 2.2.0 line. The **2.2.4b Beta** is a separate pre-release track focused on protocol correctness, more conservative service detection, CLI routing, and cross-platform reliability.

**Beta scope**
- Corrected SNMP BER, MongoDB OP_MSG/BSON, Redis RESP, MySQL/PostgreSQL framing, and NFS RPC/XDR handling.
- More evidence-based RDP, RTSP, and SMTP results, including removal of unsupported vulnerability conclusions.
- Fixed URL target handling, protocol-menu dispatch, async error handling, and per-port aggregation.
- Added protocol regression coverage and a Linux/Windows CI matrix.

**Validation recorded for this beta branch**
- ✅ Six CI jobs passed: Linux and Windows with Python 3.10, 3.11, and 3.12.
- ✅ The automated test suite passed (48 tests).
- ✅ Bandit at the configured `-ll` threshold reported no medium- or high-severity findings; seven low-severity findings remain.
- ✅ The dependency audit passed on the Linux Python 3.12 job.

These checks validate the automated test and static-analysis scope; they do **not** replace live interoperability testing against every supported service or guarantee that every target will be detected correctly. Validate results in an authorized lab and review findings before acting on them.

**Try the beta from source**

```bash
git clone https://github.com/ItsWanheda/SpectraScan.git
cd SpectraScan
git fetch origin
git switch --track origin/fix/2.2.4b-stabilization
python -m venv .venv
```

Activate the virtual environment, install dependencies, and run the regression suite:

```bash
# Linux / macOS
source .venv/bin/activate

# Windows PowerShell
.\.venv\Scripts\Activate.ps1

python -m pip install -r requirements.txt
python -m unittest discover -s tests -p "test_*.py"
```

**Distribution status:** this beta exists on the feature branch only. No official GitHub Release, version tag, or PyPI package has been published for 2.2.4b. The stable release remains 2.2.0 until a final release is explicitly published.

## 📑 Table of Contents

- [🎯 Why SpectraScan?](#-why-spectrascan)
Expand Down
9 changes: 7 additions & 2 deletions SECURITY.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,11 +8,16 @@ This project uses [Semantic Versioning](https://semver.org/spec/v2.0.0.html). Th

| Version line | Security support | Notes |
|---|---|---|
| **2.2.x** | ✅ Current | Preferred line; security fixes and compatible patches |
| **2.2.x (stable)** | ✅ Current | Stable line; the current `main` branch documents 2.2.0 |
| **2.2.4b Beta** | 🧪 Preview only | Unreleased branch candidate; testing only, not a supported production release |
| **2.1.x** | ⚠️ Best effort | Upgrade to 2.2.x where possible |
| **2.0.x and earlier** | ❌ Unsupported | Upgrade before relying on security fixes |

Only versions explicitly published as releases should be treated as official release artifacts. The version documented on \`main\` may be ahead of a tagged release.
Only versions explicitly published as releases should be treated as official release artifacts. The version documented on `main` may be ahead of a tagged release.

### Beta and other pre-release builds

The **2.2.4b Beta** is available only from the `fix/2.2.4b-stabilization` development branch. It has passed the documented automated Linux/Windows Python 3.10–3.12 CI matrix, but that does not establish complete protocol interoperability or production readiness. Treat it as preview software: test only in authorized, controlled environments, expect defects, and do not rely on it as the sole protection for production assets. Beta builds do not receive the same support commitment as published stable releases.

## Reporting a vulnerability

Expand Down
Loading
Loading