5 Commits

Author SHA1 Message Date
fc9e07ad46 Polish README: highlight production-readiness and architectural improvements
This update transforms the README from good to awesome by showcasing the
recent v0.4.0 architectural refactor and production-ready status.

### What's New:

**1. Production Status Badges**
- Added "Production Ready" badge
- Added "Architecture Reviewed" badge linking to code review

**2. Competitive Positioning**
- Added "Why Not fail2ban / iptables?" comparison table
- Shows concrete advantages over traditional solutions
- Highlights protocol-awareness and real-time blocking

**3. Live Demo Section**
- "See It In Action" with actual svwar attack scenario
- Shows immediate enumeration detection and ban
- Includes step-by-step explanation of what happened

**4. Performance & Resource Usage Section**
- Quantifies improvements from architectural refactor
- Before/after table showing 99.996% goroutine reduction
- Lists all critical and high-priority fixes from v0.4.0
- Links to CODE_REVIEW_MATT_HOLT.md for technical details

**5. Updated Changelog**
- Added v0.4.0 entry with production hardening details
- Lists all architectural improvements
- Highlights impact: zero memory leaks, bounded resources

### Impact:
README now effectively communicates:
 Production-ready status (not just a prototype)
 Concrete performance characteristics
 Why choose this over alternatives
 Real-world attack scenarios and responses

The README is now **awesome** - balancing marketing (why use this?) with
technical depth (how it works under the hood).
2025-12-25 15:10:31 -07:00
5cf34eb3c0 Add DNS-aware whitelisting feature
Support for whitelisting SIP trunks and providers by hostname or SRV
record with automatic IP resolution and periodic refresh.

Features:
- Hostname resolution via A/AAAA records
- SRV record resolution (e.g., _sip._udp.provider.com)
- Configurable refresh interval (default 5m)
- Stale entry handling when DNS fails
- Admin API endpoints for DNS whitelist management
- Caddyfile directives: whitelist_hosts, whitelist_srv, dns_refresh

This allows whitelisting by provider name rather than tracking
constantly-changing IP addresses.
2025-12-08 00:46:43 -07:00
46a47ce2c6 Polish README with enhanced formatting and new sections
Improvements:
- Add badges (Go version, Caddy version, License, Tests)
- Add "Why SIP Guardian?" comparison table vs traditional approaches
- Add collapsible sections for long config examples and API docs
- Add Troubleshooting section with 5 common issues and solutions
- Add Changelog section tracking v0.1.0 through v0.3.0
- Add emoji icons for feature categories
- Improve tables with severity indicators (colored dots)
- Add "What It Hides" before/after comparison table
- Add Debug Mode instructions
- Use horizontal rules for better section separation
- Add minimal config example alongside full config
2025-12-07 21:19:17 -07:00
f03ac453e0 Update README with comprehensive Phase 1 documentation
Documents all new features:
- Extension enumeration detection with config examples
- SIP message validation rules and modes
- Topology hiding (B2BUA-lite) with request/response flow diagrams
- Complete Caddyfile configuration reference
- Prometheus metrics reference
- Admin API endpoints
- Integration examples for FreePBX, Kamailio, and HA setups
- Security considerations

Architecture diagram updated to show full processing pipeline.
2025-12-07 20:40:11 -07:00
1ba05e160c Initial commit: Caddy SIP Guardian module
Layer 4 SIP protection with:
- SIP traffic matching (REGISTER, INVITE, etc.)
- Rate limiting and automatic IP banning
- Attack pattern detection (sipvicious, friendly-scanner)
- CIDR whitelisting
- Admin API for ban management
2025-12-06 16:38:07 -07:00