diff --git a/README.md b/README.md index 20dc7e0..bee53ee 100644 --- a/README.md +++ b/README.md @@ -810,7 +810,7 @@ serverguard ### 安全防护层 (`com.aluer.security`) -这是系统中规模最大的包，包含 30+ 个安全服务： +这是系统中规模最大的包，包含 60+ 个安全服务（含 20 个超进化 v3.1 新增模块）： | 类别 | 类 | 功能 | |------|-----|------| @@ -860,6 +860,26 @@ serverguard | | `LoadBalancerService` | 简易负载均衡 | | | `TrafficShapingService` | 流量整形/QoS | | | `EncryptionService` | 数据加密工具 | +| **超进化 v3.1** | `JwtAuthService` | JWT Token HMAC-SHA256 认证，常量时间签名比对 | +| | `BruteForceProtectionService` | 三层时间窗口(60s/600s/3600s)暴力破解防护，渐进延迟 | +| | `AntiBotDetectionService` | Minecraft 机器人检测：命名模式/加入速度/多账号/客户端品牌 | +| | `AntiGriefDetectionService` | 方块破坏/放置速率监控，危险方块识别，容器掠夺检测 | +| | `ReverseShellDetectionService` | 50+ 反向Shell命令模式匹配，混淆命令检测 | +| | `ARPSpoofDetectionService` | ARP表基线对比，MAC变更/网关欺骗/重复MAC检测 | +| | `DNSTunnelDetectionService` | 子域名熵值分析，Base64编码识别，频率/TLD评分 | +| | `ExploitSignatureService` | 15+ 漏洞签名(Log4Shell/SQLi/XSS/反序列化/Book Exploit) | +| | `SSRFProtectionService` | 内网IP/云元数据/危险Scheme/DNS Rebinding防护 | +| | `XXEProtectionService` | XML实体注入 + Billion Laughs 攻击检测与净化 | +| | `CSPEnforcementService` | Content-Security-Policy + 8项安全响应头自动生成 | +| | `DatabaseFirewallService` | SQL注入检测(UNION/注释/堆叠查询/时间盲注) | +| | `DataLossPreventionService` | 12种敏感数据模式(邮箱/API Key/SSH Key/JWT/银行卡) | +| | `MemoryProtectionService` | JVM堆监控/GC过载/内存泄漏模式识别 | +| | `ProcessInjectionDetectionService` | 进程线程尖峰/内存映射/非标准native库检测 | +| | `SecureFileDeletionService` | DoD多pass覆写(0x00/随机/0xFF/0xAA)安全删除 | +| | `ForensicsCollectorService` | 6种取证数据(进程/网络/文件/日志)案件管理 | +| | `IncidentResponseService` | 5套响应剧本(DDoS/爆破/入侵/MC漏洞/数据泄露) | +| | `ThreatHuntingService` | 10种主动狩猎规则(持久化/横向移动/提权/挖矿/WebShell) | +| | `ComplianceScannerService` | 7大类20+项合规检查，自动评分(0-100%) | ### 运营控制层 (`com.aluer.console`) diff --git a/README_EN.md b/README_EN.md index 643494d..b4fbfd6 100644 --- a/README_EN.md +++ b/README_EN.md @@ -682,6 +682,26 @@ The largest package in the system, containing 30+ security services: | **Security Operations** | `SIEMService`, `SecurityOrchestrationService`, `SecurityAutomationScheduler`, `SecurityBaselineHardeningService`, `BackupSecurityService` | SIEM correlation, security orchestration, baseline hardening | | **Command Security** | `CommandExecutionGuardService` | Dangerous command interception (rm -rf / wget \| sh / privilege escalation) | | **Execution Layer** | `CloudflareIntegrationService`, `DNSSecurityService`, `SessionManagementService`, `LoadBalancerService`, `TrafficShapingService`, `EncryptionService` | Cloudflare API integration, DNS security, session management, load balancing, traffic shaping | +| **Super Evolution v3.1** | `JwtAuthService` | JWT HMAC-SHA256 auth with constant-time comparison | +| | `BruteForceProtectionService` | Three-layer time window (60s/600s/3600s) brute force defense | +| | `AntiBotDetectionService` | Minecraft bot detection: name patterns/join velocity/multi-account | +| | `AntiGriefDetectionService` | Block break/place rate monitoring, dangerous block detection | +| | `ReverseShellDetectionService` | 50+ reverse shell pattern matching + obfuscated command detection | +| | `ARPSpoofDetectionService` | ARP table baseline diff, MAC/Gateway spoof detection | +| | `DNSTunnelDetectionService` | Subdomain entropy analysis, Base64 encoding detection | +| | `ExploitSignatureService` | 15+ exploit signatures (Log4Shell/SQLi/XSS/Deserialization) | +| | `SSRFProtectionService` | Internal IP/Cloud metadata/DNS rebinding protection | +| | `XXEProtectionService` | XML entity injection + Billion Laughs attack detection | +| | `CSPEnforcementService` | Content-Security-Policy + 8 security headers auto-generation | +| | `DatabaseFirewallService` | SQL injection detection (UNION/sleep/stacked queries) | +| | `DataLossPreventionService` | 12 sensitive data patterns (email/API key/SSH key/JWT/card) | +| | `MemoryProtectionService` | JVM heap/GC overload/memory leak pattern detection | +| | `ProcessInjectionDetectionService` | Thread spike/memory mapping/non-standard native lib detection | +| | `SecureFileDeletionService` | DoD multi-pass overwrite (0x00/random/0xFF/0xAA) secure delete | +| | `ForensicsCollectorService` | 6 evidence types (process/network/files/logs) case management | +| | `IncidentResponseService` | 5 playbooks (DDoS/brute force/intrusion/MC exploit/data breach) | +| | `ThreatHuntingService` | 10 proactive hunt rules (persistence/lateral/privilege/crypto/webshell) | +| | `ComplianceScannerService` | 7 categories 20+ checks, auto compliance scoring (0-100%) | ### Operations Control Layer (`com.aluer.console`) diff --git a/docs/PROJECT_SUMMARY.md b/docs/PROJECT_SUMMARY.md index 3541d85..689e656 100644 --- a/docs/PROJECT_SUMMARY.md +++ b/docs/PROJECT_SUMMARY.md @@ -143,5 +143,95 @@ AluerIII 是一个专为 Minecraft (PaperMC) 服务器设计的高级安全防 --- +## 9. 超进化安全模块 (`com.aluer.security`) — v3.1 新增 +以下20个安全服务模块为超级进化 (Super Evolution) 版本新增，覆盖身份认证、网络攻防、应用安全、数据保护和运维响应全维度： + +### 9.1 身份与访问控制 +- **`JwtAuthService`** (JWT认证服务) + - 基于 HMAC-SHA256 的 JWT token 创建、验证、吊销。 + - 支持自定义 Claims、过期时间、自动清理。 + - 常量时间签名比对防止时序攻击。 +- **`BruteForceProtectionService`** (反暴力破解服务) + - 三层时间窗口检测 (60s/600s/3600s)。 + - 渐进式登录延迟 (1s-15s)，IP 全局阈值监控。 + - 自动账号锁定 + 自动解锁。 + +### 9.2 Minecraft 专项防护 +- **`AntiBotDetectionService`** (反机器人检测) + - 6种机器人命名模式识别，10+已知机器人前缀检测。 + - 加入速度/多账号/客户端品牌/IP洪水多维度评分。 + - Minecraft 登录和状态包频率监控。 +- **`AntiGriefDetectionService`** (反破坏检测) + - 方块破坏/放置速率监控 (150/min爆破, 200/min放置)。 + - 危险方块识别 (TNT/岩浆/水晶/凋零)。 + - 隧道挖掘模式检测，容器掠夺监控，聊天刷屏检测。 + +### 9.3 网络攻击检测 +- **`ReverseShellDetectionService`** (反向Shell检测) + - 50+ 反向Shell命令模式匹配 (bash/python/perl/php/ruby/lua/powershell)。 + - 混淆命令检测 (base64编码/eval/exec)。 + - 进程级Shell指标监控。 +- **`ARPSpoofDetectionService`** (ARP欺骗检测) + - ARP表周期性扫描与基线对比。 + - MAC地址变更/重复MAC/网关欺骗三种攻击检测。 + - 自动识别网关IP并重点监控。 +- **`DNSTunnelDetectionService`** (DNS隧道检测) + - 子域名熵值分析 (Shannon Entropy > 3.8)。 + - Base32/Base64编码子域名识别。 + - 查询频率/类型/TLD多维度评分，可疑域名TLD黑名单。 +- **`ExploitSignatureService`** (漏洞签名检测) + - 15+ 已知漏洞签名 (Log4Shell/JNDI/SQL注入/XSS/路径穿越/反序列化)。 + - Minecraft 专属漏洞 (Book Exploit/Sign Exploit/Chunk Ban/NBT Traversal)。 + - 命令注入和服务端配置篡改检测。 + +### 9.4 Web与API安全 +- **`SSRFProtectionService`** (SSRF防护) + - 内网IP/云元数据端点/危险Scheme检测。 + - DNS Rebinding + 十进制IP绕过 + URL编码绕过防护。 + - 云厂商元数据地址全覆盖 (AWS/GCP/Azure/阿里云/腾讯云)。 +- **`XXEProtectionService`** (XXE防护) + - XML实体注入 + 十亿笑 (Billion Laughs) 攻击检测。 + - 外部实体引用 + 实体扩展炸弹检测。 + - XML自动净化处理。 +- **`CSPEnforcementService`** (CSP强制执行) + - Content-Security-Policy 头自动生成。 + - 8个安全响应头 (CSP/HSTS/X-Frame/X-XSS/Referrer-Policy等)。 + - XSS/Clickjacking反射检测。 +- **`DatabaseFirewallService`** (数据库防火墙) + - SQL注入检测 (UNION/注释/永真条件/堆叠查询/时间盲注)。 + - 危险关键字拦截 (DROP/TRUNCATE/ALTER/INTO OUTFILE)。 + +### 9.5 数据与内存保护 +- **`DataLossPreventionService`** (数据防泄漏) + - 12种敏感数据模式 (邮箱/API Key/密码/SSH Key/JWT/身份证/银行卡/电话号码/数据库连接串/MC Token/RCON密码/IP地址)。 + - 自动脱敏 (Redaction) 功能，支持日志/聊天/配置文件扫描。 +- **`MemoryProtectionService`** (内存保护) + - JVM堆/非堆内存实时监控，GC过载检测。 + - 内存泄漏模式识别 (连续5次以上堆使用率上升)。 + - 自动GC触发和告警。 +- **`ProcessInjectionDetectionService`** (进程注入检测) + - 进程线程数量异常尖峰检测。 + - /proc/{pid}/maps 新内存映射监控，非标准native库检测。 + - /proc/{pid}/fd 文件描述符异常增长检测。 +- **`SecureFileDeletionService`** (安全文件删除) + - DoD 5220.22-M 风格多pass覆写 (0x00/随机/0xFF/0xAA 交替)。 + - 文件截断 + fsync + 删除，支持递归目录安全删除。 + +### 9.6 安全运维与合规 +- **`ForensicsCollectorService`** (取证收集器) + - 6种取证数据采集 (进程列表/网络连接/打开文件/系统日志/MC日志/时间戳快照)。 + - 取证案件 (Case) 管理，自动保存到 forensics/ 目录。 +- **`IncidentResponseService`** (事件响应服务) + - 5套预定义响应剧本 (DDoS攻击/暴力破解/入侵检测/MC漏洞利用/数据泄露)。 + - 自动化动作执行：限流/IP封禁/取证/备份恢复/Token吊销/密钥轮换。 +- **`ThreatHuntingService`** (威胁狩猎服务) + - 10种主动狩猎规则 (异常登录时间/可疑命令/持久化机制/横向移动/提权/数据外泄/挖矿/WebShell/后门账号/快速世界切换)。 + - 分类：MINECRAFT/COMMAND/HOST/NETWORK/WEB。 +- **`ComplianceScannerService`** (合规扫描服务) + - 7大类20+项合规检查 (文件权限/加密标准/认证要求/审计日志/网络安全/MC服务端安全/备份合规)。 + - 自动合规评分 (0-100%) 和修复建议生成。 + +--- + ### 架构总结 AluerIII 采用 **高度解耦的插件式架构**，底层通过 Spring 的依赖注入（DI）机制紧密配合。系统形成了一套 **实时监测 -> AI 深度分析 -> 策略下发 -> 自动防御** 的完整闭环，极大地降低了 Minecraft 服务器运维人员的安全管理成本。 \ No newline at end of file diff --git a/docs/USER_MANUAL.md b/docs/USER_MANUAL.md index d9c233b..0c1042d 100644 --- a/docs/USER_MANUAL.md +++ b/docs/USER_MANUAL.md @@ -388,6 +388,60 @@ export ALUER_WEBHOOK_DISCORD="https://discord.com/api/webhooks/xxx/yyy" export ALUER_WEBHOOK_SLACK="https://hooks.slack.com/services/xxx/yyy/zzz" ``` +### 超进化安全模块 API（v3.1 新增） + +#### 身份认证与访问控制 + +| 接口路径 | 方法 | 说明 | +|----------|------|------| +| `/api/security/auth/status` | GET | JWT 认证状态（活跃Token数、已吊销Token数） | +| `/api/security/brute-force/status` | GET | 暴力破解防护状态（锁定账号、检测统计） | + +#### Minecraft 专项防护 + +| 接口路径 | 方法 | 说明 | +|----------|------|------| +| `/api/security/anti-bot/status` | GET | 反机器人检测状态（被拦截IP、Bot分数） | +| `/api/security/anti-grief/status` | GET | 反破坏检测状态（被标记玩家、方块破坏率） | + +#### 网络攻击监控 + +| 接口路径 | 方法 | 说明 | +|----------|------|------| +| `/api/security/reverse-shell/status` | GET | 反向Shell检测状态 | +| `/api/security/arp-spoof/status` | GET | ARP欺骗检测状态（MAC变更记录） | +| `/api/security/dns-tunnel/status` | GET | DNS隧道检测状态 | +| `/api/security/exploit-signature/status` | GET | 漏洞签名检测统计 | +| `/api/security/exploit-signature/scan` | POST | 扫描内容中的漏洞签名 (参数: `content`, `source`) | + +#### Web与应用安全 + +| 接口路径 | 方法 | 说明 | +|----------|------|------| +| `/api/security/ssrf/status` | GET | SSRF防护状态 | +| `/api/security/xxe/status` | GET | XXE防护状态 | +| `/api/security/csp/status` | GET | CSP违规统计 | +| `/api/security/csp/headers` | GET | 获取推荐的安全响应头 | +| `/api/security/database-firewall/status` | GET | 数据库防火墙状态 | +| `/api/security/dlp/status` | GET | 数据防泄漏检测统计 | + +#### 系统保护 + +| 接口路径 | 方法 | 说明 | +|----------|------|------| +| `/api/security/memory/status` | GET | JVM内存保护状态（堆使用率、GC统计） | +| `/api/security/process-injection/status` | GET | 进程注入检测状态 | +| `/api/security/secure-delete/status` | GET | 安全文件删除统计 | + +#### 安全运维 + +| 接口路径 | 方法 | 说明 | +|----------|------|------| +| `/api/security/forensics/status` | GET | 取证案件列表与证据统计 | +| `/api/security/incident-response/status` | GET | 事件响应状态（活跃事件、剧本列表） | +| `/api/security/threat-hunting/status` | GET | 威胁狩猎状态（最近狩猎结果） | +| `/api/security/compliance/status` | GET | 合规扫描结果（评分、通过/失败项） | + --- ## 配置说明