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.4.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.4-py3-none-any.whl (7.2 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: iguana-0.1.4.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.4.tar.gz
Algorithm Hash digest
SHA256 ed800ed7f42a4901d8788e084b14ea63e725ba6091bc579e8cf4e9d3fa7f6cb7
MD5 555aa6dd7c3f3eac7e85a41075f93acb
BLAKE2b-256 f6799976cc88ae956310e2edcc888e66bff8184a3f7ea41a9b6ed203f75c9548

See more details on using hashes here.

File details

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

File metadata

  • Download URL: iguana-0.1.4-py3-none-any.whl
  • Upload date:
  • Size: 7.2 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.4-py3-none-any.whl
Algorithm Hash digest
SHA256 0b30f519498fc6847297c93a877ec45fed57ae864a5e87d4b45556f5c20db353
MD5 ac78382aff34953e1e0dfe23d4d1edee
BLAKE2b-256 c2f39fa4b379d0ad8bbeea852ab020a5980d30cb6a0e96c24d9f8a0d1218b52a

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