trimstray/sandmap — Gitpedia

<h1 align="center">sandmap</h1> <p align="center"> <a href="https://travis-ci.org/trimstray/sandmap"> <img src="https://travis-ci.org/trimstray/sandmap.svg?branch=master" alt="Travis-CI"> </a> <a href="https://img.shields.io/badge/Version-v1.2.0-lightgrey.svg"> <img src="https://img.shields.io/badge/Version-v1.2.0-lightgrey.svg" alt="Version"> </a> <a href="https://inventory.rawsec.ml/tools.html#Sandmap"> <img src="https://inventory.rawsec.ml/img/badges/Rawsec-inventoried-FF5050_flat.svg" alt="Rawsec's CyberSecurity Inventory"> </a> <a href="https://blackarch.org/tools.html"> <img src="https://img.shields.io/badge/BlackArch-available-red.svg" alt="BlackArch Repository"> </a> <a href="http://www.gnu.org/licenses/"> <img src="https://img.shields.io/badge/license-GNU-blue.svg" alt="License"> </a> </p> <h5 align="center"> <a href="#description">Description</a> • <a href="#how-to-use">How To Use</a> • <a href="#command-line">Command Line</a> • <a href="#configuration">Configuration</a> • <a href="#requirements">Requirements</a> • <a href="#other">Other</a> • <a href="#contributing">Contributing</a> • <a href="#license">License</a> • <a href="https://github.com/trimstray/sandmap/wiki">Wiki</a> </h5> <br> <p align="center"> <img src="https://i.imgur.com/9a97M2S.gif" alt="Master"> </p> <br>

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:

bash
# 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 <a href="https://github.com/trimstray/sandmap/wiki/CLI">Command Line</a> introduction.

Configuration

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

bash
# 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.

Project architecture

See this.

Contributing