Skip to content

ByteBandit-100/SCCSIMS

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

111 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ›‘οΈ Smart College Cyber Security & Infrastructure Management System (SCCSIMS)

A lightweight yet powerful LAN Monitoring & Cybersecurity Platform designed to detect unauthorized devices, monitor system activity, and provide administrators with real-time network visibility.

πŸš€ Built as a final-year project demonstrating practical implementation of cybersecurity, network monitoring, and SOC-style systems.


πŸ“Έ Project Preview

Login page Dashboard
Screenshot 2026-04-04 214130 image
Scan Port Logs Viewer
image image

πŸš€ Key Features

βœ” Real-time device monitoring
βœ” LAN network discovery (ARP + Ping scanning)
βœ” Rogue / unauthorized device detection
βœ” Duplicate IP & spoofing detection
βœ” Trusted device approval system
βœ” Live SOC-style dashboard
βœ” Port scanning with risk classification
βœ” PDF security report generation
βœ” CPU & RAM monitoring of client systems
βœ” Scan history logging (SQLite)


🧠 System Architecture

Client Agent (agent.py)
        β”‚
        β”‚ Sends system data every 10 seconds
        β–Ό
Flask Server (app.py)
        β”‚
        β”œβ”€β”€ Device Monitoring API
        β”œβ”€β”€ Logging & Activity Monitoring
        β”œβ”€β”€ Network Scanner (ARP + Ping)
        β”œβ”€β”€ Rogue Device Detection
        β”œβ”€β”€ Device Authorization Management (Approve / Disapprove)
        β”œβ”€β”€ Port Scanner Module
        β”œβ”€β”€ Report Generator (PDF)
        └── Admin Dashboard (Web Interface)
        β”‚
        β–Ό

SQLite Database (sccsims.db)

πŸ› οΈ Tech Stack

Component Technology
Backend Python
Web Framework Flask
Database SQLite
Network Scanning Scapy, Socket
Concurrency Multithreading(ThreadPoolExecutor)
Data Visualization Matplotilib, NumPy
System Monitoring psutil
Frontend HTML, CSS, JavaScript
Reporting ReportLab
Security Werkzeug (Password Hashing)

πŸ“œ Logging & Monitoring

  • Implemented using Python’s built-in logging module

  • Tracks:

    • Server activity
    • Network scans
    • Threat detection events
    • Admin actions (approve/disapprove)
  • Logs stored in: sccsims.log

βš™οΈ Installation & Setup

1️⃣ Clone Repository

git clone https://github.com/ByteBandit-100/SCCSIMS.git
cd SCCSIMS

2️⃣ Install Dependencies

pip install -r requirements.txt

3️⃣ Update /server/arp_scanner.py

INTERFACE = [your_system_working_interface_id] 
OR 
INTERFACE = None   #BY DEFAULT

4️⃣ ⃣ Run Server

python app.py

🌐 Access Dashboard:

http://localhost:5000

πŸ” Default Credentials

Username: admin
Password: admin123

⚠️ Change credentials before production use.


πŸ–₯️ Running the Monitoring Agent

On each client machine:

1. Update Server IP in agent.py

SERVER_URL = "http://SERVER_IP:5000/api/device"

2. Run Agent

python agent.py

πŸ“‘ Device sends system data every 2 seconds*


πŸ“Š Features Breakdown

πŸ” Network Monitoring

  • Detects all devices in LAN
  • Tracks IP, MAC, hostname
  • Real-time updates

🚨 Threat Detection

  • Rogue device detection
  • Duplicate IP detection
  • Unauthorized access alerts

πŸ”Ž Port Scanner

  • Multi-threaded scanning
  • Risk classification (LOW / HIGH)
  • Live scan updates

πŸ“„ Report Generation

  • Professional PDF reports
  • Risk highlighting (RED for HIGH)
  • Summary + recommendations

πŸ›‘οΈ Security Concepts Demonstrated

  • Network Discovery
  • Device Fingerprinting
  • Rogue Device Detection
  • Port Vulnerability Analysis
  • Real-Time Monitoring
  • Basic SOC (Security Operations Center) Design

🎯 Unique Highlights

πŸ”₯ SOC-style dashboard (rare in student projects)
πŸ”₯ Terminal + Web hybrid monitoring
πŸ”₯ Real-time threat detection
πŸ”₯ Automated PDF reporting system


⚠️ Limitations

  • Works only in LAN environment
  • No advanced IDS (Snort/Suricata level)
  • No encrypted communication between agent & server
  • Basic authentication system

πŸš€ Future Enhancements

  • Intrusion Detection System (IDS)
  • ARP spoofing protection
  • WebSocket real-time updates
  • Role-based authentication
  • Network topology visualization
  • Cloud deployment support

πŸ‘¨β€πŸ’» Author

Mohit (ByteBandit-100)


⭐ Contribution

Feel free to fork, improve, and submit pull requests!


πŸ“œ License

This project is for educational purposes.


πŸ’‘ Final Note

This project demonstrates how cybersecurity concepts can be implemented in a real-world mini SOC system, making it highly suitable for academic and practical learning.


About

Smart College Cyber Security & Infrastructure Management System (SCCSIMS) is a lightweight LAN monitoring and rogue device detection platform built with Python, Flask, and Scapy. It performs real-time network discovery, device monitoring, and unauthorized device detection for small networks such as college labs and classrooms.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors