# ganesh030106/ironclaud-security-webscanner architecture

> Architecture diagram of the GitHub repository ganesh030106/ironclaud-security-webscanner, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ganesh030106/ironclaud-security-webscanner
- Repository: https://github.com/ganesh030106/ironclaud-security-webscanner

## Overview

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: [`backend/scanner.py`](https://github.com/ganesh030106/ironclaud-security-webscanner/blob/main/backend/scanner.py) (Scan orchestrator), [`backend/main.py`](https://github.com/ganesh030106/ironclaud-security-webscanner/blob/main/backend/main.py) (FastAPI controller), [`backend/firewall/ironclad_waf.py`](https://github.com/ganesh030106/ironclaud-security-webscanner/blob/main/backend/firewall/ironclad_waf.py) (Signature WAF proxy), [`backend/firewall/ai_firewall.py`](https://github.com/ganesh030106/ironclaud-security-webscanner/blob/main/backend/firewall/ai_firewall.py) (AI firewall proxy)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Command Center"]
  node_dashboard["Dashboard<br/>[App.jsx]"]
  node_browser_api["API client<br/>[scanner.js]"]
end

subgraph group_api["Backend API"]
  node_api_server["FastAPI controller<br/>[main.py]"]
  node_scan_state["Scan state<br/>[main.py]"]
  node_report["PDF reporting<br/>[pdf_report.py]"]
end

subgraph group_audit["Scanning and Defense"]
  node_scanner["Scan orchestrator<br/>[scanner.py]"]
  node_config["Scanner configuration<br/>[config.py]"]
  node_advanced_checks["Advanced checks<br/>[advanced_checks.py]"]
  node_infrastructure["Infrastructure recon<br/>[advanced_recon.py]"]
  node_content_audit["Content discovery"]
  node_active_checks["Active attack checks"]
  node_specialized_checks["Specialized checks"]
  node_traffic_analysis["Traffic analysis<br/>[traffic_anomaly.py]"]
  node_defense["Defense generation"]
end

subgraph group_protection["Firewall Proxies"]
  node_waf["Signature WAF proxy<br/>[ironclad_waf.py]"]
  node_ai_firewall["AI firewall proxy<br/>[ai_firewall.py]"]
end

node_operator(("Security operator"))
node_target(("Scan target"))
node_upstream(("Protected upstream"))

node_operator -->|"operates"| node_dashboard
node_dashboard -->|"requests through"| node_browser_api
node_browser_api -->|"HTTP requests"| node_api_server
node_api_server -->|"starts scan"| node_scanner
node_scanner -->|"updates results"| node_scan_state
node_scanner -->|"audits"| node_target
node_scanner -->|"uses settings"| node_config
node_scanner -->|"delegates checks"| node_advanced_checks
node_scanner -->|"delegates recon"| node_infrastructure
node_scanner -->|"delegates discovery"| node_content_audit
node_scanner -->|"delegates checks"| node_active_checks
node_scanner -->|"delegates checks"| node_specialized_checks
node_scanner -->|"uses analysis"| node_traffic_analysis
node_scanner -->|"generates defenses"| node_defense
node_api_server -->|"creates PDF"| node_report
node_scan_state -->|"displays status"| node_dashboard
node_api_server -.->|"manages proxy settings"| node_waf
node_operator -->|"routes traffic"| node_waf
node_operator -->|"routes traffic"| node_ai_firewall
node_waf -->|"forwards allowed traffic"| node_upstream
node_ai_firewall -->|"forwards allowed traffic"| node_upstream
node_waf -.->|"uses rules"| node_config
node_ai_firewall -.->|"uses model settings"| node_config

click node_dashboard "https://github.com/ganesh030106/ironclaud-security-webscanner/blob/main/frontend/src/App.jsx"
click node_browser_api "https://github.com/ganesh030106/ironclaud-security-webscanner/blob/main/frontend/src/api/scanner.js"
click node_api_server "https://github.com/ganesh030106/ironclaud-security-webscanner/blob/main/backend/main.py"
click node_scan_state "https://github.com/ganesh030106/ironclaud-security-webscanner/blob/main/backend/main.py"
click node_scanner "https://github.com/ganesh030106/ironclaud-security-webscanner/blob/main/backend/scanner.py"
click node_config "https://github.com/ganesh030106/ironclaud-security-webscanner/blob/main/backend/config.py"
click node_advanced_checks "https://github.com/ganesh030106/ironclaud-security-webscanner/blob/main/backend/modules/advanced_checks.py"
click node_infrastructure "https://github.com/ganesh030106/ironclaud-security-webscanner/blob/main/backend/modules/advanced_recon.py"
click node_content_audit "https://github.com/ganesh030106/ironclaud-security-webscanner/blob/main/backend/modules/content_discovery.py"
click node_active_checks "https://github.com/ganesh030106/ironclaud-security-webscanner/blob/main/backend/modules/active_attackers.py"
click node_specialized_checks "https://github.com/ganesh030106/ironclaud-security-webscanner/blob/main/backend/modules/specialized_checks.py"
click node_traffic_analysis "https://github.com/ganesh030106/ironclaud-security-webscanner/blob/main/backend/modules/traffic_anomaly.py"
click node_defense "https://github.com/ganesh030106/ironclaud-security-webscanner/blob/main/backend/modules/defense_generator.py"
click node_report "https://github.com/ganesh030106/ironclaud-security-webscanner/blob/main/backend/utils/pdf_report.py"
click node_waf "https://github.com/ganesh030106/ironclaud-security-webscanner/blob/main/backend/firewall/ironclad_waf.py"
click node_ai_firewall "https://github.com/ganesh030106/ironclaud-security-webscanner/blob/main/backend/firewall/ai_firewall.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_dashboard,node_browser_api toneBlue
class node_api_server,node_scan_state,node_report toneAmber
class node_scanner,node_config,node_advanced_checks,node_infrastructure,node_content_audit,node_active_checks,node_specialized_checks,node_traffic_analysis,node_defense toneMint
class node_waf,node_ai_firewall toneRose
class node_operator,node_target,node_upstream toneIndigo
```

## Components

### Command Center

- [Dashboard](https://github.com/ganesh030106/ironclaud-security-webscanner/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [API client](https://github.com/ganesh030106/ironclaud-security-webscanner/blob/main/frontend/src/api/scanner.js): `frontend/src/api/scanner.js`

### Backend API

- [FastAPI controller](https://github.com/ganesh030106/ironclaud-security-webscanner/blob/main/backend/main.py): `backend/main.py`
- [Scan state](https://github.com/ganesh030106/ironclaud-security-webscanner/blob/main/backend/main.py): `backend/main.py`
- [PDF reporting](https://github.com/ganesh030106/ironclaud-security-webscanner/blob/main/backend/utils/pdf_report.py): `backend/utils/pdf_report.py`

### Scanning and Defense

- [Scan orchestrator](https://github.com/ganesh030106/ironclaud-security-webscanner/blob/main/backend/scanner.py): `backend/scanner.py`
- [Scanner configuration](https://github.com/ganesh030106/ironclaud-security-webscanner/blob/main/backend/config.py): `backend/config.py`
- [Advanced checks](https://github.com/ganesh030106/ironclaud-security-webscanner/blob/main/backend/modules/advanced_checks.py): `backend/modules/advanced_checks.py`
- [Infrastructure recon](https://github.com/ganesh030106/ironclaud-security-webscanner/blob/main/backend/modules/advanced_recon.py): `backend/modules/advanced_recon.py`
- [Content discovery](https://github.com/ganesh030106/ironclaud-security-webscanner/blob/main/backend/modules/content_discovery.py): `backend/modules/content_discovery.py`
- [Active attack checks](https://github.com/ganesh030106/ironclaud-security-webscanner/blob/main/backend/modules/active_attackers.py): `backend/modules/active_attackers.py`
- [Specialized checks](https://github.com/ganesh030106/ironclaud-security-webscanner/blob/main/backend/modules/specialized_checks.py): `backend/modules/specialized_checks.py`
- [Traffic analysis](https://github.com/ganesh030106/ironclaud-security-webscanner/blob/main/backend/modules/traffic_anomaly.py): `backend/modules/traffic_anomaly.py`
- [Defense generation](https://github.com/ganesh030106/ironclaud-security-webscanner/blob/main/backend/modules/defense_generator.py): `backend/modules/defense_generator.py`

### Firewall Proxies

- [Signature WAF proxy](https://github.com/ganesh030106/ironclaud-security-webscanner/blob/main/backend/firewall/ironclad_waf.py): `backend/firewall/ironclad_waf.py`
- [AI firewall proxy](https://github.com/ganesh030106/ironclaud-security-webscanner/blob/main/backend/firewall/ai_firewall.py): `backend/firewall/ai_firewall.py`

### Other components

- **Security operator**
- **Scan target**
- **Protected upstream**

## Connections

- Security operator → Dashboard: operates (evidence: `README.md`)
- Dashboard → API client: requests through (evidence: `frontend/src/App.jsx`)
- API client → FastAPI controller: HTTP requests (evidence: `README.md`)
- FastAPI controller → Scan orchestrator: starts scan (evidence: `backend/main.py`)
- Scan orchestrator → Scan state: updates results (evidence: `backend/main.py`)
- Scan orchestrator → Scan target: audits (evidence: `backend/scanner.py`)
- Scan orchestrator → Scanner configuration: uses settings (evidence: `backend/scanner.py`)
- Scan orchestrator → Advanced checks: delegates checks (evidence: `backend/scanner.py`)
- Scan orchestrator → Infrastructure recon: delegates recon (evidence: `backend/scanner.py`)
- Scan orchestrator → Content discovery: delegates discovery (evidence: `backend/scanner.py`)
- Scan orchestrator → Active attack checks: delegates checks (evidence: `backend/scanner.py`)
- Scan orchestrator → Specialized checks: delegates checks (evidence: `backend/scanner.py`)
- Scan orchestrator → Traffic analysis: uses analysis (evidence: `backend/scanner.py`)
- Scan orchestrator → Defense generation: generates defenses (evidence: `backend/scanner.py`)
- FastAPI controller → PDF reporting: creates PDF (evidence: `backend/main.py`)
- Scan state → Dashboard: displays status
- FastAPI controller → Signature WAF proxy: manages proxy settings (evidence: `backend/main.py`)
- Security operator → Signature WAF proxy: routes traffic (evidence: `README.md`)
- Security operator → AI firewall proxy: routes traffic (evidence: `README.md`)
- Signature WAF proxy → Protected upstream: forwards allowed traffic (evidence: `README.md`)
- AI firewall proxy → Protected upstream: forwards allowed traffic (evidence: `README.md`)
- Signature WAF proxy → Scanner configuration: uses rules (evidence: `backend/firewall/ironclad_waf.py`)
- AI firewall proxy → Scanner configuration: uses model settings (evidence: `backend/firewall/ai_firewall.py`)
