Nmap Plugin for PTT

This plugin integrates Nmap scanning into the PTT framework.

Features

• Can saves scan results to nmap_scans.db and locally.
• XML output parsing for open ports and service detection.
• Recent results are viewable from the frontend and clickable to re-run.
• Results can be shared with PTT database for direct use by other plugins.

Requirements

• nmap installed and available in your system PATH

Setup

Install dependencies:

pip install -r requirements.txt

Build the plugin:

pyinstaller --onefile --name nmap.plugin --add-data "web/index.html:." main.py

Move the plugin to PTT plugins folder.

PTT Database

Open port results sent to the PTT DB are stored with the user_id shared and the key open_ports

They are stored in key-value pairs in the DB row: {"ip": "192.168.0.1", "port": 22}, {"ip": "192.168.0.1", "port": 80}

An example of fetching these results can be seen in the example under example_db_fetch directory