Join GitHub today

GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.

Sign up

Shell

Permalink

Failed to load latest commit information.
bin moved modules and output dirs to data Apr 27, 2018
data added httprecon-nse submodule May 22, 2018
doc/man8 updated preview url (from imgur) May 21, 2018
etc #62 - updated prompt, minor fixes May 24, 2018
lib #62 - updated prompt, minor fixes May 24, 2018
src #61 - control this using a _cmd_state variable May 22, 2018
templates sample.mod - removed module version May 20, 2018
tmp #64 - added .gitkeep to tmp/ Jun 5, 2018
.gitignore moved modules and output dirs to data Apr 27, 2018
.gitmodules added httprecon-nse submodule May 22, 2018
.travis.yml travis.yml - removed notifications Apr 18, 2018
CODE_OF_CONDUCT.md added CODE_OF_CONDUCT.md Jul 17, 2018
CONTRIBUTING.md updated CONTRIBUTING.md Jul 17, 2018
LICENSE.md initial commit Mar 14, 2018
README.md README.md - updated 'Requirements' Jun 8, 2018
setup.sh minor fixes in setup.sh May 28, 2018

Sandmap is a tool supporting network and system reconnaissance using the massive Nmap engine.

Branch Version Modules Profiles Travis-CI License

DescriptionHow To UseCommand LineConfigurationRequirementsOtherLicenseWiki

Master

Description

Sandmap is a tool supporting network and system reconnaissance using the massive Nmap engine. It provides a user-friendly interface, automates and speeds up scanning and allows you to easily use many advanced scanning techniques.

Key Features

  • simple CLI with the ability to run pure Nmap engine
  • predefined scans included in the modules
  • support Nmap Scripting Engine (NSE) with scripts arguments
  • TOR support (with proxychains)
  • multiple scans at one time
  • at this point: 31 modules with 459 scan profiles

How To Use

It's simple:

# Clone this repository
git clone --recursive https://github.com/trimstray/sandmap

# Go into the repository
cd sandmap

# Install
./setup.sh install

# Run the app
sandmap
  • symlink to bin/sandmap is placed in /usr/local/bin
  • man page is placed in /usr/local/man/man8

Command Line

Before using the Sandmap read the Command Line introduction.

Configuration

The etc/main.cfg configuration file has the following structure:

# shellcheck shell=bash

# Specifies the default destination.
# Examples:
#   - dest="127.0.0.1,8.8.8.8"
dest="127.0.0.1"

# Specifies the extended Nmap parameters.
# Examples:
#   - params="--script ssl-ccs-injection -p 443"
params=""

# Specifies the default output type and path.
# Examples:
#   - report="xml"
report=""

# Specifies the TOR connection.
# Examples:
#   - tor="true"
tor=""

# Specifies the terminal type.
# Examples:
#   - terminal="internal"
terminal="internal"

Requirements

Sandmap uses external utilities to be installed before running:

This tool working with:

  • GNU/Linux (testing on Debian and CentOS)
  • Bash (testing on 4.4.19)
  • Nmap (testing on 7.70)

Also you will need root access.

Other

Modules

Available modules: 31
Available scan profiles: 459

If you want to create your own modules, take a look this.

Contributing

See this.

Project architecture

See this.

License

GPLv3 : http://www.gnu.org/licenses/

Free software, Yeah!