CyberGuard Pro - Advanced Security Suite

Important: For best compatibility, use Python 3.11 or 3.10. Some dependencies (such as netifaces) may not work on Python 3.12+ or 3.13, especially on Windows. If you encounter installation issues, please install Python 3.11 from python.org.

System dependencies required:

• Windows:
  • Npcap (for network monitoring)
  • Visual C++ Build Tools
  • Windows SDK (for comtypes)
• Linux: python3-tk, python3-dev, libpcap-dev, libmagic1, nmap
• macOS: python-tk, libpcap, libmagic, nmap

A comprehensive network security and monitoring tool designed to provide enterprise-grade security features for threat detection, vulnerability scanning, and network analysis. CyberGuard Pro helps security professionals and system administrators maintain robust network security through advanced monitoring and analysis capabilities.

Table of Contents

• Features
• Installation Instructions
• Configuration
• Usage Guide
• Troubleshooting
• Security Considerations
• Contributing
• Support
• License

Features

Core Security Features

• Network Traffic Monitoring

  • Real-time packet capture and analysis
  • Protocol inspection and traffic classification
  • Bandwidth usage monitoring
  • Suspicious traffic pattern detection

• Vulnerability Scanning

  • Automated security assessment
  • Common vulnerability checks
  • Configuration audit
  • Security baseline verification

• WiFi Network Analysis

  • Network discovery and mapping
  • Signal strength analysis
  • Channel interference detection
  • Rogue access point detection

• File Threat Detection

  • Malware scanning
  • File integrity monitoring
  • Suspicious file behavior analysis
  • Integration with VirusTotal API

• Port Scanning

  • Open port detection
  • Service enumeration
  • Security posture assessment
  • Custom scan profiles

• Anomaly Detection

  • Machine learning-based threat detection
  • Behavioral analysis
  • Pattern recognition
  • Real-time alerting

• Security Reporting

  • Customizable report generation
  • Compliance documentation
  • Trend analysis
  • Executive summaries

Installation Instructions

Prerequisites

• Python 3.7 or higher
• Administrator/root privileges (required for network monitoring)
• Windows OS (for WMI functionality)
• Minimum 4GB RAM
• 1GB free disk space

Step 1: Install Python

1. Download Python from python.org
2. During installation:
   • Check "Add Python to PATH"
   • Enable "Install pip"
   • Enable "Install for all users" (recommended)

Step 2: Install Required Packages

# Create and activate virtual environment (recommended)
python -m venv venv
source venv/bin/activate  # Linux/Mac
venv\Scripts\activate     # Windows

# Install all required packages
pip install -r requirements.txt

Step 3: Additional Setup

For Windows Users:

1. Install Npcap (required for Scapy):

   • Download from npcap.com
   • Install with default options
   • Ensure "Install Npcap in WinPcap API-compatible Mode" is checked

2. Install WinPcap (alternative to Npcap):

   • Download from winpcap.org
   • Install with default options
   • Restart your system after installation

For Linux Users:

# Install system dependencies
sudo apt-get update
sudo apt-get install python3-tk
sudo apt-get install libpcap-dev
sudo apt-get install nmap
sudo apt-get install python3-dev

Configuration

VirusTotal API Setup

1. Sign up for a free account at VirusTotal
2. Get your API key from your profile settings
3. Configure the API key:

   # Set as environment variable
   export VIRUSTOTAL_API_KEY='your-api-key'  # Linux/Mac
   set VIRUSTOTAL_API_KEY=your-api-key       # Windows

Network Configuration

1. Configure network interfaces in config/network.json
2. Set scan ranges and exclusions
3. Configure alert thresholds

Usage Guide

Basic Usage

# Run the application
python sorcecode.py

# Run with specific configuration
python sorcecode.py --config custom_config.json

# Run in debug mode
python sorcecode.py --debug

Command Line Options

• --config: Specify custom configuration file
• --debug: Enable debug logging
• --scan: Run specific scan type
• --report: Generate report only
• --monitor: Start monitoring mode

Troubleshooting

Common Issues and Solutions

1. Permission Errors

   • Run the application with administrator/root privileges
   • Windows: Right-click and "Run as Administrator"
   • Linux: Use sudo python main.py
   • Check file and directory permissions

2. Missing Dependencies

   • Ensure all packages are installed: pip install -r requirements.txt
   • Check system dependencies are installed
   • Verify Python version compatibility
   • Check for conflicting package versions

3. Network Monitoring Issues

   • Ensure Npcap/WinPcap is installed correctly
   • Check firewall settings and exceptions
   • Verify network adapter permissions
   • Check for antivirus interference

4. GUI Issues

   • Ensure tkinter is installed
   • Check Python version compatibility
   • Verify display settings
   • Check for conflicting Python installations

5. Windows-Specific Warnings

   • If you see warnings about python-magic or pywifi:
     • Install Windows SDK if not already installed
     • Run pip install comtypes manually if needed
     • Ensure you're using python-magic-bin instead of python-magic on Windows
   • If WiFi monitoring features are limited:
     • Ensure you have administrator privileges
     • Check if your wireless adapter supports monitoring mode
     • Verify Windows SDK is properly installed

Security Considerations

• Always run the application with appropriate permissions
• Keep the application and dependencies updated
• Regularly review and update security configurations
• Monitor system resources during scans
• Follow security best practices for API key management

Contributing

We welcome contributions! Please follow these steps:

1. Fork the repository
2. Create a feature branch
3. Commit your changes
4. Push to the branch
5. Create a Pull Request

Support

For issues and support:

1. Check the Troubleshooting section
2. Search existing issues
3. Create a new issue with:
   • Detailed description of the problem
   • Steps to reproduce
   • System information
   • Error logs

License

This project is licensed under the MIT License - see the LICENSE file for details.