{"id":25096553,"url":"https://github.com/sergio11/zoneguardian","last_synced_at":"2025-07-18T19:03:54.815Z","repository":{"id":90143626,"uuid":"87632821","full_name":"sergio11/zoneguardian","owner":"sergio11","description":"🌐 ZoneGuardian: A powerful tool to analyze DNS configurations, detect vulnerabilities, and generate actionable security reports. 🔒🚀 Safeguard your digital assets with precision and ease!","archived":false,"fork":false,"pushed_at":"2025-03-23T21:50:58.000Z","size":1190,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-02T01:52:14.977Z","etag":null,"topics":["automation","cybersecurity","dns-configuration","dns-monitoring","dns-security","ethical-hacking","network-security","open-source","penetration-testing","python","security-audit","security-tools","threat-detection","vulnerability-analysis"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sergio11.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.TXT","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-04-08T12:37:56.000Z","updated_at":"2025-03-23T21:51:01.000Z","dependencies_parsed_at":null,"dependency_job_id":"b9be38d0-7042-469c-9f98-82fd5c0e9c3b","html_url":"https://github.com/sergio11/zoneguardian","commit_stats":null,"previous_names":["sergio11/zoneguardian","sergio11/hadoop_samples"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/sergio11/zoneguardian","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sergio11%2Fzoneguardian","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sergio11%2Fzoneguardian/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sergio11%2Fzoneguardian/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sergio11%2Fzoneguardian/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sergio11","download_url":"https://codeload.github.com/sergio11/zoneguardian/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sergio11%2Fzoneguardian/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265815203,"owners_count":23832863,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["automation","cybersecurity","dns-configuration","dns-monitoring","dns-security","ethical-hacking","network-security","open-source","penetration-testing","python","security-audit","security-tools","threat-detection","vulnerability-analysis"],"created_at":"2025-02-07T16:48:14.279Z","updated_at":"2025-07-18T19:03:54.593Z","avatar_url":"https://github.com/sergio11.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🌐 ZoneGuardian: DNS Vulnerability Analyzer 🚀\n\nZoneGuardian is a cutting-edge cybersecurity tool meticulously crafted to **inspect DNS configurations** and **identify potential vulnerabilities**. DNS, the backbone of internet infrastructure, is often a target for malicious attacks and misconfigurations that can compromise your organization's security. ZoneGuardian empowers you to proactively analyze, detect, and mitigate risks in your DNS setup with precision and ease.\n\nWith its advanced scanning capabilities, professional-grade reporting, and actionable insights, ZoneGuardian is an essential tool for IT administrators, cybersecurity professionals, and organizations aiming to fortify their digital assets. Whether you're safeguarding sensitive data or ensuring compliance, ZoneGuardian provides the tools you need to maintain a robust security posture.\n\n**Secure your DNS. Protect your infrastructure. Trust ZoneGuardian.** 🚀\n\n\u003e ⚠️ **Disclaimer**: This tool has been developed **exclusively for educational and ethical hacking purposes**. It is designed to help users understand DNS security concepts and learn how to identify potential vulnerabilities in a controlled environment.  \n\u003e  \n\u003e **Unauthorized use of this tool on systems without explicit permission is strictly prohibited.** Always ensure you have the proper authorization before conducting any security analysis. The developer assumes no responsibility for misuse.\n\n🙏 I would like to express my sincere gratitude to [Santiago Hernández, a leading expert in Cybersecurity and Artificial Intelligence](https://www.udemy.com/user/shramos/). His outstanding course on **Cybersecurity and Ethical Hacking**, available on Udemy, was instrumental in the development of this project. The insights and techniques I gained from his course were invaluable in guiding my approach to cybersecurity practices. Thank you for sharing your knowledge and expertise!\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/langchain-1C3C3C?style=for-the-badge\u0026logo=langchain\u0026logoColor=white\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Kali_Linux-557C94?style=for-the-badge\u0026logo=kali-linux\u0026logoColor=white\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Python-FFD43B?style=for-the-badge\u0026logo=python\u0026logoColor=blue\" /\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"doc/picture_1.PNG\" /\u003e\n\u003c/p\u003e\n\n## 🌟 **Explore My Other Open-Source Ethical Hacking Tools**\n\nIf you're passionate about ethical hacking and want to elevate your cybersecurity toolkit, make sure to explore my suite of open-source projects. These tools are designed to empower penetration testers and cybersecurity professionals by streamlining complex tasks, enhancing security audits, and uncovering vulnerabilities with cutting-edge precision:\n\n- [🦅 **NetHawk**](https://github.com/sergio11/nethawk_analyzer): A state-of-the-art **AI-powered ethical hacking tool** for **network vulnerability assessment**. Using advanced frameworks like **Scapy** and **Nmap**, NetHawk automates **port scanning**, **vulnerability detection**, and **report generation**, making security audits faster, smarter, and more efficient. Whether you're a **network administrator**, **cybersecurity expert**, or **ethical hacker**, NetHawk simplifies the assessment process and offers actionable insights to fortify your systems.\n- [💀 **Nemesys**](https://github.com/sergio11/nemesys): An advanced **exploitation** and **post-exploitation** tool built on top of the **Metasploit Framework** for automating critical data harvesting and system enumeration.  \n- [🕷️ **BlackVenom**](https://github.com/sergio11/blackvenom): The ultimate **ARP** and **DNS spoofing** tool for **intercepting network traffic** and uncovering vulnerabilities with stealth and precision.  \n- [🌐 **ZeroTrace**](https://github.com/sergio11/zero_trace_hacking_tool): A powerful **search engine dorking** tool designed to identify **attack vectors** and uncover **exposed sensitive information** across the web.\n- 🔐 **DecryptX**: An **advanced hash and password security assessment tool** that empowers you to analyze **password hashes**, **encrypted ZIP files**, and more. Ideal for evaluating the strength of encryption and identifying weaknesses in **security implementations**.\n- [ 🌑 **EclipseRecon**](https://github.com/sergio11/eclipserecon): is a stealthy web reconnaissance tool for uncovering hidden vulnerabilities, subdomains, and site structures. 🕵️‍♂️🔍 It empowers security professionals to identify critical attack surfaces with precision, ensuring proactive defense. 🚨💻\n- [ 🌐 **ZoneGuardian**](https://github.com/sergio11/zoneguardian): A powerful tool to analyze DNS configurations, detect vulnerabilities, and generate actionable security reports. 🔒🚀 Safeguard your digital assets with precision and ease!\n- **Retrospect**: A cutting-edge **reconnaissance and security analysis tool** that retrieves and analyzes historical web snapshots, helping you uncover past vulnerabilities and misconfigurations before they can be exploited today. Ideal for **ethical hackers** and **digital forensics experts**.\n\nThese tools are designed to streamline penetration testing, enhance security assessments, and provide in-depth insights into vulnerabilities. Explore them to level up your ethical hacking skills! 💻🔍\n\n## 🛠️ Features\n\n- **DNS Record Analysis**: Thoroughly inspects DNS records for security risks and misconfigurations.  \n- **WHOIS Integration**: Extracts and analyzes domain registration details to identify potential vulnerabilities.  \n- **Actionable Security Reports**: Generates detailed and structured reports to prioritize vulnerabilities.  \n- **Mitigation Recommendations**: Offers expert guidance to address and resolve identified risks.  \n- **Professional Audit Output**: Creates ready-to-share reports in PDF format.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"doc/picture_2.PNG\" /\u003e\n\u003c/p\u003e\n\n## 🔍 Purpose\n\nDNS misconfigurations and exposed zone data can reveal sensitive information about an organization’s infrastructure. ZoneGuardian aims to:  \n1. **Protect** your infrastructure by identifying and mitigating vulnerabilities.  \n2. **Simplify** the auditing process with structured insights and AI-powered analysis.  \n3. **Empower** decision-makers with clear, professional reports and actionable steps.  \n\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"doc/picture_3.PNG\" /\u003e\n\u003c/p\u003e\n\n## ⚙️ Tools \u0026 Technologies\n\nZoneGuardian is powered by state-of-the-art tools and frameworks, including:  \n\n- **Core Libraries**: Python-based solutions for DNS record inspection, WHOIS data retrieval, and PDF report generation.  \n- **AI Integration**: Advanced models and embeddings for intelligent data processing and analysis.  \n- **Utility Frameworks**: Secure and efficient handling of environment variables, logging, and data structures.  \n\n## 🏗️ How It Works\n\nZoneGuardian follows a systematic approach to DNS vulnerability analysis:  \n1. Accepts domain names as input.  \n2. Scans DNS records and retrieves WHOIS data for detailed insights.  \n3. Identifies potential vulnerabilities and classifies them by severity:  \n   - Critical vulnerabilities.  \n   - Warnings.  \n   - Informational notes.  \n4. Provides tailored recommendations to address risks.  \n5. Outputs a structured and professional report in PDF format.  \n\n## 🌟 Why ZoneGuardian?\n\n- **Proactive Security**: Stay ahead of attackers by uncovering vulnerabilities early.  \n- **AI-Powered Insights**: Leverage intelligent analysis to prioritize actions.  \n- **Clear \u0026 Professional Reports**: Enable informed decision-making with well-structured outputs.  \n- **User-Friendly Design**: Simplifies complex security audits for efficient results.\n\n# 🚀 Parameters and Options for ZoneGuardian Script\n\nThe ZoneGuardian script offers customizable parameters to tailor the DNS vulnerability analysis process. Below is a detailed guide:  \n\n| **🔧 Parameter**    | **🛠️ Type**  | **📦 Default Value**        | **📋 Description**                                                                                         | **💡 Example Usage**                          |\n|----------------------|-------------|-----------------------------|-------------------------------------------------------------------------------------------------------------|-----------------------------------------------|\n| `--domains`          | `str`       | **Required**                | 🌐 A comma-separated list of domains to scan for vulnerabilities.                                           | `--domains example.com,example2.com`         |\n| `--threads`          | `int`       | `10`                        | ⚡ Number of threads for parallel processing. Improves performance when scanning multiple domains.           | `--threads 20`                                |\n| `--output-json`      | `str`       | `zoneguardian_results.json` | 📄 File path to save detailed DNS scan results in JSON format.                                              | `--output-json results/my_results.json`      |\n| `--output-pdf`       | `str`       | `zoneguardian_report.pdf`   | 📊 File path to save the vulnerability analysis report in PDF format.                                       | `--output-pdf reports/my_report.pdf`         |\n\n\n### 📋 Detailed Parameter Descriptions\n\n1. **🌐 `--domains` (Required)**  \n   Specifies the domains to be scanned.  \n   - Example: `--domains example.com,example2.com`  \n   - **Note**: Separate domains with commas, without spaces.\n\n2. **⚡ `--threads`**  \n   Sets the number of threads for parallel processing.  \n   - Default: `10`  \n   - A higher value speeds up the scan for multiple domains but may increase CPU usage.  \n   - Example: `--threads 20`  \n\n3. **📄 `--output-json`**  \n   Defines the file path for saving detailed JSON results.  \n   - Default: `zoneguardian_results.json`  \n   - Includes all analyzed DNS records and WHOIS data.  \n   - Example: `--output-json results/my_results.json`  \n\n4. **📊 `--output-pdf`**  \n   Defines the file path for saving the final PDF report.  \n   - Default: `zoneguardian_report.pdf`  \n   - Contains an executive summary, vulnerability classification, and recommendations.  \n   - Example: `--output-pdf reports/my_report.pdf`  \n\n### ✅ Usage Example\n\nTo scan two domains (`example.com` and `test.com`), using 15 threads, and save results in custom files:  \n\n```bash\npython zoneguardian.py --domains example.com,test.com --threads 15 --output-json results.json --output-pdf report.pdf\n```\n\n### 📌 Notes\nEnsure all dependencies are installed before running the script.\n* The --domains parameter is mandatory; the script will not execute without it.\n* Customize the output paths to prevent overwriting existing files.\n\n## ⚠️ Disclaimer  \n\n**ZoneGuardian** was developed **exclusively for educational purposes** and as a **practical application of the knowledge acquired during my cybersecurity training**. Its primary objective is to **help security professionals and students understand DNS vulnerabilities** and **experiment within a controlled lab environment**.  \n\nThis tool is intended **only for ethical security research, authorized penetration testing, and learning purposes**. **Unauthorized scanning, probing, or exploitation of external DNS infrastructures without explicit permission** is **strictly prohibited** and may violate **cybersecurity laws**.  \n\nAll **testing and research conducted with ZoneGuardian were performed in an isolated cybersecurity lab environment** with **deliberately vulnerable systems** to ensure responsible and legal usage.  \n\nThe developer **disclaims any responsibility for misuse** of this tool. It is the user's sole responsibility to ensure that their activities are **fully compliant with legal and ethical guidelines** when using **ZoneGuardian**.  \n\n## Acknowledgements 🙏\n\n🙏 I would like to express my sincere gratitude to [Santiago Hernández, a leading expert in Cybersecurity and Artificial Intelligence](https://www.udemy.com/user/shramos/). His outstanding course on **Cybersecurity and Ethical Hacking**, available on Udemy, was instrumental in the development of this project. The insights and techniques I gained from his course were invaluable in guiding my approach to cybersecurity practices. Thank you for sharing your knowledge and expertise!\n\n\n## 🤝 **Contributing**\nContributions to Zoneguardian are highly encouraged! If you're interested in adding new features, resolving bugs, or enhancing the project's functionality, please feel free to submit pull requests.\n\n## Get in Touch 📬\n\nZoneguardian is developed and maintained by **Sergio Sánchez Sánchez** (Dream Software). Special thanks to the open-source community and the contributors who have made this project possible. If you have any questions, feedback, or suggestions, feel free to reach out at  [dreamsoftware92@gmail.com](mailto:dreamsoftware92@gmail.com).\n\n## Visitors Count\n\n\u003cimg width=\"auto\" src=\"https://profile-counter.glitch.me/zoneguardian/count.svg\" /\u003e\n \n ## Please Share \u0026 Star the repository to keep me motivated.\n  \u003ca href = \"https://github.com/sergio11/zoneguardian/stargazers\"\u003e\n     \u003cimg src = \"https://img.shields.io/github/stars/sergio11/zoneguardian\" /\u003e\n  \u003c/a\u003e\n\n## License ⚖️\n\nThis project is licensed under the MIT License, an open-source software license that allows developers to freely use, copy, modify, and distribute the software. 🛠️ This includes use in both personal and commercial projects, with the only requirement being that the original copyright notice is retained. 📄\n\nPlease note the following limitations:\n\n- The software is provided \"as is\", without any warranties, express or implied. 🚫🛡️\n- If you distribute the software, whether in original or modified form, you must include the original copyright notice and license. 📑\n- The license allows for commercial use, but you cannot claim ownership over the software itself. 🏷️\n\nThe goal of this license is to maximize freedom for developers while maintaining recognition for the original creators.\n\n```\nMIT License\n\nCopyright (c) 2024 Dream software - Sergio Sánchez \n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsergio11%2Fzoneguardian","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsergio11%2Fzoneguardian","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsergio11%2Fzoneguardian/lists"}