How ganesh030106/ironclaud-security-webscanner works
IronClad combines a browser command center, a FastAPI scan-and-management API, modular target auditing, and two independently run reverse-proxy firewalls. The main workflow is operator → scan request → backend orchestration and audits → results/status and exports → dashboard. README capabilities also include WAF configuration/logs, AI firewall status/reset, and generated defense recommendations. Several subsystem links are documented or indexed, but unsampled implementation details are not assumed; firewall proxies are shown as independent traffic paths.
Main entry points: scanner.py Scan orchestrator · main.py FastAPI controller · ironclad_waf.py Signature WAF proxy · ai_firewall.py AI firewall proxy
Components 19
Command Center
- Dashboard
frontend/src/App.jsx - API client
frontend/src/api/scanner.js
Backend API
- FastAPI controller
backend/main.py - Scan state
backend/main.py - PDF reporting
backend/utils/pdf_report.py
Scanning and Defense
- Scan orchestrator
backend/scanner.py - Scanner configuration
backend/config.py - Advanced checks
backend/modules/advanced_checks.py - Infrastructure recon
backend/modules/advanced_recon.py - Content discovery
backend/modules/content_discovery.py - Active attack checks
backend/modules/active_attackers.py - Specialized checks
backend/modules/specialized_checks.py - Traffic analysis
backend/modules/traffic_anomaly.py - Defense generation
backend/modules/defense_generator.py
Firewall Proxies
- Signature WAF proxy
backend/firewall/ironclad_waf.py - AI firewall proxy
backend/firewall/ai_firewall.py
Other components
- Security operator
- Scan target
- Protected upstream
Connections 23
- Security operator → Dashboard: operates
README.md - Dashboard → API client: requests through
frontend/src/App.jsx - API client → FastAPI controller: HTTP requests
README.md - FastAPI controller → Scan orchestrator: starts scan
backend/main.py - Scan orchestrator → Scan state: updates results
backend/main.py - Scan orchestrator → Scan target: audits
backend/scanner.py - Scan orchestrator → Scanner configuration: uses settings
backend/scanner.py - Scan orchestrator → Advanced checks: delegates checks
backend/scanner.py - Scan orchestrator → Infrastructure recon: delegates recon
backend/scanner.py - Scan orchestrator → Content discovery: delegates discovery
backend/scanner.py - Scan orchestrator → Active attack checks: delegates checks
backend/scanner.py - Scan orchestrator → Specialized checks: delegates checks
backend/scanner.py - Scan orchestrator → Traffic analysis: uses analysis
backend/scanner.py - Scan orchestrator → Defense generation: generates defenses
backend/scanner.py - FastAPI controller → PDF reporting: creates PDF
backend/main.py - Scan state → Dashboard: displays status
- FastAPI controller → Signature WAF proxy: manages proxy settings
backend/main.py - Security operator → Signature WAF proxy: routes traffic
README.md - Security operator → AI firewall proxy: routes traffic
README.md - Signature WAF proxy → Protected upstream: forwards allowed traffic
README.md - AI firewall proxy → Protected upstream: forwards allowed traffic
README.md - Signature WAF proxy → Scanner configuration: uses rules
backend/firewall/ironclad_waf.py - AI firewall proxy → Scanner configuration: uses model settings
backend/firewall/ai_firewall.py