grinder

Internet-connected Devices Census Python Framework

The Grinder framework was created to automatically enumerate and fingerprint different hosts on the Internet using different back-end systems: search engines, such as Shodan or Censys, for discovering hosts and NMAP engine for fingerprinting and specific checks. The Grinder framework can be used in many different areas of researches, as a connected Python module in your own project or as an independent ready-to-use from the box tool.

Install

git clone https://github.com/sdnewhop/grinder
cd grinder
python3 -m venv grindervenv
source grindervenv/bin/activate
which python
which pip
pip3 install -r requirements.txt

Set your Shodan and Censys keys via a command line argument

./grinder.py -sk YOUR_SHODAN_KEY -ci YOUR_CENSYS_ID -cs YOUR_CENSYS_SECRET

or via an environment variable

export SHODAN_API_KEY=YOUR_SHODAN_API_KEY_HERE
export CENSYS_API_ID=YOUR_CENSYS_API_ID_HERE
export CENSYS_API_SECRET=YOUR_CENSYS_API_SECRET_HERE

Deactivate virtual environment after use and restore default python interpreter

deactivate

Use

usage: grinder.py [-h] [-r] [-u] [-q QUERIES_FILE] [-sk SHODAN_KEY] [-cu]

                  [-cp] [-ci CENSYS_ID] [-cs CENSYS_SECRET] [-cm CENSYS_MAX]

                  [-nm]



The Grinder framework was created to automatically enumerate and fingerprint

different hosts on the Internet using different back-end systems



optional arguments:

  -h, --help            show this help message and exit

  -r, --run             Run scanning

  -u, --update-markers  Update map markers

  -q QUERIES_FILE, --queries-file QUERIES_FILE

                        JSON File with Shodan queries

  -sk SHODAN_KEY, --shodan-key SHODAN_KEY

                        Shodan API key

  -cu, --count-unique   Count unique entities

  -cp, --create-plots   Create graphic plots

  -ci CENSYS_ID, --censys-id CENSYS_ID

                        Censys API ID key

  -cs CENSYS_SECRET, --censys-secret CENSYS_SECRET

                        Censys API SECRET key

  -cm CENSYS_MAX, --censys-max CENSYS_MAX

                        Censys default maximum results quantity

  -nm, --nmap-scan      Initiate Nmap scanning

Example

Run an enumeration with Nmap scanning, where maximum Censys results is 555 hosts per query, update map markers, count unique entities and create plots

./grinder.py -sk YOUR_SHODAN_API_KEY_HERE -ci YOUR_CENSYS_ID -cs YOUR_CENSYS_SECRET -u -q queries.json -cu -cp -cm 555 -nm -r

Copyright (C) 2019 sdnewhop

Source: https://github.com/sdnewhop/