Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/scmanjarrez/CVEScannerV2

Nmap script that scans for probable vulnerabilities based on services discovered in open ports.
https://github.com/scmanjarrez/CVEScannerV2

exploit exploit-db metasploit nmap nmap-scan nmap-scan-script nmap-script nmap-scripts nse nsescript penetration-testing security security-audit security-scanner vulnerability vulnerability-databases vulnerability-detection vulnerability-identification vulnerability-scanners vulnerability-scanning

Last synced: 21 days ago
JSON representation

Nmap script that scans for probable vulnerabilities based on services discovered in open ports.

Host: GitHub
URL: https://github.com/scmanjarrez/CVEScannerV2
Owner: scmanjarrez
License: gpl-3.0
Created: 2021-08-11T12:57:45.000Z (over 3 years ago)
Default Branch: master
Last Pushed: 2024-04-25T12:20:34.000Z (8 months ago)
Last Synced: 2024-08-05T17:44:14.739Z (4 months ago)
Topics: exploit, exploit-db, metasploit, nmap, nmap-scan, nmap-scan-script, nmap-script, nmap-scripts, nse, nsescript, penetration-testing, security, security-audit, security-scanner, vulnerability, vulnerability-databases, vulnerability-detection, vulnerability-identification, vulnerability-scanners, vulnerability-scanning
Language: Lua
Homepage:
Size: 12.5 MB
Stars: 79
Watchers: 4
Forks: 13
Open Issues: 3
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

awesome-hacking-lists - scmanjarrez/CVEScannerV2 - Nmap script that scans for probable vulnerabilities based on services discovered in open ports. (Lua)

README

# Description
Nmap script that provides information about probable vulnerabilities based on discovered services.

**Contents:**
- [Technical details](#technical-details)
- [Requirements](#requirements)
- [Optional](#optional)
- [Execution](#execution)
- [Output](#output)
- [Errors and fixes](#errors-and-fixes)
- [Blocked IP](#blocked-ip)
- [Missing luasql](#missing-luasql)
- [Docker container](#docker-container)
- [Acknowledgements](#acknowledgements)
- [License](#license)

# Technical details
The current implementation take care of the following cases:

- If Nmap detects:
- `cpe` **AND** `version`: vulnerabilities affecting `version` and
vulnerabilities affecting a range of versions that include `version`.
- `cpe` **AND** `version range`: vulnerabilities affecting versions
between `version range` (included).
- `cpe` but **NO** `version`: vulnerabilities that affect
every version of the product.
- If no vulnerabilities were found with `cpe` and `version`
returned from Nmap, HTTP detection is used.
- **NO** `cpe`: HTTP detection is used.

- HTTP detection:
- Used only if port matches **HTTP**/**SSL**/**UPnP**.
- An HTTP GET request is sent for every combination of _path_
and _extension_ in `extra/http-paths-vulnerscom.json`, comparing
the request headers/body with the regexes in
`extra/http-regex-vulnerscom.json`.
- Finally, the _home_ page html is analyzed in search for library paths.
The script tries to obtain the name and version from library location;
then does an HTTP GET to that path in order to inspect the code
of the library and analyze the starting commenot looking for the version.

> Nmap library shortport is used to detect if port matches HTTP/SSL.

# Requirements
In order to run **cvescannerv2** script, you need the following files present
in your working directory
- CVE database: `cve.db`
- Paths file: `extra/http-paths-vulnerscom.json`
- Regex file: `extra/http-regex-vulnerscom.json`
- Product-aliases file: `extra/product-aliases.json`

In addition, you must have installed `lua-sql-sqlite3` (ubuntu)
or `lua5.4-sql-sqlite3` (alpine) packages

## Optional
If you don't have the database `cve.db`, you can build it
using the script `extra/database.py` or download a (semiupdated) copy
from [CVEScannerV2DB](https://github.com/scmanjarrez/CVEScannerV2DB) using `.sql` files
or under Actions->Latest->Summary->Artifacts

> This repository is updated every two weeks

```bash
pip install -r extra/requirements.txt
python extra/database.py
```

```bash
git clone https://github.com/scmanjarrez/CVEScannerV2DB
cd CVEScannerV2DB && sh build.sh
```

> **Note:** In order to execute `extra/database.py`, you need to
> [request an API key](https://nvd.nist.gov/developers/request-an-api-key)
> and save it to a file named `.api` on your current working directory
> or in the environment variable `NVD_KEY`.

# Execution
To run the script, use the following syntax
```
nmap -sV --script cvescannerv2
nmap -sV --script cvescannerv2 --script-args log=logfile.log,json=logfile.json
```

It is possible to modify the behaviour to some extent using the
following arguments: db, maxcve, http, maxredirect, log, json,
path, regex, aliases, service and version.

script-args default values

db: cve.db
maxcve: 10
http: 1
maxredirect: 1
log: cvescannerv2.log
json: cvescannerv2.json
path: extra/http-paths-vulnerscom.json
regex: extra/http-regex-vulnerscom.json
aliases: extra/product-aliases.json
service: all
version: all

script-args examples

nmap -sV --script cvescannerv2 --script-args db=cve.db
nmap -sV --script cvescannerv2 --script-args maxcve=5

# Change reports path
nmap -sV --script cvescannerv2 --script-args log=scan2023.log,json=scan2023.json

# Only scan certain service/version
nmap -sV --script cvescannerv2 --script-args service=http_server,version=2.4.57

# Disable HTTP detection
nmap -sV --script cvescannerv2 --script-args http=0

> **Note**: `cvescannerv2.nse` can be placed in Nmap default script directory
> for global execution.
>
> - Linux and OSX default script locations:
> - /usr/local/share/nmap/scripts/
> - /usr/share/nmap/scripts/
> - /opt/local/share/nmap/scripts/
> - /usr/local/Cellar/nmap/<version>/share/nmap/scripts/
>
> - Windows default script locations:
> - C:\Program Files\Nmap\Scripts
> - %APPDATA%\nmap
>
> It's recommended to create a **symbolic link**, so changes in repository are reflected
> in the script.

## Output
CVEScannerV2 will show CVEs related to every `service-version` discovered.
> **Note**: This script depends on heuristics implemented in Nmap, so if it doesn't
> detect a service or is detected incorrectly, CVEScannerV2 will show an incorrect output.

Nmap output

Log file **\*.log** contains every _exploit/metasploit_ found.

cvescannerv2.log

## 2023-08-26T14:38:30+00:00

[*] host: 192.168.69.129
[*] port: 22
[+] protocol: tcp
[+] service: ssh
[+] cpe: cpe:/a:openbsd:openssh:4.7p1
[+] product: openssh
[+] version: 4.7
[+] vupdate: p1
[+] cves: 38
[-] id: CVE-2016-1908 cvss_v2: 7.5 cvss_v3: 9.8
[-] id: CVE-2023-38408 cvss_v2: nil cvss_v3: 9.8
...
[-] id: CVE-2016-6515 cvss_v2: 7.8 cvss_v3: 7.5
[!] ExploitDB:
[#] name: nil
[#] id: 40888
[#] url: https://www.exploit-db.com/exploits/40888
[-] id: CVE-2010-4478 cvss_v2: 7.5 cvss_v3: -
...
-------------------------------------------------
[*] host: 192.168.69.129
[*] port: 3306
[+] protocol: tcp
[+] service: mysql
[+] cpe: cpe:/a:mysql:mysql:5.0.51a-3ubuntu5
[+] product: mysql
[+] version: 5.0.51
[+] vupdate: a
[+] cves: 212
[-] id: CVE-2009-2446 cvss_v2: 8.5 cvss_v3: -
...
[-] id: CVE-2009-4484 cvss_v2: 7.5 cvss_v3: -
[!] Metasploit:
[#] name: exploit/linux/mysql/mysql_yassl_getname
[-] id: CVE-2008-0226 cvss_v2: 7.5 cvss_v3: -
[!] Metasploit:
[#] name: exploit/linux/mysql/mysql_yassl_hello
[#] name: exploit/windows/mysql/mysql_yassl_hello
...

Log file **\*.json** contains the same information but formatted as **json**

cvescannerv2.json

{
"192.168.69.129": {
"ports": {
"22/tcp": {
"services": [
{
"vupdate": "p1",
"vulnerabilities": {
"total": 38,
"info": "scan",
"cves": {
"CVE-2014-1692": {
"cvssv2": 7.5,
"cvssv3": "-"
},
...
"CVE-2016-6210": {
"cvssv3": 5.9,
"exploitdb": [
{
"id": 40113,
"url": "https://www.exploit-db.com/exploits/40113"
},
{
"id": 40136,
"url": "https://www.exploit-db.com/exploits/40136"
}
],
"metasploit": [
{
"name": "auxiliary/scanner/ssh/ssh_enumusers"
}
],
"cvssv2": 4.3
},
}
...
},
"cpe": "cpe:/a:openbsd:openssh:4.7p1",
"name": "ssh",
"version": "4.7",
"product": "openssh"
}
]
},
...
"timestamp": "2023-08-26T14:38:30+00:00"
}
}

> You can find the full output of **metasploitable2/3** in `example_data`.

# Errors and fixes
## Blocked IP
> Connection timeout/error during CRAWL phase (`database.py`)

**Fix:** Wait 15 minutes before re-running `database.py`.

## Missing luasql
> cvescannerv2.nse:54: module 'luasql.sqlite3' not found:

> NSE failed to find nselib/luasql/sqlite3.lua in search paths.

> ...

**Fix:** Install the library based on your OS (check [Requirements](#requirements))
and create a symlink to Nmap search path.
```bash
apt install lua-sql-sqlite3
ln -s /usr/lib/x86_64-linux-gnu/lua /usr/local/lib/lua
```

```bash
apk add --no-cache lua5.4-sql-sqlite3
ln -s /usr/lib/lua /usr/local/lib/lua
```
> Above commands may require super user permissions.

# Docker container
We have prepared two containers configured and ready to be used, you can download them
from DockerHub
- Database embedded version: `scmanjarrez/cvescanner:db` or `scmanjarrez/cvescanner:latest`
- No database: `scmanjarrez/cvescannerv2:nodb`

```bash
docker run -v /tmp/cvslogs:/tmp/cvslogs scmanjarrez/cvescanner --script-args log=/tmp/cvslogs/scan.log,json=/tmp/cvslogs/scan.json

docker run -v ./cve.db:/CVEScannerV2/cve.db -v /tmp/cvslogs:/tmp/cvslogs scmanjarrez/cvescanner:nodb --script-args log=/tmp/cvslogs/cvescannerv2.log,json=/tmp/cvslogs/cvescannerv2.json
```

> **Note**: You can find your logs in `/tmp/cvslogs` directory

# Acknowledgements
**This work has been supported by National R&D Project TEC2017-84197-C4-1-R and by
the Comunidad de Madrid project CYNAMON P2018/TCS-4566 and co-financed by European
Structural Funds (ESF and FEDER)**

- Based on [alegr3/CVEscanner](https://github.com/alegr3/CVEscanner) script.

- Common server regexes and paths from [vulnersCom/nmap-vulners](https://github.com/vulnersCom/nmap-vulners).

- Modules cache generated from [rapid7/metasploit-framework](https://github.com/rapid7/metasploit-framework).
> Can be found in **~/.msf4/store/modules_metadata.json** after running **msfconsole**

- CVE information gathered from [nvd.nist.gov](https://nvd.nist.gov).

# License
CVEScannerV2 Copyright (C) 2021-2024 Sergio Chica Manjarrez @ pervasive.it.uc3m.es.
Universidad Carlos III de Madrid.
This program comes with ABSOLUTELY NO WARRANTY; for details check below.
This is free software, and you are welcome to redistribute it
under certain conditions; check below for details.

[LICENSE](LICENSE)