/nmap2md_for_zettler

A little utility to convert nmap xml results to markdown tables

Primary LanguagePythonMIT LicenseMIT

nmap2md

A little utility to convert nmap XML results to markdown tables for zettler.

Usage

Download application, you can use git for it:

git clone https://github.com/TheThingGoesSkra/nmap2md_for_zettler
cd nmap2md_for_zettler

Launch nmap scan and export results in xml file:

sudo nmap 10.11.1.0/24 --top-ports=1000 -oX nmap_results.xml

Example which parses nmap XML and create subnet tree using markdown files

./nmap2md.py nmap_results.xml

Options

Columns and row cells definition should be divided by ,.

  • -c is used to define columns. It is possible to write there anything
    • Default: Port,State,Service,Version
  • --rc is used to define row cells
    • Default: [port.number]/[port.protocol],[state],[service.name],[service.product] [service.version]
    • Available options:
      • [port.number] Port number (80)
      • [port.protocol] Port protocol (TCP)
      • [state] State (open)
      • [service.name] Name of the used service (http)
      • [service.product] Type of product used on that service (Apache httpd)
      • [service.version] Version of the product (2.2.14)
  • --hs is header size. Size variations: from 1 to 6.
    • Default: 0 (disabled)
  • --sort is for sorting.
    • Default: Port;asc
    • Can use any column that is defined in -c
    • asc & desc options, if none is provided: asc by default
  • --print-empty some port scanning results are empty and those are not displayed. However if there is a need to print empty sets, this option allows this.
    • Default: False

Output example

An example with many options and MD support in table cells (service values are italic). XML file was taken from https://nmap.org/book/output-formats-xml-output.html and this command was used:

./nmap2md.py test.xml -c "Port,State,Service,Version" --hs 4 --rc "[port.number]/[port.protocol],[state],*[service.name]*,[service.product] [service.version]"

74.207.244.221

Port State Service Version
22/tcp open ssh OpenSSH 5.3p1 Debian 3ubuntu7
80/tcp open http Apache httpd 2.2.14

Contributors

Thanks to the listed contributors for fixing bugs/testing & adding new features: