Add pfSense XML integration and complete workflow automation
- Add pfsense_integrator.py for automatic XML parsing and integration - Add complete_workflow.sh for one-command network discovery - Enhance integrated_scanner.py to auto-integrate pfSense XML files - Update README with pfSense XML features and workflow - Generate comprehensive network summaries from XML configs - Support for WireGuard, OpenVPN, IPsec, routing, DHCP, firewall rules
This commit is contained in:
43
README.md
43
README.md
@@ -12,6 +12,8 @@ A comprehensive network topology discovery tool that scans local and VPN-connect
|
||||
- 📊 **SVG Diagram Generation**: Creates visual network topology diagrams
|
||||
- 🔄 **Routing Analysis**: Extracts and analyzes routing tables from routers
|
||||
- 📝 **JSON Export**: Structured data output for further processing
|
||||
- 📄 **pfSense XML Parsing**: Automatically parses pfSense backup XML files for complete configuration analysis
|
||||
- 🔗 **Automatic Integration**: Seamlessly integrates pfSense XML data into network scans
|
||||
|
||||
## Requirements
|
||||
|
||||
@@ -205,6 +207,23 @@ The scanner produces JSON with the following structure:
|
||||
firefox network_topology.svg
|
||||
```
|
||||
|
||||
### Complete Automated Workflow
|
||||
|
||||
For the ultimate network discovery experience, use the automated workflow script:
|
||||
|
||||
```bash
|
||||
./complete_workflow.sh
|
||||
```
|
||||
|
||||
This script will:
|
||||
1. ✅ Verify system requirements
|
||||
2. 🔍 Run integrated network scan (including pfSense XML if present)
|
||||
3. 🎨 Generate SVG network diagram
|
||||
4. 📋 Create network summary (if pfSense XML files exist)
|
||||
5. 📊 Display statistics and next steps
|
||||
|
||||
**One-command network discovery!**
|
||||
|
||||
## SSH Access Setup
|
||||
|
||||
For automated scanning, SSH key-based authentication is recommended:
|
||||
@@ -362,3 +381,27 @@ Created for comprehensive network topology discovery and visualization.
|
||||
---
|
||||
|
||||
**Note**: Always ensure you have proper authorization before scanning networks. This tool performs active network reconnaissance.
|
||||
|
||||
### pfSense XML Integration
|
||||
|
||||
The scanner can automatically parse pfSense backup XML files to extract comprehensive configuration data:
|
||||
|
||||
- **Network Interfaces**: All interface configurations, IP addresses, VLANs
|
||||
- **Routing Tables**: Static routes, dynamic routing, gateway configurations
|
||||
- **VPN Configurations**: WireGuard tunnels, OpenVPN servers/clients, IPsec
|
||||
- **Firewall Rules**: NAT rules, port forwarding, access control lists
|
||||
- **DHCP Services**: Server configurations, static mappings, lease pools
|
||||
- **DNS Settings**: Resolvers, domain configurations
|
||||
- **System Information**: Hostname, domain, version, services
|
||||
|
||||
**Automatic Integration**: Place pfSense XML backup files in the scanner directory, and they will be automatically parsed and integrated into network scans.
|
||||
|
||||
**Manual Parsing**: Use `pfsense_integrator.py` to work with XML files independently:
|
||||
|
||||
```bash
|
||||
# Parse XML files and generate summary
|
||||
./pfsense_integrator.py *.xml --summary network_summary.md
|
||||
|
||||
# Integrate with existing scan
|
||||
./pfsense_integrator.py *.xml -s scan.json -o enhanced_scan.json
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user