Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/brnoleal/nmap-summarize-results

Repository containing the scripts used to run nmap and summarize its results.
https://github.com/brnoleal/nmap-summarize-results

Last synced: 3 months ago
JSON representation

Repository containing the scripts used to run nmap and summarize its results.

Awesome Lists containing this project

README

        

# nmap-summarize-results

## Description

Script to summarize results of nmap into a .csv file.

The nmap parameters define to be executed over targets in enumerate process are:

nmap -Pn -sV -O -T5 -oX output IP

When the *-u* flag is set, nmap run with the following parameters:

nmap -Pn -sS -sU -sV -O -T5 -oX output IP

If you wanna change this nmap parameters, change the file **summarize.sh**. This is an work in progress and many adjusts may be necessary. Feel free to collaborate.

**Tip**: At first time, run script without -u flag. Performe nmap with UDP enumeration enable can take too long.

**Attention**: The output generated are overwrited every time the script are executed (unless you rename the file or move it to another dir).


## Install

#### Clone this repo

git clone https://github.com/bfleal/nmap-summarize-results.git

#### Install dependencies

sudo python3 -m pip install -r requirements.txt

#### Errors

If some errors like *ImportError: No module named 'xmltodict'* or *AttributeError: module 'lib' has no attribute 'SSL_ST_INIT'* appear, maybe the following sequence of commands fix it.

sudo python3 -m pip install setuptools-rust
sudo python3 -m pip install pyOpenSSL
sudo python3 -m pip install -r requirements.txt

## How to use

#### Syntax

sudo ./summarize.sh [-d|-h|-n|-u] -t TARGET

Sudo is necessary to performe OS discovery with nmap.

#### Arguments

Required:
-t Target IP. Can be a single IP, a CIDR or a file with one IP per line
Optional:
-d Output dir. Default: ./output
-h Print this usage guide
-n Disable ping on host. All hosts will be tested
-u Also test UDP ports. Default: only TCP ports are tested

#### Examples

* Verify wich hosts are alive into a IP range and enumerate they TCP open ports. Default setup.

./summarize.sh -t 192.168.0.1/25

* Verify all hosts. Don't performe ping to check which of them are alive.

./summarize.sh -n -t 192.168.10.1/24

* Enumerate TCP and UDP ports of alive hosts.

./summarize.sh -u -t 192.168.7.1/25

* Define an output diretory where the files will be saved. Default: ./output.

./summarize.sh -d results -t 10.10.0.1/24

* Pass a list of IPs into a file.

List IPs into a file (ips.txt):
192.168.0.10
192.168.0.110
192.168.0.235
192.168.0.244
192.168.0.250

./summarize.sh -d results -t ips.txt