dorkbot

Escanea resultados de búsqueda de Google (u otros) en busca de vulnerabilidades.

dorkbot es una herramienta modular de línea de comandos para realizar escaneos de vulnerabilidades contra conjuntos de páginas web devueltas por consultas de búsqueda de Google u otras fuentes compatibles. Se divide en dos conjuntos de módulos:

• Indexers - módulos que devuelven una lista de objetivos
• Scanners - módulos que realizan un escaneo de vulnerabilidades en cada objetivo

Los objetivos se almacenan en una base de datos a medida que se indexan. Una vez escaneados, se produce un informe JSON estándar que contiene cualquier vulnerabilidad encontrada. Los procesos de indexación y escaneo se pueden ejecutar por separado o combinados en un solo comando (hasta uno de cada uno).

Quickstart

• Cree una credencial de API de Google a través de la Consola para desarrolladores
• Cree un Motor de búsqueda personalizado de Google y anote el ID del motor de búsqueda, p. ej. 012345678901234567891:abc12defg3h

$ pip3 install dorkbot wapiti3

$ dorkbot -i google_api -o key=your_api_credential_here -o engine=your_engine_id_here -o query="filetype:php inurl:id"

$ dorkbot -s wapiti

Help

 -h, --help            Show program (or specified module) help

  --show-defaults       Show default values in help output

Usage

usage: dorkbot [-c CONFIG] [-r DIRECTORY] [--source [SOURCE]]
               [--show-defaults] [--count COUNT] [--random] [-h] [--log LOG]
               [-v] [-V] [-d DATABASE] [-u] [--drop-tables]
               [--retries RETRIES] [--retry-on RETRY_ON] [--show-stats] [-l]
               [-n] [--list-sources] [--add-target TARGET]
               [--delete-target TARGET] [--flush-targets] [-m] [-e]
               [--list-sources] [--add-target TARGET]
               [--delete-target TARGET] [--flush-targets] [-m] [-e]
               [-i INDEXER] [-o INDEXER_ARG] [-s SCANNER] [-p SCANNER_ARG]
               [-t] [-x] [--mark-unscanned MARK_UNSCANNED] [-g] [-f]
               [--fingerprint-max FINGERPRINT_MAX] [--list-blocklist]
               [--add-blocklist-item ITEM] [--delete-blocklist-item ITEM]
               [--flush-blocklist] [-b EXTERNAL_BLOCKLIST]

options:
  -c, --config CONFIG   Configuration file
  -r, --directory DIRECTORY
                        Dorkbot directory (default location of db, tools,
                        reports)
  --source [SOURCE]     Label associated with targets
  --show-defaults       Show default values in help output
  -h, --help            Show program (or specified module) help
  --log LOG             Path to log file
  -v, --verbose         Enable verbose logging (can be used multiple times to
                        increase verbosity)
  -V, --version         Print version

retrieval:
  --count COUNT         number of targets to retrieve (0/unset = all)
  --random              retrieve targets in random order

database:
  -d, --database DATABASE
                        Database file/uri
  -u, --prune           Apply fingerprinting and blocklist without scanning
  --drop-tables         Delete and recreate tables
  --retries RETRIES     Number of retries when an operation fails
  --retry-on RETRY_ON   Error strings that should result in a retry (can be
                        used multiple times)
  --show-stats          Show the total/unscanned target and fingerprint counts

targets:
  -l, --list-targets    List targets in database
  -n, --unscanned-only  Only include unscanned targets
  --list-sources        List sources in database
  --add-target TARGET   Add a url to the target database
  --delete-target TARGET
                        Delete a url from the target database
  --flush-targets       Delete all targets
  -m, --delete-on-match
                        Delete target if it matches blocklist item
  -e, --delete-on-error
                        Delete target if error encountered while processing it

indexing:
  -i, --indexer INDEXER
                        Indexer module to use
  -o, --indexer-arg INDEXER_ARG
                        Pass an argument to the indexer module (can be used
                        multiple times)

scanning:
  -s, --scanner SCANNER
                        Scanner module to use
  -p, --scanner-arg SCANNER_ARG
                        Pass an argument to the scanner module (can be used
                        multiple times)
  -t, --test            Fetch next scannable target but do not mark it scanned
  -x, --reset-scanned   Reset scanned status of all targets
  --mark-unscanned MARK_UNSCANNED
                        Reset scanned status of given target

fingerprints:
  -g, --generate-fingerprints
                        Generate fingerprints for all targets
  -f, --flush-fingerprints
                        Delete all generated fingerprints
  --fingerprint-max FINGERPRINT_MAX
                        Maximum matches per fingerprint before deleting new
                        matches

blocklist:
  --list-blocklist      List internal blocklist entries
  --add-blocklist-item ITEM
                        Add an ip/host/regex pattern to the internal blocklist
  --delete-blocklist-item ITEM
                        Delete an item from the internal blocklist
  --flush-blocklist     Delete all internal blocklist items
  -b, --external-blocklist EXTERNAL_BLOCKLIST
                        Supplemental external blocklist file/db (can be used
                        multiple times)

Tools / Dependencies

Database drivers:

• psycopg (pip install "psycopg[binary]") (preferido)
• psycopg2 (pip install psycopg2-binary)

Scanners:

• Wapiti (pip install wapiti3)
• Spectre Scan
• Arachni (deprecated)

Según sea necesario, dorkbot buscará herramientas en el siguiente orden:

• Directorio especificado mediante la opción del módulo correspondiente
• Ubicado en el directorio tools (dentro del directorio actual, por defecto), con el subdirectorio nombrado después de la herramienta
• Disponible en el PATH del usuario (p. ej., instalado en todo el sistema)

Files

Todas las bases de datos SQLite, herramientas e informes se guardan en el directorio de dorkbot, que por defecto es el directorio actual. Puede forzar un directorio específico con la bandera --directory. Las rutas de archivo predeterminadas dentro de este directorio son las siguientes:

• Archivo de base de datos SQLite: dorkbot.db
• Directorio de herramientas externas: tools/
• Directorio de salida de informes de escaneo: reports/

Los archivos de configuración se leen por defecto desde ~/.config/dorkbot/ (Linux/MacOS) o en la carpeta Application Data (Windows), respetando $XDG_CONFIG_HOME / %APPDATA%. Las rutas de archivo predeterminadas dentro de este directorio son las siguientes:

• Archivo de configuración de dorkbot: dorkbot.ini

Config File

El archivo de configuración (dorkbot.ini) se puede usar para precargar ciertas banderas de línea de comandos.

Ejemplo de dorkbot.ini:

[dorkbot]
database=/opt/dorkbot/dorkbot.db
[dorkbot.indexers.wayback]
domain=example.com
[dorkbot.scanners.arachni]
path=/opt/arachni/bin
report_dir=/tmp/reports