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.3.tar.gz (6.3 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.3-py3-none-any.whl (7.3 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: iguana-0.1.3.tar.gz
  • Upload date:
  • Size: 6.3 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.3.tar.gz
Algorithm Hash digest
SHA256 b8461ea8c3bbc41aebbbf0ee59ce2e180abf55f600869e4c013f3ed67dcc8298
MD5 c63077b12b65beaaa213f0542a987041
BLAKE2b-256 07d92f75e52e66dcba175a52cb9bb42aa062693539bb2e811535ef17fbd23cd7

See more details on using hashes here.

File details

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

File metadata

  • Download URL: iguana-0.1.3-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.3-py3-none-any.whl
Algorithm Hash digest
SHA256 5748a9769099d14dcaa15f54bde788f68624041a085e9767a8f17c4e01fb57ef
MD5 f2233adb3844feb89c77e5aecdf5d61e
BLAKE2b-256 5b4a54385eb0bbc34e52b2c2253d0860614ba549a6bebd78d2d7851d5bcb7a43

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