How byteforce101-ops/ipsec-vpn-protocol-analyzer works
Cipher Lens analyzes uploaded IPsec configuration and packet-capture files: the dashboard submits a scan, the FastAPI service parses the input, evaluates security rules, scores findings, adds AI assessment and traffic classification, then returns results and attempts PDF generation. The README also documents CLI auditing, authentication, and a multi-tab dashboard. Arrows reflect the sampled orchestration and parser behavior; some frontend views and backend subsystems are documented but their implementation was not sampled.
Main entry points: main.py FastAPI Service · page.tsx Analysis Dashboard · AuthScreen.tsx Authentication Screen · pcap_parser.py PCAP Parser
Components 14
User Interface
- Analysis Dashboard
app/page.tsx - Authentication Screen
components/AuthScreen.tsx
Analysis Pipeline
- FastAPI Service
backend/main.py - PCAP Parser
backend/parser/pcap_parser.py - Config Parser
backend/parser/config_parser.py - Traffic Classifier
backend/ai/traffic_classifier.py
Security Assessment
- Security Rules
backend/engine/rules.py - Risk Scorer
backend/engine/scorer.py - AI Explainer
backend/ai/explainer.py
Reports and Access
- PDF Generator
backend/reports/pdf_generator.py - CLI Auditor
scripts/cli.py - Assessment PDF
backend/reports/pdf_generator.py
Other components
- Analyst
- Supabase Auth
Connections 13
- Analyst → Analysis Dashboard: uploads scan
- Analysis Dashboard → FastAPI Service: submits file
- FastAPI Service → PCAP Parser: parses capture
- FastAPI Service → Config Parser: parses config
- PCAP Parser → Traffic Classifier: classifies flow
- FastAPI Service → Security Rules: evaluates findings
- FastAPI Service → Risk Scorer: scores findings
- FastAPI Service → AI Explainer: enriches findings
- FastAPI Service → PDF Generator: generates report
- PDF Generator → Assessment PDF: writes PDF
- FastAPI Service → Analysis Dashboard: returns results
- Authentication Screen → Supabase Auth: authenticates
- Analyst → Authentication Screen: signs in