Skip to main content

('Wrapper around nmap allow nmap scans to be distributed', 'With resume, and address optimization.')

Project description

Distributed Nmap Scanner.

The main goal of this project is to provide a wrapper around nmap, and distribute scans across several hosts.

PIP package published at

pip3 url

Documentation

Demo Video.

Install

% git clone https://github.com/0x4E0x650x6F/dscan.git
% cd dscan
% pip install .
% dscan
[*]\tDistribuited scan
usage: Distributed scanner [-h] --name NAME {srv,agent,config} ...
Distributed scanner: error: the following arguments are required: --name, cmd

Uninstall

% pip uninstall dscan

Generate self-sign certificate.

The following command generates a self sign certificate a private key, and two configuration files agent.conf and dscan.conf with default settings for the agent and for the server.

dscan --name <project-name> config -email mail@dscan.org -cn dscan \
-c pt -l earth -st nrw -o dscan -ou it -days 365
ls -a fubar
- agent.conf	
- certfile.crt	
- dscan.conf	
- keyfile.key

Server output example

The following command starts the server, the --name is the name of the folder where the project files will be stored, this directory should contain the dscan.conf and the certificate private key generated from the previous command, the last argument is a existing file with a list of ip or networks to scan.

%dscan --name project name srv --config dscan.conf targets.txt

    Distributed Scan Status
    ========================

    ---------	----------------	------------
    N Stages	N  Pending Tasks	Completion %
    ---------	----------------	------------
    4        	0               	0.00%       

    ---------	----------	-----------	------------
    Stage    	N Targets	N Finished	Completion %
    ---------	----------	-----------	------------
    discovery	1         	0          	0.00%       

    ---------------	---------	-----------	------------
    Agent          	Stage    	Task Status	Target Ip   
    ---------------	---------	-----------	------------
    127.0.0.1:53281	discovery	DOWNLOADING	127.0.0.1/32

Agent output example

The following starts the agent, the --name is the name of the folder were the work files will be stores should contain a copy of the certificate, and the agent.conf file.

dscan --name <agent-project-name> agent --config <path-to-agent.conf> \ 
-s <server-ip-address> -p <server-port>

Distributed Scan Status
========================

------------	------------------	------
Target      	Nª completed Scans	Status
------------	------------------	------
127.0.0.1/32	5                 	100   

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for dscan-4E656F, version 0.1.5
Filename, size File type Python version Upload date Hashes
Filename, size dscan_4E656F-0.1.5-py3-none-any.whl (35.7 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size dscan-4E656F-0.1.5.tar.gz (21.8 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page