Skip to content

mmg1/scamper

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

124 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

NCC Group Scamper

A new tool for collecting RDP, web and VNC screenshots all in one place

This tool is still a work-in-progress and should be mostly usable but is not yet complete. Please file any bugs or feature requests as GitHub issues

Caveats

Motivation

Since Eyewitness recently dropped support for RDP there isn't a working CLI tool for capturing RDP screenshots. Nessus still works, but it's a pain to get the images out and they're not included in the export file.

I thought this was a good opportunity to write a fresh tool that's more powerful than those that came before. Check out the feature list!

Prerequisites

For web screenshotting, scamper currently depends on there being an installation of Chromium or Google Chrome. Install with pacman -S chromium or the equivalent for your OS.

Usage

Grab a single web page or RDP server:

$ cargo run --release -- -t http://example.com
$ cargo run --release -- -t rdp://192.0.2.1
$ cargo run --release -- -t 2001:db8::5 --mode web
$ cargo run --release -- -t 2001:db8::5 --mode rdp
$ cargo run --release -- -t 192.0.2.2

Automatically grab screenshots from an nmap output:

$ nmap -iL targets.txt -p 80,443,8080,8443,3389 -oX targets.xml
$ cargo run --release -- --nmap targets.xml

Choose a different output directory for images:

$ cargo run --release -- -t 2001:db8::3 --output-dir /tmp/scamper_outputs

Run from a targets file:

$ cat targets.txt
http://example.com
rdp://192.0.2.1
2001:db8::5
$ cargo run --release -- -f targets.txt

Image files are saved as PNG in the following directory structure:

output
├── rdp
│   └── 192.0.2.1-3389.png
└── web
    └── https_example.com.png

Features:

Features with ticks next to them have been implemented, others are TODO

  • ✔️ Automatically decide whether an input should be treated as a web address or RDP server
  • ✔️ Automatically create output directory if it does not already exist
  • ✔️ Save images with consistent and unique filenames derived from the host/IP
  • ✔️ Full support for IPv6 and IPv4 literals as well as hostnames
  • ✔️ Read targets from a file and decide whether they're RDP or HTTP or use hints
  • ✔️ Parse targets smartly from nmap output
  • ✔️ HTTP - uses Chromium/Chrome in headless mode
  • ✔️ Full cross-platform support - tested on Linux, Windows and Mac
  • RDP - mostly working, needs better heuristic for determining when it has received a full login/desktop screen image, see #2
  • VNC - tracking issue #6
  • Video streams - tracking issue #5
  • option for timestamps in filenames
  • Read targets from a msf services -o csv output
  • Parse targets smartly from nessus output - WIP
  • OCR on RDP usernames, either live or on a directory of images
  • Readme has pretty pictures of the output
  • NLA/auth to test credentials
  • Parse Dirble JSON output to grab screenshots of an entire website - waiting for nccgroup/dirble#51
  • Produce an HTML report to allow easy browsing of the results - tracking issue #7

Help text

USAGE:
    scamper [FLAGS] [OPTIONS]

FLAGS:
    -h, --help           Prints help information
    -s, --silent         Suppress most log messages
        --test-import    Exit after importing targets
    -v, --verbose        Increase log verbosity
    -V, --version        Prints version information

OPTIONS:
    -f, --file <file>...             Targets file, one per line
    -l, --log-file <log-file>        Save logs to file
    -m, --mode <mode>                Force `web` or `rdp` [default: auto]
        --nmap <nmap>...             Nmap XML file
    -o, --output-dir <output-dir>    Directory to save the captured images in [default: output]
    -t, --target <target>...         Target, e.g. http://example.com
        --threads <threads>          Number of worker threads for each target type [default: 3]
        --timeout <timeout>           [default: 10]

About

A tool for collecting RDP, web and VNC screenshots all in one place

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages

  • Rust 100.0%