Skip to content

Hellooo667/SentinelScan

Repository files navigation

Advanced Malware Detection & Classification System

A comprehensive cross-platform malware detection and classification system built with Rust (frontend) and Python (backend) using deep learning techniques.

πŸš€ Features

Core Detection Capabilities

  • Static Feature Extraction

    • Bytecode/hex dump analysis
    • PE header information extraction
    • Opcode sequence analysis
    • Import/Export table analysis
    • Section entropy calculation
  • Dynamic Feature Extraction (Optional)

    • API/system call tracing
    • Network activity monitoring
    • Sandbox behavior logs
    • Registry/file system changes

Machine Learning Models

  • CNN Models: Grayscale image representation for malware visualization
  • RNN/LSTM Models: Sequential analysis of opcodes and API calls
  • Transformer Models: Advanced pattern recognition and attention mechanisms
  • Classical ML: SVM, Random Forest, Gradient Boosting for baseline comparison

Detection & Classification

  • Binary Classification: Malware vs. Benign detection
  • Multi-class Classification: Malware family identification
  • Real-time Detection: Sub-second inference capability
  • Adversarial Robustness: Handling obfuscated/packed malware

Advanced Features

  • Model Comparison Dashboard: Performance metrics across different architectures
  • Explainable AI: Grad-CAM, SHAP, attention visualization
  • Threat Intelligence Integration: VirusTotal API, custom IOC feeds
  • Automated Retraining Pipeline: CI/CD for model updates
  • Comprehensive Reporting: PDF/JSON reports with detailed analysis

πŸ—οΈ Architecture

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚                    Frontend (Rust)                             β”‚
β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
β”‚  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”‚
β”‚  β”‚   GUI Layer     β”‚  β”‚  File Handler   β”‚  β”‚   API Client    β”‚ β”‚
β”‚  β”‚   (Tauri/egui)  β”‚  β”‚   (tokio-fs)    β”‚  β”‚    (reqwest)    β”‚ β”‚
β”‚  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β”‚
β”‚  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”‚
β”‚  β”‚ Real-time Mon.  β”‚  β”‚ Report Gen.     β”‚  β”‚ Settings Mgmt   β”‚ β”‚
β”‚  β”‚   (sysinfo)     β”‚  β”‚   (PDF/JSON)    β”‚  β”‚   (config)      β”‚ β”‚
β”‚  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                               β”‚
                         HTTP/WebSocket
                               β”‚
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚                 Backend (Python)                               β”‚
β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
β”‚  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”‚
β”‚  β”‚   API Gateway   β”‚  β”‚ Authentication  β”‚  β”‚   Load Balancer β”‚ β”‚
β”‚  β”‚   (FastAPI)     β”‚  β”‚    (JWT)        β”‚  β”‚    (Nginx)      β”‚ β”‚
β”‚  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β”‚
β”‚  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”‚
β”‚  β”‚ ML Pipeline     β”‚  β”‚  Feature Ext.   β”‚  β”‚   Model Serve   β”‚ β”‚
β”‚  β”‚ (TensorFlow/    β”‚  β”‚   (Static/      β”‚  β”‚   (TF Serving/  β”‚ β”‚
β”‚  β”‚  PyTorch)       β”‚  β”‚   Dynamic)      β”‚  β”‚   TorchServe)   β”‚ β”‚
β”‚  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β”‚
β”‚  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”‚
β”‚  β”‚   Database      β”‚  β”‚   File Storage  β”‚  β”‚   Cache Layer   β”‚ β”‚
β”‚  β”‚ (PostgreSQL +   β”‚  β”‚   (MinIO/S3)    β”‚  β”‚    (Redis)      β”‚ β”‚
β”‚  β”‚  InfluxDB)      β”‚  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β”‚
β”‚  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜                                          β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                               β”‚
                    Isolated Network Bridge
                               β”‚
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚                 Sandboxed Analysis Layer                       β”‚
β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
β”‚  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”‚
β”‚  β”‚ Docker Sandbox  β”‚  β”‚  VM Isolation   β”‚  β”‚  Network Jail   β”‚ β”‚
β”‚  β”‚   (gVisor)      β”‚  β”‚   (QEMU/KVM)    β”‚  β”‚   (iptables)    β”‚ β”‚
β”‚  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β”‚
β”‚  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”‚
β”‚  β”‚ Dynamic Analysisβ”‚  β”‚  Behavior Mon.  β”‚  β”‚  API Hooking    β”‚ β”‚
β”‚  β”‚   (Cuckoo)      β”‚  β”‚   (Sysmon)      β”‚  β”‚   (Detours)     β”‚ β”‚
β”‚  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

πŸ› οΈ Tech Stack

Frontend (Rust)

  • GUI: Tauri + React/Vue or native egui
  • HTTP: reqwest, tokio
  • System: sysinfo, notify
  • Serialization: serde

Backend (Python)

  • Framework: FastAPI, Uvicorn
  • ML: TensorFlow, PyTorch, Scikit-learn
  • Feature Extraction: pefile, python-magic, capstone
  • Database: PostgreSQL, Redis
  • Tasks: Celery, RQ

Infrastructure

  • Containerization: Docker, Docker Compose
  • Monitoring: Prometheus, Grafana
  • CI/CD: GitHub Actions

πŸ“ Project Structure

MalAnalysis/
β”œβ”€β”€ frontend/              # Rust application
β”œβ”€β”€ backend/               # Python API server
β”œβ”€β”€ ml_models/            # Model definitions and training
β”œβ”€β”€ feature_extraction/   # Static/dynamic analysis tools
β”œβ”€β”€ data/                 # Datasets and samples
β”œβ”€β”€ docker/               # Container configurations
β”œβ”€β”€ scripts/              # Utility scripts
└── docs/                 # Documentation

πŸš€ Quick Start

  1. Clone and Setup

    git clone <repository>
    cd MalAnalysis
  2. Backend Setup

    cd backend
    pip install -r requirements.txt
    python -m uvicorn main:app --reload
  3. Frontend Setup

    cd frontend
    cargo run
  4. Docker Deployment

    docker-compose up -d

πŸ“Š Model Performance

Model Accuracy F1-Score Inference Time
CNN 97.2% 0.971 0.3s
LSTM 95.8% 0.955 0.5s
Transformer 98.1% 0.979 0.7s

πŸ”’ Security Considerations

  • Sandboxed analysis environment
  • Encrypted file storage
  • Secure API endpoints
  • Audit logging
  • Role-based access control

πŸ“ˆ Roadmap

  • Advanced obfuscation detection
  • Cloud-native deployment
  • Mobile platform support
  • Federated learning capabilities
  • YARA rule integration

🀝 Contributing

Please read CONTRIBUTING.md for contribution guidelines.

πŸ“„ License

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

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published