MrSuicideParrot / SniffingBear

Honeypot detection distributed system

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

🍯   SniffingBear   🍯


🐝   Introduction   🐝

A modular and distributed tool developed in python to scan networks for honeypots


📥   How to Install   📥

Open the terminal and type following commands.

  • apt update

  • apt install git

  • git clone https://github.com/MrSuicideParrot/SniffingBear.git

  • cd SniffingBear

  • pip install -r requirements.txt


🔥   How to Use   🔥

       Client

Start the Client

  • python Client.py [ServerIp] [ServerPort]

Supported commands in the client:

List all of the current honeypot modules

  • sb > list

Brief explanation about the module in question

  • sb > description <moduleName>

Scan and IP or a range of IP's with a given module (use 'all' if you want to run all of the modules), in a given port by default it scans all of the avaiable ports.

  • sb > scan <IP> <moduleName> -p<ports>

Example

  • sb > scan 192.168.1.0/24 amun -p20,21,22,23,24,25

Scan and IP or a range of IP's with your custom module please provide de module url and follow our guide on how to create your own module.

  • sb > customScan <IP> <moduleUrl>

       Server

Start the Server

  • server.py [-h] [ServerPort]

       Worker

Start the Worker

  • worker.py [-h] [WorkerPort] [ServerIp] [ServerPort]

All of the above components support a helping documentation when starting them.

  • python Client.py -h
  • python Server.py -h
  • python Worker.py -h

⚠️   Warning   ⚠️

Use this tool at your own risk!


✨   Contributors   ✨

André Brandão
André Brandão
Fábio Freitas
Fábio Freitas
Nuno Lopes
Nuno Lopes

About

Honeypot detection distributed system

License:GNU General Public License v3.0


Languages

Language:Python 96.0%Language:Dockerfile 4.0%