🐮 NetCowTool

NetCowTool is a modular reconnaissance and network analysis toolkit designed to assist with local discovery, VLAN analysis, Wi-Fi probing, and active scanning.

Example Usage

sudo python3 netcowtool.py
Please select a category:                                                                      
> Network                                                                                      
  Wifi

Please select a program to run:                                                   
> Discovery (local network info, port switch, VLANs issues)                                                                                
  Scanner (nmap scan after an initial Discovery analysis)                                                                                  
  MITM (printer traffic interception and analysis)                                                                                         
  Egress (outbound port filtering analysis)

Discovery results:

Scanner results:

  Discovery (local network info, port switch, VLANs issues)                                                                                
> Scanner (nmap scan after an initial Discovery analysis)                                                                                  
  MITM (printer traffic interception and analysis)                                                                                         
  Egress (outbound port filtering analysis)

Prerequisites

Systems Tested

This setup and the corresponding scripts have been successfully tested on the following systems:

Debian
Kali Linux

Libraries and Compilation Environment

• A C compiler such as GCC: Essential for compiling the source code.
• The libpcap library: Required for packet capturing functionalities.
• Command-line utilities: Tools like awk, grep, ping, and ip are necessary and usually available on Linux systems.

Permissions

• Administrative privileges: Required for running some commands, especially those that utilize pcap.

Installation Steps

Use the provided sudo python3 netcowtool.py script to handle all necessary installations and configurations efficiently.

or:

chmod +x ./setup.sh
sudo ./setup.sh

Running Programs

After installation, you can run sudo python3 netcowtool.py or the programs as follows:

sudo ./discovery
python3 mitm.py

Todo List - Future Improvements

Better Host Ranking in Scanner: Implement more sophisticated algorithms for host evaluation and ranking to enhance the accuracy and usefulness of the scanner program.

Organize program tree: restructure directories for easier navigation

Contributing

*/!\ All contributions are welcome /!*

If you wish to contribute to the project, please submit your changes via pull requests on our GitHub repository. We welcome contributions in code, documentation, testing, or any other improvements.