Skip to main content

A network scanning tool for Kali Linux

Project description

Iguana: A Network Analysis Suite

⢀⣤⠴⠖⠋⠉⠓⢦⣀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
⣿⣄⠀⠂⠀⢶⣿⣇⡙⠷⣄⡀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢀⣀⣀⣀⣀⣀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
⠈⢳⡝⠢⡀⠀⠁⠀⠙⠦⣈⢻⡄⠀⠀⠀⠀⣠⢖⣶⡶⠶⠚⠛⠉⣉⠭⠝⠛⠋⠉⠉⠉⠛⠛⠓⠒⠶⠤⣤⣀⡀⠀⠀⠀⠀⠀⠀⠀⠀
⠀⠀⠙⣦⠈⠲⠄⣀⠀⢾⡏⠑⠿⡦⣤⣴⠞⠛⢉⣁⣀⠠⠤⠒⠉⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠉⠙⠓⠶⣤⡀⠀⠀⠀⠀
⠀⠀⠀⠈⠳⣄⡀⠀⠙⢓⡆⠠⢲⢾⣖⡀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⡔⠀⢦⠤⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠙⠳⣄⠀⠀
⠀⠀⠀⠀⠀⠀⠉⢳⣦⣿⣷⣾⣿⡿⢏⠇⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢀⡇⠀⠀⣗⠛⠋⠉⠉⠉⠙⠛⠒⠶⢤⣄⡀⠀⠀⠈⢳⡄
⠀⠀⠀⠀⠀⠀⠀⡾⢅⣻⡟⢛⡏⠁⠃⠀⣀⡀⠀⠀⠀⠀⠀⠀⠀⠀⢀⣠⣾⠓⢦⠀⠈⣦⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠙⠳⣄⠀⢸⢻
⠀⠀⠀⠀⠀⠀⡼⠁⠀⡇⠑⠧⣌⡉⠉⠑⣌⡉⠋⠛⠛⠶⠶⠶⠶⠶⢋⡴⠃⠀⠈⣷⣤⠟⣒⣶⡀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢸⣦⠆⣸
⠀⠀⢀⣀⣀⣸⠁⢀⡞⠁⠀⠀⠀⠉⠳⣄⠀⠙⢶⠶⠤⣤⣀⣠⡴⠞⠋⠀⠀⠀⠀⢇⣷⣄⣾⣝⣧⡀⠀⠀⠀⠀⠀⢀⣀⡴⠟⢁⡴⠃
⠀⢸⢷⠯⡽⡋⠀⡚⡇⠀⠀⠀⠀⠀⠀⠈⡆⠀⢳⡀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠈⠛⣿⠻⡇⠹⡇⣀⣤⠴⠒⣛⣉⡥⠴⠚⠉⠀⠀
⠀⠸⢹⡿⠤⠲⣾⠗⠃⠀⠀⠀⠀⠀⠀⠀⠀⠈⡆⠀⢳⡀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠁⣴⡿⠿⠛⠋⠉⠁⠀⠀⠀⠀⠀⠀⠀
⠀⠀⠈⠀⠀⠀⠋⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⣻⠀⠀⣧⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠁⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢠⣴⣾⡛⣧⡄⠀⣿⡀⠀⠀⠀⠀Developed by @uveissmjl⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢸⣟⡿⠭⣥⢚⣨⣤⡽⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠛⠀⠸⣞⠉⠀⢻⡇⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀

Iguana is an open-source, Python-based tool designed for network enthusiasts, cybersecurity students, and professionals looking to perform comprehensive network analyses. It integrates a variety of functionalities into one convenient suite, enabling users to inspect and audit networks efficiently. With Iguana, you can perform network scanning to discover active devices, conduct port scanning to identify open ports, capture and analyze network traffic, and gather DNS information for domain reconnaissance.

This tool is developed with the intention of providing a practical resource for learning about network security and diagnostics. Whether you're troubleshooting a network, auditing the security of a system, or just learning about network protocols and interactions, Iguana offers a user-friendly approach without compromising on depth and utility.

Features include:

Network Scanning: Quickly identify active devices within a network.
Port Scanning: Examine devices to find exposed services and potential vulnerabilities.
Network Sniffing: Analyze traffic for troubleshooting and educational purposes.
DNS Gathering: Collect detailed DNS information to aid in network reconnaissance.

Iguana is created with the ethos of ethical usage and educational purpose in mind. It's perfect for those who are new to network security or experienced professionals looking for a lightweight, scriptable solution. The tool is continually evolving, and contributions are welcome to extend its functionality and improve user experience.

Note: Iguana is intended for legal and ethical use only. Users must ensure they have proper authorization before scanning or probing networks. Unauthorized use of this tool is strictly prohibited and may lead to legal consequences.

For installation instructions, usage details, and contributing guidelines, please refer to the respective sections of this repository.

Happy Scanning!

Getting started!

# Iguana

Iguana is an open-source, Python-based network analysis suite designed for cybersecurity enthusiasts, network administrators, and educational purposes. This tool integrates functionalities for network scanning, port scanning, packet sniffing, and DNS information gathering, offering a streamlined approach to network diagnostics and security auditing.

## Features

- **Network Scanning**: Discover active devices within a specified IP range.
- **Port Scanning**: Identify open ports on devices and assess network security.
- **Network Sniffing**: Capture and analyze network traffic.
- **DNS Gathering**: Retrieve DNS records associated with a domain.

Installation

  1. Clone the repository:
    git clone https://github.com/uveissmjl/Iguana.git
    
  2. Navigate to the cloned directory:
    cd Iguana
    
  3. Install the required Python libraries:
    pip install scapy dnspython
    
  4. Make the script executable (optional):
    chmod +x iguana.py
    

Usage

Below are examples of how to use each feature of Iguana:

  • Network Scanning:
    ./iguana.py -m scan --ip 192.168.1.0/24
    
  • Port Scanning:
    ./iguana.py -m port-scan --ip 192.168.1.1
    
  • Network Sniffing:
    sudo ./iguana.py -m sniff --interface eth0
    
  • DNS Gathering:
    ./iguana.py -m dns-gather --domain example.com
    

Replace parameters like 192.168.1.0/24, 192.168.1.1, eth0, and example.com with your target information.

Legal Disclaimer

This tool is intended for legal and ethical use only. Unauthorized scanning and probing of networks may be illegal and unethical. Users are responsible for their actions and should ensure they have permission before engaging in any network scanning activities.

Contributing

Contributions are welcome! If you have improvements or new features, feel free to fork the repository, make changes, and submit a pull request. Please ensure your code adheres to clean coding standards for easy integration.

License

Iguana is released under the MIT License. See the LICENSE file for more details.

Acknowledgments

  • Thanks to the developers of Scapy and dnspython for providing the libraries that make Iguana possible.

Contact

For support, feedback, or questions, connect with me on GitHub or LinkedIn.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

iguana-0.1.5.tar.gz (6.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

iguana-0.1.5-py3-none-any.whl (7.3 kB view details)

Uploaded Python 3

File details

Details for the file iguana-0.1.5.tar.gz.

File metadata

  • Download URL: iguana-0.1.5.tar.gz
  • Upload date:
  • Size: 6.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.11.8

File hashes

Hashes for iguana-0.1.5.tar.gz
Algorithm Hash digest
SHA256 5871b2c671874c8824b03bc9b4ba29e09f7a4dd4a6441ea04968493aab0d57e7
MD5 3fc525cf4982133dfbb077ebf98d3cf3
BLAKE2b-256 ed27f00e672868d5a63cdc7edbbc44939b5d86127fbb9a7c02c3e61250079f31

See more details on using hashes here.

File details

Details for the file iguana-0.1.5-py3-none-any.whl.

File metadata

  • Download URL: iguana-0.1.5-py3-none-any.whl
  • Upload date:
  • Size: 7.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.11.8

File hashes

Hashes for iguana-0.1.5-py3-none-any.whl
Algorithm Hash digest
SHA256 92898ad8c0da4370ad1db4d2fb9b40c218b6814dfb760f39ae39f61252170a89
MD5 d2c5166a97bb6239ee65914b8dc94992
BLAKE2b-256 e317eaf647752686bd156b48f57b79328ce41ef39d9a5d7ac2c6c9f0727e99e8

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page