How lohit30/tor-analysis works
Tor-Trace is a forensic web application for ingesting PCAP or demo traffic, correlating packet patterns with Tor relay data, and presenting case results and reports. Analysts use the frontend to manage sessions and nodes, run analysis, inspect timelines and probable circuits, and generate reports. The backend routers own requests and persistence; analysis invokes the correlation engine, while session ingestion invokes PCAP parsing or demo generation. The README is empty, so capabilities are inferred from the source index and excerpts; unsampled router/service internals are represented conservatively.
Main entry points: App.jsx Web app · main.py API application · api.js API client · database.py Database access
Components 23
Analyst interface
- Web app
Tor-Tracezip/Tor-Trace/frontend/src/App.jsx - Dashboard
Tor-Tracezip/Tor-Trace/frontend/src/pages/Dashboard.jsx - Relay nodes
Tor-Tracezip/Tor-Trace/frontend/src/pages/Nodes.jsx - Packet timeline
Tor-Tracezip/Tor-Trace/frontend/src/pages/Timeline.jsx - Analysis view
Tor-Tracezip/Tor-Trace/frontend/src/pages/Analysis.jsx - Reports view
Tor-Tracezip/Tor-Trace/frontend/src/pages/Reports.jsx - Data table
Tor-Tracezip/Tor-Trace/frontend/src/components/DataTable.jsx - Analysis visuals
Tor-Tracezip/Tor-Trace/frontend/src/components/NetworkGraph.jsx - Confidence gauge
Tor-Tracezip/Tor-Trace/frontend/src/components/ConfidenceGauge.jsx - API client
Tor-Tracezip/Tor-Trace/frontend/src/services/api.js
Backend API
- API application
Tor-Tracezip/Tor-Trace/backend/main.py - Session routes
Tor-Tracezip/Tor-Trace/backend/routers/sessions.py - Node routes
Tor-Tracezip/Tor-Trace/backend/routers/nodes.py - Analysis routes
Tor-Tracezip/Tor-Trace/backend/routers/analysis.py - Report routes
Tor-Tracezip/Tor-Trace/backend/routers/reports.py - API schemas
Tor-Tracezip/Tor-Trace/backend/models/schemas.py
Forensic processing
- PCAP parser
Tor-Tracezip/Tor-Trace/backend/services/pcap_analyzer.py - Traffic simulator
Tor-Tracezip/Tor-Trace/backend/services/tor_simulator.py - Correlation engine
Tor-Tracezip/Tor-Trace/backend/services/correlation_engine.py - Report generator
Tor-Tracezip/Tor-Trace/backend/services/report_generator.py
Case records
- Database access
Tor-Tracezip/Tor-Trace/backend/database.py - Forensics database
Tor-Tracezip/Tor-Trace/forensics.db
Other components
- Analyst
Connections 33
- Analyst → Web app: uses
Tor-Tracezip/Tor-Trace/frontend/src/App.jsx - Web app → Dashboard: routes to
Tor-Tracezip/Tor-Trace/frontend/src/App.jsx - Web app → Relay nodes: routes to
Tor-Tracezip/Tor-Trace/frontend/src/App.jsx - Web app → Packet timeline: routes to
Tor-Tracezip/Tor-Trace/frontend/src/App.jsx - Web app → Analysis view: routes to
Tor-Tracezip/Tor-Trace/frontend/src/App.jsx - Web app → Reports view: routes to
Tor-Tracezip/Tor-Trace/frontend/src/App.jsx - Dashboard → API client: requests data
Tor-Tracezip/Tor-Trace/frontend/src/pages/Dashboard.jsx - Relay nodes → API client: requests nodes
Tor-Tracezip/Tor-Trace/frontend/src/pages/Nodes.jsx - Packet timeline → API client: requests packets
Tor-Tracezip/Tor-Trace/frontend/src/pages/Timeline.jsx - Analysis view → API client: submits analysis
Tor-Tracezip/Tor-Trace/frontend/src/pages/Analysis.jsx - Reports view → API client: requests reports
Tor-Tracezip/Tor-Trace/frontend/src/pages/Reports.jsx - Relay nodes → Data table: renders
Tor-Tracezip/Tor-Trace/frontend/src/pages/Nodes.jsx - Packet timeline → Data table: renders
Tor-Tracezip/Tor-Trace/frontend/src/pages/Timeline.jsx - Reports view → Data table: renders
Tor-Tracezip/Tor-Trace/frontend/src/pages/Reports.jsx - Analysis view → Analysis visuals: renders circuit
Tor-Tracezip/Tor-Trace/frontend/src/pages/Analysis.jsx - Analysis view → Confidence gauge: renders score
Tor-Tracezip/Tor-Trace/frontend/src/pages/Analysis.jsx - API client → API application: calls API
Tor-Tracezip/Tor-Trace/frontend/src/services/api.js - API application → Session routes: registers routes
Tor-Tracezip/Tor-Trace/backend/main.py - API application → Node routes: registers routes
Tor-Tracezip/Tor-Trace/backend/main.py - API application → Analysis routes: registers routes
Tor-Tracezip/Tor-Trace/backend/main.py - API application → Report routes: registers routes
Tor-Tracezip/Tor-Trace/backend/main.py - Session routes → Traffic simulator: generates demo
Tor-Tracezip/Tor-Trace/backend/routers/sessions.py - Session routes → PCAP parser: parses upload
Tor-Tracezip/Tor-Trace/backend/routers/sessions.py - Session routes → Database access: stores sessions
Tor-Tracezip/Tor-Trace/backend/routers/sessions.py - Node routes → Database access: reads and writes
Tor-Tracezip/Tor-Trace/backend/routers/nodes.py - Analysis routes → Correlation engine: runs scoring
Tor-Tracezip/Tor-Trace/backend/routers/analysis.py - Analysis routes → Database access: loads and saves
Tor-Tracezip/Tor-Trace/backend/routers/analysis.py - Report routes → Report generator: generates report
Tor-Tracezip/Tor-Trace/backend/routers/reports.py - Report routes → Database access: reads and writes
Tor-Tracezip/Tor-Trace/backend/routers/reports.py - API application → Database access: initializes store
Tor-Tracezip/Tor-Trace/backend/main.py - Database access → Forensics database: connects to
Tor-Tracezip/Tor-Trace/backend/database.py - Session routes → API schemas: uses data models
- Analysis routes → API schemas: validates requests
Tor-Tracezip/Tor-Trace/backend/routers/analysis.py