Skip to content

Commit 8804f9d

Browse files
committed
Update to version 0.6
### [05. May 2024] - Version 0.6 - **Import File Capabilities**: Added support for importing vulnerability data directly from Nessus, Nexpose, and OpenVAS scan files. - **Expanded Command-Line Options**: Introduced new command-line options to specify the import file and its type. - **Robust Configuration Management**: Improved error handling for missing or malformed configuration files. - **General Improvements**: Various bug fixes and performance improvements.
1 parent 5243d70 commit 8804f9d

File tree

4 files changed

+345
-110
lines changed

4 files changed

+345
-110
lines changed

README.md

Lines changed: 21 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,14 +12,22 @@ SploitScan is a powerful and user-friendly tool designed to streamline the proce
1212
- **CISA KEV**: Shows if the CVE has been listed in the Known Exploited Vulnerabilities (KEV) of CISA.
1313
- **Patching Priority System**: Evaluates and assigns a priority rating for patching based on various factors including public exploits availability.
1414
- **Multi-CVE Support and Export Options**: Supports multiple CVEs in a single run and allows exporting the results to JSON and CSV formats.
15+
- **Vulnerability Scanner Import**: Import vulnerability scans from popular vulnerability scanners and search directly for known exploits.
1516
- **User-Friendly Interface**: Easy to use, providing clear and concise information.
1617
- **Comprehensive Security Tool**: Ideal for quick security assessments and staying informed about recent vulnerabilities.
1718

1819
## 💣 Supported Exploit Databases
1920

2021
- **[GitHub](https://poc-in-github.motikan2010.net/)**
2122
- **[ExploitDB](https://www.exploit-db.com/)**
22-
- **[VulnCheck](https://vulncheck.com/)** (requires a VulnCheck API key)
23+
- **[VulnCheck](https://vulncheck.com/)** (requires a **free** VulnCheck API key)
24+
25+
## 📁 Supported Vulnerability Scanner Import
26+
27+
- **[Nessus](https://www.tenable.com/products/nessus) (.nessus)**: Import vulnerability data from Tenable Nessus.
28+
- **[Nexpose](https://www.rapid7.com/products/nexpose/) (.xml)**: Integrate results from Rapid7 Nexpose scans.
29+
- **[OpenVAS](https://www.openvas.org/) (.xml)**: Use Greenbone OpenVAS scan reports to feed into SploitScan.
30+
2331

2432
## 🚀 Usage
2533

@@ -39,6 +47,12 @@ $ python sploitscan.py CVE-YYYY-NNNNN
3947
$ python sploitscan.py CVE-YYYY-NNNNN CVE-YYYY-NNNNN
4048
```
4149

50+
**Optional: Import functionality. Specify the type: 'nessus', 'nexpose' or 'openvas' and import file.**
51+
52+
```bash
53+
$ python sploitscan.py --import-file path/to/yourfile.nessus --type nessus
54+
```
55+
4256
**Optional: Export the results to a JSON or CSV file. Specify the format: 'json' or 'csv'.**
4357

4458
```bash
@@ -75,6 +89,12 @@ This system assists users in making informed decisions on which vulnerabilities
7589

7690
## 📆 Changelog
7791

92+
### [05. May 2024] - Version 0.6
93+
- **Import File Capabilities**: Added support for importing vulnerability data directly from Nessus, Nexpose, and OpenVAS scan files.
94+
- **Expanded Command-Line Options**: Introduced new command-line options to specify the import file and its type.
95+
- **Robust Configuration Management**: Improved error handling for missing or malformed configuration files.
96+
- **General Improvements**: Various bug fixes and performance improvements.
97+
7898
### [02. March 2024] - Version 0.5
7999
- **ExploitDB Integration**: Added support for fetching exploit data from ExploitDB.
80100
- **CVSS Enhancements**: Added support for CVSS 2 and CVSS 3.x

pyproject.toml renamed to debian/pyproject.toml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
44

55
[tool.poetry]
66
name = "SploitScan"
7-
version = "0.5.0"
7+
version = "0.6.0"
88
description = "A tool to fetch and display data from NVD and public exploits for given CVE IDs."
99
authors = ["Alexander Hagenah <[email protected]>"]
1010
license = "GPL-3.0"

sploitscan.1 renamed to debian/sploitscan.1

Lines changed: 48 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
.TH SploitScan 8 "Version 0.5" "SploitScan user manual"
1+
.TH SploitScan 1 "Version 0.6" "SploitScan user manual"
22
.SH NAME
33
\fBSploitScan\fP - A tool to fetch and display vulnerability information and public exploits for given CVE IDs.
44
.SH 📜 Description
@@ -19,6 +19,8 @@ SploitScan is a powerful and user\-friendly tool designed to streamline the proc
1919
.IP \(bu 2
2020
\fBMulti\-CVE Support and Export Options\fP: Supports multiple CVEs in a single run and allows exporting the results to JSON and CSV formats.
2121
.IP \(bu 2
22+
\fBVulnerability Scanner Import\fP: Import vulnerability scans from popular vulnerability scanners and search directly for known exploits.
23+
.IP \(bu 2
2224
\fBUser\-Friendly Interface\fP: Easy to use, providing clear and concise information.
2325
.IP \(bu 2
2426
\fBComprehensive Security Tool\fP: Ideal for quick security assessments and staying informed about recent vulnerabilities.
@@ -30,40 +32,65 @@ SploitScan is a powerful and user\-friendly tool designed to streamline the proc
3032
.IP \(bu 2
3133
\fBExploitDB \[la]https://www.exploit-db.com/\[ra]\fP
3234
.IP \(bu 2
33-
\fBVulnCheck \[la]https://vulncheck.com/\[ra]\fP (requires a VulnCheck API key)
35+
\fBVulnCheck \[la]https://vulncheck.com/\[ra]\fP (requires a \fBfree\fP VulnCheck API key)
36+
.RE
37+
.SH 📁 Supported Vulnerability Scanner Import
38+
.RS
39+
.IP \(bu 2
40+
\fBNessus \[la]https://www.tenable.com/products/nessus\[ra] (.nessus)\fP: Import vulnerability data from Tenable Nessus.
41+
.IP \(bu 2
42+
\fBNexpose \[la]https://www.rapid7.com/products/nexpose/\[ra] (.xml)\fP: Integrate results from Rapid7 Nexpose scans.
43+
.IP \(bu 2
44+
\fBOpenVAS \[la]https://www.openvas.org/\[ra] (.xml)\fP: Use Greenbone OpenVAS scan reports to feed into SploitScan.
3445
.RE
3546
.SH 🚀 Usage
3647
.PP
3748
\fBRegular\fP:
3849
.PP
3950
.RS
4051
.nf
41-
python sploitscan.py CVE\-YYYY\-NNNNN
52+
$ python sploitscan.py CVE\-YYYY\-NNNNN
4253
.fi
4354
.RE
4455
.PP
4556
\fBEnter one or more CVE IDs to fetch data. Separate multiple CVE IDs with spaces.\fP
4657
.PP
4758
.RS
4859
.nf
49-
python sploitscan.py CVE\-YYYY\-NNNNN CVE\-YYYY\-NNNNN
60+
$ python sploitscan.py CVE\-YYYY\-NNNNN CVE\-YYYY\-NNNNN
61+
.fi
62+
.RE
63+
.PP
64+
\fBOptional: Import functionality. Specify the type: 'nessus', 'nexpose' or 'openvas' and import file.\fP
65+
.PP
66+
.RS
67+
.nf
68+
$ python sploitscan.py \-\-import\-file path/to/yourfile.nessus \-\-type nessus
5069
.fi
5170
.RE
5271
.PP
5372
\fBOptional: Export the results to a JSON or CSV file. Specify the format: 'json' or 'csv'.\fP
5473
.PP
5574
.RS
5675
.nf
57-
python sploitscan.py CVE\-YYYY\-NNNNN \-e JSON
76+
$ python sploitscan.py CVE\-YYYY\-NNNNN \-e JSON
5877
.fi
5978
.RE
6079
.PP
6180
\fBDocker\fP
6281
.PP
6382
.RS
6483
.nf
65-
docker build \-t sploitscan .
66-
docker run \-\-rm sploitscan CVE\-2024\-1709
84+
$ docker build \-t sploitscan .
85+
$ docker run \-\-rm sploitscan CVE\-2024\-1709
86+
87+
With a volume mounted from the current directory
88+
89+
Windows (Powershell)
90+
$ docker run \-v ${PWD}:/app \-\-rm sploitscan CVE\-2024\-1709 \-e JSON
91+
92+
Linux
93+
$ docker run \-v $(pwd):/app \-\-rm sploitscan CVE\-2024\-1709 \-e JSON
6794
.fi
6895
.RE
6996
.SH 🛡️ Patching Prioritization System
@@ -88,6 +115,17 @@ D: CVSS score < 6.0 and EPSS score < 0.2. Lower severity and lower probability o
88115
.PP
89116
This system assists users in making informed decisions on which vulnerabilities to patch first, considering both their potential impact and the likelihood of exploitation. Thresholds can be changed to your business needs.
90117
.SH 📆 Changelog
118+
.SS [05. May 2024] \- Version 0.6
119+
.RS
120+
.IP \(bu 2
121+
\fBImport File Capabilities\fP: Added support for importing vulnerability data directly from Nessus, Nexpose, and OpenVAS scan files.
122+
.IP \(bu 2
123+
\fBExpanded Command\-Line Options\fP: Introduced new command\-line options to specify the import file and its type.
124+
.IP \(bu 2
125+
\fBRobust Configuration Management\fP: Improved error handling for missing or malformed configuration files.
126+
.IP \(bu 2
127+
\fBGeneral Improvements\fP: Various bug fixes and performance improvements.
128+
.RE
91129
.SS [02. March 2024] \- Version 0.5
92130
.RS
93131
.IP \(bu 2
@@ -136,10 +174,12 @@ Initial release of SploitScan.
136174
Contributions are welcome. Please feel free to fork, modify, and make pull requests or report issues.
137175
.RS
138176
.IP \(bu 2
139-
Nilsonfsilva \[la]https://github.com/Nilsonfsilva\[ra] for support on Debian packaging
177+
Nilsonfsilva \[la]https://github.com/Nilsonfsilva\[ra] for support on Debian packaging.
140178
.IP \(bu 2
141179
bcoles \[la]https://github.com/bcoles\[ra] for bugfixes.
142180
.IP \(bu 2
181+
Javier Álvarez \[la]https://github.com/jalvarezz13\[ra] for bugfixes.
182+
.IP \(bu 2
143183
Romullo \[la]https://github.com/Romullo\[ra] for ideas & suggestions.
144184
.RE
145185
.SH 📌 Author

0 commit comments

Comments
 (0)