How sangeethhk/netclone works
NetClone is an IoT cyber-twin security framework: physical devices stream telemetry into a synchronized twin, where simulated and observed traffic is analyzed, investigated, and mitigated. The React command center exposes fleet/topology, traffic, attack, detection, XAI, attack-graph, MLSA, breach-benchmark, defense, and log views. The graph includes the documented capabilities whose implementation was not sampled, but leaves uncertain internal links out; API and UI composition edges are supported by indexed imports or excerpts.
Main entry points: App.jsx React Command Center · api.js REST Client · main.py FastAPI Application · cyber_twin.py Cyber Twin
Components 33
Fleet & Telemetry
- Telemetry Agent
agent/netclone_iot_agent.py - Twin API
backend/app/api/twin_routes.py - Cyber Twin
backend/app/core/cyber_twin.py - LAN Discovery
backend/app/core/network_scanner.py
Traffic & Detection
- Traffic & Features
backend/app/core/traffic_generator.py - Attack API
backend/app/api/attack_routes.py - Attack Simulator
backend/app/core/attack_simulator.py - Detection API
backend/app/api/detection_routes.py - Autoencoder
backend/app/models/autoencoder.py - Isolation Forest Ensemble
backend/app/models/isolation_forest.py
Investigation & Defense
- XAI Forensics
backend/app/models/xai_engine.py - Attack Graph
backend/app/core/attack_graph.py - Defense API
backend/app/api/defense_routes.py - Dynamic Defense
backend/app/core/defense_engine.py - Breach Benchmark
backend/app/core/breach_simulator.py
Identity & MLSA
- MLSA API
backend/app/api/mlsa_routes.py - MLSA Authentication
backend/app/core/mlsa_auth.py - SQLite State
backend/app/core/database.py
Command Center
- FastAPI Application
backend/app/main.py - REST Client
frontend/src/services/api.js - React Command Center
frontend/src/App.jsx - Fleet Manager
frontend/src/components/DeviceFleetManager.jsx - Twin Topology
frontend/src/components/CyberTwinTopology.jsx - Traffic Monitor
frontend/src/components/TrafficMonitor.jsx - AI Detection Panel
frontend/src/components/AIDetectionPanel.jsx - Attack Simulator UI
frontend/src/components/AttackSimulator.jsx - XAI Inspector
frontend/src/components/XAIPanel.jsx - Attack Graph Viewer
frontend/src/components/AttackGraphViewer.jsx - Defense Panel
frontend/src/components/AutomatedDefense.jsx - MLSA Panel
frontend/src/components/MLSAPanel.jsx - Breach Bench UI
frontend/src/components/MLSABreachBench.jsx - Security Logs
frontend/src/components/SecurityLogs.jsx
Other components
- IoT Devices
Connections 46
- IoT Devices → Telemetry Agent: streams telemetry
README.md - Telemetry Agent → Twin API: posts telemetry
README.md - Twin API → Cyber Twin: ingests devices
backend/app/api/twin_routes.py - Twin API → LAN Discovery: requests discovery
backend/app/api/twin_routes.py - Cyber Twin → Traffic & Features: records packets
backend/app/core/cyber_twin.py - Attack Simulator → Cyber Twin: updates twin
backend/app/core/attack_simulator.py - Attack API → Attack Simulator: controls simulation
backend/app/api/attack_routes.py - Traffic & Features → Autoencoder: provides features
- Detection API → Autoencoder: evaluates vectors
backend/app/api/detection_routes.py - Detection API → Isolation Forest Ensemble: evaluates vectors
backend/app/api/detection_routes.py - FastAPI Application → Detection API: registers routes
backend/app/main.py - FastAPI Application → Twin API: registers routes
backend/app/main.py - FastAPI Application → Attack API: registers routes
backend/app/main.py - FastAPI Application → MLSA API: registers routes
backend/app/main.py - FastAPI Application → Defense API: registers routes
backend/app/main.py - Attack Graph → Cyber Twin: reads topology
backend/app/core/attack_graph.py - Attack Graph → Dynamic Defense: reads mitigations
backend/app/core/attack_graph.py - Defense API → Dynamic Defense: controls defense
backend/app/api/defense_routes.py - Defense API → Cyber Twin: checks devices
backend/app/api/defense_routes.py - Dynamic Defense → SQLite State: writes alerts
backend/app/core/defense_engine.py - MLSA API → MLSA Authentication: handles authentication
backend/app/api/mlsa_routes.py - MLSA API → SQLite State: uses persistence
backend/app/api/mlsa_routes.py - MLSA Authentication → SQLite State: persists credentials
backend/app/core/mlsa_auth.py - FastAPI Application → SQLite State: initializes store
backend/app/main.py - React Command Center → Fleet Manager: renders
frontend/src/App.jsx - React Command Center → Twin Topology: renders
frontend/src/App.jsx - React Command Center → Traffic Monitor: renders
frontend/src/App.jsx - React Command Center → AI Detection Panel: renders
frontend/src/App.jsx - React Command Center → Attack Simulator UI: renders
frontend/src/App.jsx - React Command Center → XAI Inspector: renders
frontend/src/App.jsx - React Command Center → Attack Graph Viewer: renders
frontend/src/App.jsx - React Command Center → Defense Panel: renders
frontend/src/App.jsx - React Command Center → MLSA Panel: renders
frontend/src/App.jsx - React Command Center → Breach Bench UI: renders
frontend/src/App.jsx - React Command Center → Security Logs: renders
frontend/src/App.jsx - Fleet Manager → REST Client: calls
frontend/src/components/DeviceFleetManager.jsx - AI Detection Panel → REST Client: calls
frontend/src/components/AIDetectionPanel.jsx - Attack Graph Viewer → REST Client: calls
frontend/src/components/AttackGraphViewer.jsx - Defense Panel → REST Client: calls
frontend/src/components/AutomatedDefense.jsx - MLSA Panel → REST Client: calls
frontend/src/components/MLSAPanel.jsx - Breach Bench UI → REST Client: calls
frontend/src/components/MLSABreachBench.jsx - Security Logs → REST Client: calls
frontend/src/components/SecurityLogs.jsx - REST Client → FastAPI Application: HTTP requests
frontend/src/services/api.js - REST Client → Attack Graph: requests graph
frontend/src/services/api.js - REST Client → XAI Forensics: requests attribution
frontend/src/services/api.js - REST Client → Breach Benchmark: requests benchmark
frontend/src/services/api.js