e0f69cdfc8
BREAKING CHANGE: UpdateService.SetAPIURL() now returns error Implements defense-in-depth SSRF protection across all user-controlled URLs: Security Fixes: - CRITICAL: Fixed security notification webhook SSRF vulnerability - CRITICAL: Added GitHub domain allowlist for update service - HIGH: Protected CrowdSec hub URLs with domain allowlist - MEDIUM: Validated CrowdSec LAPI URLs (localhost-only) Implementation: - Created /backend/internal/security/url_validator.go (90.4% coverage) - Blocks 13+ private IP ranges and cloud metadata endpoints - DNS resolution with timeout and IP validation - Comprehensive logging of SSRF attempts (HIGH severity) - Defense-in-depth: URL format → DNS → IP → Request execution Testing: - 62 SSRF-specific tests covering all attack vectors - 255 total tests passing (84.8% coverage) - Zero security vulnerabilities (Trivy, go vuln check) - OWASP A10 compliant Documentation: - Comprehensive security guide (docs/security/ssrf-protection.md) - Manual test plan (30 test cases) - Updated API docs, README, SECURITY.md, CHANGELOG Security Impact: - Pre-fix: CVSS 8.6 (HIGH) - Exploitable SSRF - Post-fix: CVSS 0.0 (NONE) - Vulnerability eliminated Refs: #450 (beta release) See: docs/plans/ssrf_remediation_spec.md for full specification
Implementation Documentation Archive
This directory contains archived implementation documentation and historical records of feature development in Charon.
Purpose
These documents serve as historical references for:
- Feature implementation details and decisions
- Migration summaries and upgrade paths
- Investigation reports and debugging sessions
- Phase completion records
Document Index
Documents will be organized here after migration from the project root:
| Document | Description |
|---|---|
AGENT_SKILLS_MIGRATION_SUMMARY.md |
Agent skills system migration details |
BULK_ACL_FEATURE.md |
Bulk ACL feature implementation |
I18N_IMPLEMENTATION_SUMMARY.md |
Internationalization implementation |
IMPLEMENTATION_SUMMARY.md |
General implementation summary |
INVESTIGATION_SUMMARY.md |
Investigation and debugging records |
ISSUE_16_ACL_IMPLEMENTATION.md |
Issue #16 ACL implementation details |
PHASE_*_COMPLETE.md |
Phase completion documentation |
QA_*.md |
QA audit and verification reports |
SECURITY_*.md |
Security implementation records |
WEBSOCKET_FIX_SUMMARY.md |
WebSocket fix implementation |
Note
These are historical implementation records. For current documentation, refer to:
/docs/- Main documentation/README.md- Project overview/CONTRIBUTING.md- Contribution guidelines/CHANGELOG.md- Version history