{"id":31931040,"url":"https://github.com/adscanpro/clickjacking-poc-generator","last_synced_at":"2025-10-14T04:16:58.840Z","repository":{"id":315367196,"uuid":"1059194464","full_name":"ADScanPro/clickjacking-poc-generator","owner":"ADScanPro","description":"An automated tool to generate HTML Proof of Concept files for clickjacking vulnerabilities. This tool helps security researchers and penetration testers create professional PoCs to demonstrate clickjacking attacks.","archived":false,"fork":false,"pushed_at":"2025-09-18T06:31:52.000Z","size":23,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-18T08:17:59.886Z","etag":null,"topics":["clickjacking","clickjacking-generator","clickjacking-generator-poc","clickjacking-poc","clickjacking-poc-generator","clickjacking-tester","clickjacking-vulnerability","owasp","pentesting","pentesting-poc"],"latest_commit_sha":null,"homepage":"https://www.adscanpro.com","language":"Python","has_issues":true,"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/ADScanPro.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-18T06:00:32.000Z","updated_at":"2025-09-18T07:39:54.000Z","dependencies_parsed_at":"2025-09-18T08:18:01.400Z","dependency_job_id":"b3b21419-fd10-4a44-8125-5c635a680bfa","html_url":"https://github.com/ADScanPro/clickjacking-poc-generator","commit_stats":null,"previous_names":["adscanpro/clickjacking-poc-generator"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/ADScanPro/clickjacking-poc-generator","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ADScanPro%2Fclickjacking-poc-generator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ADScanPro%2Fclickjacking-poc-generator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ADScanPro%2Fclickjacking-poc-generator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ADScanPro%2Fclickjacking-poc-generator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ADScanPro","download_url":"https://codeload.github.com/ADScanPro/clickjacking-poc-generator/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ADScanPro%2Fclickjacking-poc-generator/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279017986,"owners_count":26086213,"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","status":"online","status_checked_at":"2025-10-14T02:00:06.444Z","response_time":60,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["clickjacking","clickjacking-generator","clickjacking-generator-poc","clickjacking-poc","clickjacking-poc-generator","clickjacking-tester","clickjacking-vulnerability","owasp","pentesting","pentesting-poc"],"created_at":"2025-10-14T04:16:57.727Z","updated_at":"2025-10-14T04:16:58.834Z","avatar_url":"https://github.com/ADScanPro.png","language":"Python","readme":"# 🔒 Clickjacking PoC Generator\n\n[![Python Version](https://img.shields.io/badge/python-3.8%2B-blue.svg)](https://python.org)\n[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)\n[![Security](https://img.shields.io/badge/security-tool-red.svg)](https://github.com/yourusername/clickjacking-poc-generator)\n\nAn automated tool to generate HTML Proof of Concept files for clickjacking vulnerabilities. This tool helps security researchers and penetration testers create professional PoCs to demonstrate clickjacking attacks.\n\n## 🚀 Features\n\n- **Single URL Processing**: Generate PoC for individual URLs\n- **Batch Processing**: Process multiple URLs from a file\n- **Professional HTML Output**: Beautiful, interactive PoC templates\n- **Rich CLI Interface**: Modern command-line interface with progress bars\n- **Debugging Support**: Verbose logging and debug modes\n- **URL Validation**: Automatic validation of input URLs\n- **Modular Design**: Clean, maintainable code structure\n\n## 📋 Requirements\n\n- Python 3.8 or higher (recommended: Python 3.11+)\n- Rich library for enhanced CLI experience\n\n\u003e **Note**: Python 3.7 is no longer supported as it has reached end-of-life. Python 3.8+ is required for optimal compatibility with modern systems and security updates.\n\n## 🛠️ Installation\n\n### 🎯 **Recommended: Using pipx (Isolated Environment)**\n\n```bash\n# Install pipx if you don't have it\npython -m pip install --user pipx\npython -m pipx ensurepath\n\n# Install directly from GitHub\npipx install git+https://github.com/ADScanPro/clickjacking-poc-generator.git\n\n# Or install from local directory\npipx install .\n```\n\n**Benefits of pipx:**\n- ✅ Isolated virtual environment\n- ✅ No dependency conflicts\n- ✅ Easy updates and uninstalls\n- ✅ Global command availability\n\n### 🚀 Quick Start with pipx\n\n```bash\n# One-liner installation and usage\npipx install git+https://github.com/ADScanPro/clickjacking-poc-generator.git\nclickjacking-poc -u https://example.com --verbose\n```\n\n### 🔄 Managing pipx Installation\n\n```bash\n# Update to latest version\npipx upgrade clickjacking-poc-generator\n\n# Uninstall\npipx uninstall clickjacking-poc-generator\n\n# List installed packages\npipx list\n\n# Reinstall\npipx reinstall clickjacking-poc-generator\n```\n\n### Alternative: Direct Installation\n\n```bash\n# Clone the repository\ngit clone https://github.com/ADScanPro/clickjacking-poc-generator.git\ncd clickjacking-poc-generator\n\n# Install dependencies\npip install -r requirements.txt\n\n# Make the script executable\nchmod +x clickjacking_poc_generator.py\n```\n\n### Alternative: Using pip (after publishing)\n\n```bash\npip install clickjacking-poc-generator\n```\n\n## 🎯 Usage\n\n### Basic Usage\n\n```bash\n# Generate PoC for a single URL\nclickjacking-poc -u https://example.com\n# or\nclickjacking-poc-generator -u https://example.com\n\n# Generate PoC with custom output filename\nclickjacking-poc -u https://example.com -o my_poc.html\n\n# Process multiple URLs from a file\nclickjacking-poc -f urls.txt\n\n# Process URLs with custom output directory\nclickjacking-poc -f urls.txt -d output_pocs\n```\n\n**Note:** If installed with pipx, you can use the command directly. If installed manually, use:\n```bash\npython clickjacking_poc_generator.py -u https://example.com\n```\n\n### Advanced Usage\n\n```bash\n# Enable verbose output\nclickjacking-poc -u https://example.com --verbose\n\n# Enable debug mode\nclickjacking-poc -u https://example.com --debug\n\n# Combine verbose and debug\nclickjacking-poc -f urls.txt --verbose --debug\n```\n\n### Command Line Options\n\n| Option | Description |\n|--------|-------------|\n| `-u, --url` | Single URL to generate PoC for |\n| `-f, --file` | File containing list of URLs (one per line) |\n| `-o, --output` | Output filename for single URL |\n| `-d, --output-dir` | Output directory for multiple URLs (default: pocs) |\n| `-v, --verbose` | Enable verbose output |\n| `--debug` | Enable debug mode with detailed logging |\n| `-h, --help` | Show help message |\n\n## 📁 Input File Format\n\nCreate a text file with one URL per line:\n\n```\nhttps://example.com\nhttps://vulnerable-site.com/login\nhttps://target-website.com/dashboard\n```\n\n## 📤 Output\n\nThe tool generates professional HTML files with:\n\n- **Interactive PoC**: Clickable demonstration of the vulnerability\n- **Security Warnings**: Clear warnings about responsible disclosure\n- **Visual Indicators**: Overlay demonstrations and click capture\n- **Documentation**: Detailed information about the attack\n- **Responsive Design**: Works on desktop and mobile devices\n\n### Generated HTML Features\n\n- 🎯 **Clickjacking Demonstration**: Interactive iframe with overlay\n- ⚠️ **Security Warnings**: Clear warnings about responsible use\n- 📊 **Attack Information**: Detailed vulnerability information\n- 🎨 **Professional Design**: Clean, modern interface\n- 📱 **Responsive Layout**: Works on all device sizes\n- 🔧 **Debug Tools**: Built-in testing and demonstration features\n\n## 🔧 Development\n\n### Project Structure\n\n```\nclickjacking-poc-generator/\n├── clickjacking_poc_generator.py  # Main script\n├── requirements.txt                # Python dependencies\n├── pyproject.toml                  # Modern package configuration (PEP 621)\n├── .gitignore                     # Git ignore rules\n└── README.md                      # This file\n```\n\n### Code Quality\n\nThe project follows Python best practices:\n\n- **Type Hints**: Full type annotation support\n- **Error Handling**: Comprehensive exception handling\n- **Logging**: Structured logging with Rich\n- **Documentation**: Detailed docstrings and comments\n- **Modular Design**: Clean separation of concerns\n\n### Adding New Features\n\n1. Fork the repository\n2. Create a feature branch\n3. Implement your changes\n4. Add tests if applicable\n5. Submit a pull request\n\n## 🛡️ Security Considerations\n\n⚠️ **IMPORTANT**: This tool is for educational and authorized testing purposes only.\n\n- Only use on systems you own or have explicit permission to test\n- Follow responsible disclosure practices\n- Respect website terms of service\n- Do not use for malicious purposes\n\n## 📝 Examples\n\n### Example 1: Single URL PoC\n\n```bash\n# With pipx installation\nclickjacking-poc -u https://vulnerable-site.com/login\n\n# With manual installation\npython clickjacking_poc_generator.py -u https://vulnerable-site.com/login\n```\n\n**Output**: `clickjacking_poc_vulnerable-site_com.html`\n\n### Example 2: Batch Processing\n\n```bash\n# Create urls.txt with target URLs\necho \"https://site1.com\" \u003e urls.txt\necho \"https://site2.com\" \u003e\u003e urls.txt\n\n# Generate PoCs (with pipx)\nclickjacking-poc -f urls.txt -d my_pocs\n\n# Or with manual installation\npython clickjacking_poc_generator.py -f urls.txt -d my_pocs\n```\n\n**Output**: Multiple HTML files in `my_pocs/` directory\n\n### Example 3: Debug Mode\n\n```bash\n# With pipx\nclickjacking-poc -u https://example.com --debug --verbose\n\n# With manual installation\npython clickjacking_poc_generator.py -u https://example.com --debug --verbose\n```\n\n## 🐛 Troubleshooting\n\n### Common Issues\n\n1. **Invalid URL Error**\n   - Ensure URLs include protocol (http:// or https://)\n   - Check URL format and accessibility\n\n2. **File Not Found**\n   - Verify file path exists\n   - Check file permissions\n\n3. **Import Errors**\n   - Install requirements: `pip install -r requirements.txt`\n   - Check Python version (3.7+ required)\n\n### Debug Mode\n\nEnable debug mode for detailed error information:\n\n```bash\npython clickjacking_poc_generator.py --debug --verbose\n```\n\n## 🤝 Contributing\n\nContributions are welcome! Please follow these guidelines:\n\n1. Fork the repository\n2. Create a feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'Add amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\n### Development Setup\n\n```bash\n# Clone and setup\ngit clone https://github.com/yourusername/clickjacking-poc-generator.git\ncd clickjacking-poc-generator\n\n# Create virtual environment\npython -m venv venv\nsource venv/bin/activate  # On Windows: venv\\Scripts\\activate\n\n# Install dependencies\npip install -r requirements.txt\n\n# Run tests (if available)\npython -m pytest\n```\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 🙏 Acknowledgments\n\n- Security research community\n- Open source contributors\n- Rich library developers for the beautiful CLI experience\n\n## 📞 Support\n\n- **Issues**: [GitHub Issues](https://github.com/yourusername/clickjacking-poc-generator/issues)\n- **Discussions**: [GitHub Discussions](https://github.com/yourusername/clickjacking-poc-generator/discussions)\n- **Security**: For security issues, please email yeray.martin@adscanpro.com\n\n## 🔄 Changelog\n\n### Version 1.0.0\n- Initial release\n- Single URL processing\n- Batch processing from file\n- Rich CLI interface\n- Professional HTML output\n- Debug and verbose modes\n\n---\n\n**⚠️ Disclaimer**: This tool is for educational and authorized security testing purposes only. Users are responsible for ensuring they have proper authorization before testing any systems.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadscanpro%2Fclickjacking-poc-generator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fadscanpro%2Fclickjacking-poc-generator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadscanpro%2Fclickjacking-poc-generator/lists"}