Dorkbot To Scan Google Search Results For Vulnerabilities

Dorkbot To Scan Google Search Results For Vulnerabilities

dorkbot is a modular command-line tool for performing vulnerability scans against a set of webpages returned by Google search queries in a given Google Custom Search Engine. 

It is broken up into two sets of modules:

• Indexers - modules that issue a search query and return the results as targets
• Scanners - modules that perform a vulnerability scan against each target

Targets are stored in a local database upon being indexed. Once scanned, any vulnerabilities found by the chosen scanner are written to a standard JSON report file. Indexing and scanning processes can be run separately or combined in a single command.

Usage

usage: dorkbot.py [-h] [-c CONFIG] [-b BLACKLIST] [-d DATABASE] [-i INDEXER]
[-l] [-o INDEXER_OPTIONS] [-p SCANNER_OPTIONS] [-s SCANNER] 
[-v VULNDIR]

optional arguments:
  -h, --help            show this help message and exit
  -c CONFIG, --config CONFIG
  Configuration file
  -b BLACKLIST, --blacklist BLACKLIST
  File containing (regex) patterns to blacklist from scans
  -d DATABASE, --database DATABASE
  SQLite3 database file
  -i INDEXER, --indexer INDEXER
  Indexer module to use
  -l, --list  List targets in database
  -o INDEXER_OPTIONS, --indexer-options INDEXER_OPTIONS
  Indexer-specific options (opt1=val1,opt2=val2,..)
  -p SCANNER_OPTIONS, --scanner-options SCANNER_OPTIONS
  Scanner-specific options (opt1=val1,opt2=val2,..)
  -s SCANNER, --scanner SCANNER
  Scanner module to use
  -v VULNDIR, --vulndir VULNDIR
  Directory to store vulnerability output reports

Platform

Python 2.7.x / 3.x (Linux / Mac OS / Windows) (requires python-dateutil)

Quickstart

1. Download PhantomJS and either Arachni or Wapiti for your platform, and make sure you have installed any required dependencies for each.
2. Extract each tool into the tools directory and rename the directory after the tool (dorkbot/tools/phantomjs/, dorkbot/tools/arachni/, etc).
3. Create a Google Custom Search Engine and note the search engine ID, e.g. 012345678901234567891:abc12defg3h.
4. Install python-dateutil (e.g.: pip install python-dateutil)

Example: use arachni to scan php pages that contain the string "id" in the url:

$ ./dorkbot.py -i google -o engine=012345678901234567891:abc12defg3h,query="filetype:php inurl:id" -s arachni

Indexer Modules

google
Search for targets in a Google Custom Search Engine (CSE) via custom search element.

Requirements: PhantomJS

Options:

• engine - CSE id
• query - search query
• phantomjs_dir - phantomjs base directory containing bin/phantomjs (default: tools/phantomjs/)
• domain - limit searches to specified domain

google_api

Search for targets in a Google Custom Search Engine (CSE) via JSON API.

Requirements: none

Options:

• key - API key
• engine - CSE id
• query - search query
• domain - limit searches to specified domain

stdin

Read targets from standard input, one per line.

Requirements: none

Options: none

Scanner Modules

arachni

Scan targets with Arachni command-line scanner.

Requirements: Arachni

Options:

• arachni_dir - arachni base directory containing bin/arachni and bin/arachni_reporter (default: tools/arachni/)
• report_dir - directory to save arachni scan binary and JSON scan report output (default: reports/)
• checks - which vulnerability checks to perform (default: active/*,-csrf,-unvalidated_redirect,-source_code_disclosure,-response_splitting,-no_sql_injection_differential

wapiti
Scan targets with Wapiti command-line scanner.

Requirements: Wapiti

Options:

• wapiti_dir - wapiti base directory containing bin/wapiti (default: tools/wapiti/)
• report_dir - directory to save wapiti JSON scan report (default: reports/)

Download