From 98657ace5bd3c635114904cb0b3176a89b941595 Mon Sep 17 00:00:00 2001 From: luqingjie <544309509@qq.com> Date: Mon, 16 Nov 2026 02:09:23 -0500 Subject: [PATCH] =?UTF-8?q?=E5=AE=89=E5=85=A8=E9=98=B2=E6=8A=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .planning/pinggy-network-trace/findings.md | 3 + .planning/pinggy-network-trace/progress.md | 4 + .planning/pinggy-network-trace/task_plan.md | 6 +- README.md | 3 + deploy/security/egress.nft.example | 32 +++++ deploy/security/nginx-admin-allow.conf | 5 + deploy/security/nginx-management.conf | 16 +++ docs/network-request-trace.md | 6 +- docs/security-hardening.md | 117 ++++++++++++++++++ pom.xml | 7 ++ .../task/DmPlayerentOnlineStatusTask.java | 3 +- .../task/PaymentLedgerReconciliationTask.java | 1 + .../ruoyi/task/PaymentOrderExpireTask.java | 1 + .../ruoyi/task/PayoutConfirmationTask.java | 1 + .../java/com/ruoyi/task/TronPaymentTask.java | 1 + .../task/UsdtConfigBalanceRefreshTask.java | 1 + .../ruoyi/task/WalletSnapshotRefreshTask.java | 1 + .../core/filter/ManagementSourceFilter.java | 64 ++++++++++ .../main/resources/application-hardening.yml | 9 ++ .../filter/ExistingYamlCompatibilityTest.java | 18 +++ .../filter/ManagementSourceFilterTest.java | 49 ++++++++ .../SafeYamlPropertySourceLoader.java | 109 ++++++++++++++++ .../main/resources/META-INF/spring.factories | 4 + .../SafeYamlPropertySourceLoaderTest.java | 102 +++++++++++++++ .../src/test/resources/security-bootstrap.yml | 11 ++ 25 files changed, 570 insertions(+), 4 deletions(-) create mode 100644 deploy/security/egress.nft.example create mode 100644 deploy/security/nginx-admin-allow.conf create mode 100644 deploy/security/nginx-management.conf create mode 100644 docs/security-hardening.md create mode 100644 ruoyi-admin/src/main/java/com/ruoyi/web/core/filter/ManagementSourceFilter.java create mode 100644 ruoyi-admin/src/main/resources/application-hardening.yml create mode 100644 ruoyi-admin/src/test/java/com/ruoyi/web/core/filter/ExistingYamlCompatibilityTest.java create mode 100644 ruoyi-admin/src/test/java/com/ruoyi/web/core/filter/ManagementSourceFilterTest.java create mode 100644 ruoyi-system/src/main/java/com/ruoyi/system/security/SafeYamlPropertySourceLoader.java create mode 100644 ruoyi-system/src/main/resources/META-INF/spring.factories create mode 100644 ruoyi-system/src/test/java/com/ruoyi/system/security/SafeYamlPropertySourceLoaderTest.java create mode 100644 ruoyi-system/src/test/resources/security-bootstrap.yml diff --git a/.planning/pinggy-network-trace/findings.md b/.planning/pinggy-network-trace/findings.md index f90c5de..add0591 100644 --- a/.planning/pinggy-network-trace/findings.md +++ b/.planning/pinggy-network-trace/findings.md @@ -1,4 +1,7 @@ # 当前证据 +实施:Quartz 源码方法注解允许列表,覆盖启动/CRUD/恢复/立即运行/创建调度/最终执行;保留8类现有专用任务入口,所有 @Scheduled 业务不改。两根POM SnakeYAML 2.3,使用安全属性加载适配器保持 Boot 2.2 profile/扁平化兼容。管理接口来源过滤默认回环,提供代理及 nftables 模板;真实服务器地址/回调出站清单未知,线上网络规则不能盲目应用。 +实际捕获栈确认 Quartz -> JobInvokeUtil -> Yaml.load -> ScriptEngineManager -> URLClassLoader -> Pinggy;用户提供 sys_job 8/12 启用的恶意 YAML 任务及 11 的命令载荷。数据库写入入口未确认。 +Quartz 源码在兄弟仓库 ruoyi-common,应用使用本地依赖 JAR,必须构建并交付该模块,不能仅改 myEpusdt。 扩展静态扫描完成:466 个运行依赖 JAR、125848 个条目,目标域名/IP 的明文、UTF-16、Base64 和百分号编码均未命中,扫描错误 0;阴性结果不能排除动态拼接、数据库配置或实际部署差异。 前轮已确认 AWS ELB 域名为 grpc.nile.trongrid.io 的 CNAME。 前轮扫描运行依赖未找到两个 Pinggy 域名明文。org.json:json:19970182 含授权校验逻辑,但尚未与 Pinggy 关联。 diff --git a/.planning/pinggy-network-trace/progress.md b/.planning/pinggy-network-trace/progress.md index b33b9f8..0742333 100644 --- a/.planning/pinggy-network-trace/progress.md +++ b/.planning/pinggy-network-trace/progress.md @@ -1,4 +1,8 @@ # 排查进度 +最终安全测试17项全部通过:Quartz6、安全YAML6、来源过滤4、现有全部YAML配置兼容1。此前原91项业务/诊断回归0失败、1跳过。修复别名循环/指数展开及CGLIB代理授权兼容后完成增量打包。 +完成clean package和后续最终源码package;实际发布classpath再次运行11项YAML/来源测试全通过。外置lib仅snakeyaml-2.3.jar;Quartz源码制品与发布制品SHA256一致;执行器内含新system及SnakeYAML2.3。仅清理并重建标准target构建输出,没有删除业务数据或任务证据。 +代理/nftables仅交付模板,Windows无nginx/nft工具也无远程Linux会话,未宣称线上生效;真实数据库任务与网络清单需在部署环境核对。 +安全修复首轮验证:Quartz隔离5项全通过;应用相关100项、0失败、1跳过(含5项安全YAML测试、4项来源过滤测试),真实最小Spring启动验证profile选择。另新增当前全部配置文件兼容测试准备运行。已有JDK8/SnakeYAML2.x无参构造器不兼容通过优先属性加载工厂适配,未升级整套Spring。 最终相关回归:91 项,0 失败,0 错误,1 项跳过;其中诊断独立 JVM 测试 5 项全部通过,新增验证已有安全策略拒绝读取诊断配置时仍正常启动。 扩展扫描 466 个依赖 JAR 的 125848 条目,无目标字符串命中、无扫描错误。已完成中文启用与判读文档;仍需实际复现环境输出才能归因具体包。 已读取两个入口、POM、配置和当前工作区规则。保留已有修改,不执行 Git 历史查询。 diff --git a/.planning/pinggy-network-trace/task_plan.md b/.planning/pinggy-network-trace/task_plan.md index 535a7bd..b09d450 100644 --- a/.planning/pinggy-network-trace/task_plan.md +++ b/.planning/pinggy-network-trace/task_plan.md @@ -1,6 +1,6 @@ # Pinggy 异常外联定位 ## Next Step -在实际复现服务启用诊断,采集首条完整调用栈以确认请求来源;本地实现与验证已完成。 +本地实现、测试及打包完成;按安全部署文档在实际环境配置可信来源/出站目标并切换新制品。 ### Phase 1: 当前调用链与证据检查 **Status:** complete ### Phase 2: 定位代码与隔离验证 @@ -9,3 +9,7 @@ **Status:** complete ## Boundaries 不改业务逻辑,不主动请求可疑域名,不启动带真实数据库及链上调度的完整服务。 +### Phase 4: 安全修复与兼容性核查 +**Status:** complete +### Phase 5: 安全回归与部署交付 +**Status:** complete diff --git a/README.md b/README.md index a3035fb..9bf3405 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,8 @@ ## 平台简介 +Quartz 任意调用和 YAML 远程加载链已增加执行允许列表及安全解析,管理接口默认仅允许回环来源。 +部署必须同步更新 Quartz/system/YAML 依赖,并按[安全加固说明](docs/security-hardening.md)配置可信来源和代理规则。 + 临时排查未知域名外联可启用[网络调用来源诊断](docs/network-request-trace.md),记录 DNS 调用栈和实际加载的 JAR 来源;默认关闭,适用于 JDK 8。 TRON 密钥生成、地址校验和离线签名恢复通过现有 Trident 与 `TronKey` 适配实现,不再依赖 `tron-wallet-cli`;钱包派生路径、地址编码和投票交易行为保持兼容。后端请使用 JDK 8 编译。 diff --git a/deploy/security/egress.nft.example b/deploy/security/egress.nft.example new file mode 100644 index 0000000..a611caf --- /dev/null +++ b/deploy/security/egress.nft.example @@ -0,0 +1,32 @@ +# nftables 配置模板,不能原样部署:必须替换服务 UID 并填入所有业务目标。 +# 仅约束专用 Java 服务用户的出站流量,不清空现有防火墙规则。 +# 其他出站链仍可进一步拒绝本表放行的流量。需同时检查容器网络/转发路径。 +define service_uid = 99999 +table inet usdt_egress { + set dns4 { type ipv4_addr; flags interval; } + set dns6 { type ipv6_addr; flags interval; } + set business4 { type ipv4_addr; flags interval; } + set business6 { type ipv6_addr; flags interval; } + set database4 { type ipv4_addr; flags interval; } + set database6 { type ipv6_addr; flags interval; } + chain output { + type filter hook output priority 10; policy accept; + meta skuid $service_uid jump java_egress + } + chain java_egress { + # 保留现有连接的返回流量;应用应在规则生效后重启,避免保留旧恶意出站连接。 + ct state established,related accept + oifname "lo" accept + ip daddr @dns4 udp dport 53 accept + ip6 daddr @dns6 udp dport 53 accept + ip daddr @dns4 tcp dport 53 accept + ip6 daddr @dns6 tcp dport 53 accept + ip daddr @database4 tcp dport { 3306, 6379 } accept + ip6 daddr @database6 tcp dport { 3306, 6379 } accept + # 端口按实际服务配置调整;IP 集合包含 RPC、执行器、回调、OAuth 等业务目标。 + ip daddr @business4 tcp dport { 80, 443, 50051, 50061 } accept + ip6 daddr @business6 tcp dport { 80, 443, 50051, 50061 } accept + limit rate 5/second log prefix "usdt-egress-denied " + counter reject + } +} diff --git a/deploy/security/nginx-admin-allow.conf b/deploy/security/nginx-admin-allow.conf new file mode 100644 index 0000000..3bdb7fa --- /dev/null +++ b/deploy/security/nginx-admin-allow.conf @@ -0,0 +1,5 @@ +# 复制到 /etc/nginx/snippets/usdt-admin-allow.conf。 +# 仅在此处添加实际管理员公网 IP / VPN 网段;不要放行 0.0.0.0/0。 +allow 127.0.0.1; +allow ::1; +deny all; diff --git a/deploy/security/nginx-management.conf b/deploy/security/nginx-management.conf new file mode 100644 index 0000000..a24a108 --- /dev/null +++ b/deploy/security/nginx-management.conf @@ -0,0 +1,16 @@ +# 合并到现有对外 server 中。使用 /prod-api 前缀的若依部署与直接路径均覆盖。 +# 必须放在其他正则 location 前,且不能被现有 ^~ /prod-api/ 或精确 location 绕过。 +# 合并后使用 nginx -T 核对实际命中的 location,再 nginx -t。 +# 若前面还有 CDN/LB,仅对可信代理设置 real_ip;禁止信任全网的转发头。 +location ~ ^/(?:prod-api/)?(?:monitor/(?:job|jobLog)|druid)(?:[/.;]|$) { + include /etc/nginx/snippets/usdt-admin-allow.conf; + # 与现有网关相同的 URI 去前缀行为,保留查询串。 + rewrite ^/prod-api/(.*)$ /$1 break; + proxy_pass http://127.0.0.1:8080; + proxy_set_header Host $host; + proxy_set_header X-Real-IP $remote_addr; + proxy_set_header X-Forwarded-For $remote_addr; + proxy_set_header X-Forwarded-Proto $scheme; +} +# 如需整个管理站仅限 VPN,在独立管理域名的 server 级 include 上面的 allow 文件; +# 对外支付 API / OAuth 回调 / Telegram webhook 继续放在原公共 server,避免误封业务。 diff --git a/docs/network-request-trace.md b/docs/network-request-trace.md index fab92a9..298485a 100644 --- a/docs/network-request-trace.md +++ b/docs/network-request-trace.md @@ -3,8 +3,10 @@ ## 当前结论与证据边界 `grpc.nile.trongrid.io` 的 AWS ELB CNAME 属于已有 Nile 查询链路。 -两个 `*.run.pinggy-free.link` 域名的 DNS 记录不能直接确定 Java 调用者, -也不能凭 NXDOMAIN 断言已经成功连接或外传信息。 +最初的 DNS 记录不能直接确定 Java 调用者;后续实际调用栈和数据库记录已确认: +`sys_job` 8/12 的恶意任务通过 Quartz → Yaml.load → ScriptEngineManager → URLClassLoader +触发两个 Pinggy 域名的远程 JAR 加载尝试。是否成功下载、执行或外传仍需主机证据。 +修复和部署步骤见[安全加固](security-hardening.md)。 已检查的本地动态插件 JAR 和 `D:/configs/license.dll` 中未命中目标域名的明文、 UTF-16 或 Base64 内容。此前识别到 `org.json:json:19970182` 含授权代码, diff --git a/docs/security-hardening.md b/docs/security-hardening.md new file mode 100644 index 0000000..72a0215 --- /dev/null +++ b/docs/security-hardening.md @@ -0,0 +1,117 @@ +# Quartz 入侵链修复与网络隔离部署 + +## 本轮实现 + +`sys_job` 的恶意调用链为 Quartz → 任意类反射 → SnakeYAML → 远程 JAR。 +修复作用于后续执行,不能证明已被入侵的操作系统恢复可信,也不删除数据库中的取证记录。 + +1. Quartz 仅能调用已有 Spring Bean 上标记 `@AllowedJobMethod` 的 public、非 static、void 方法, + 并精确匹配参数类型。禁止完整类名实例化、继承的通用对象方法、表达式及非标量参数。 + 新增、修改、恢复、立即运行、创建调度和最终执行均校验;最终执行检查不能通过直接改库绕过。 +2. 启动发现非法任务只记录 jobId 并跳过,不修改原记录、不阻止合法任务启动。 + 因此历史恶意记录仍可能显示“正常”,但不会被本轮版本加载执行。 +3. 两个根 POM 统一锁定 SnakeYAML 2.3。`SafeYamlPropertySourceLoader` 在 Spring 启动前注册, + 适配 Boot 2.2,使用 SafeConstructor、禁止重复键、限制别名 50、嵌套 50 层及 3 Mi 字符输入。 + 展开阶段拒绝循环别名,限制展开节点 100000;保留普通 Map/列表、占位符、Unicode、多文档 profile + 选择与简单锚点;不打印配置 Map。 + 适配器返回标准属性源,不提供旧 OriginTrackedYamlLoader 的逐字段行号元数据。 +4. Java 入口增加 `/monitor/job`、`/monitor/jobLog`、`/druid` 来源 CIDR 检查(包含子路径及旧 MVC 后缀)。 + 默认仅允许回环对端,不读取 X-Forwarded-For;来源通过后仍须原有认证/权限检查。 + 支付 API、回调、OAuth、WebSocket 及 `@Scheduled` 调度不在该限制范围。 + +## 现有任务兼容 + +当前已授权的专用任务入口: + +| Bean | 方法 | +| --- | --- | +| ryTask | ryNoParams、ryParams(String)、ryMultipleParams(String,Boolean,Long,Double,Integer) | +| dmPlayerentOnlineStatusTask | execute | +| paymentLedgerReconciliationTask | reconcile | +| paymentOrderExpireTask | expireOrders | +| payoutConfirmationTask | confirm | +| tronPaymentTask | scan | +| usdtConfigBalanceRefreshTask | refresh | +| walletSnapshotRefreshTask | produce | + +原有无参 `bean.method` / `bean.method()` 和单引号字符串、Boolean、Long(L)、Double(D)、Integer +调用格式保留;正常支付、归集和钱包派生逻辑没有改写。 +数据库无法从本机连接,因此部署前仍须核对真实库内其他合法 Quartz 任务。 +如有表外自定义任务,应审查对应专用 Bean 及方法后在源码加注解并测试,不能放行任意包或通用 Service。 +`UsdtAggregationExecutorTask` 当前不是 Spring Bean,也没有启用调度;本次没有额外启用该旧执行器。 + +## 构建与更新范围 + +两个项目是独立 Maven reactor,Quartz 来自兄弟目录,必须先构建它: + +```powershell +cd D:/myprojects/usdt/ruoyi-common +mvn -pl ruoyi-quartz -am install +cd ../myEpusdt +mvn clean package -DskipTests +``` + +外置 lib 部署使用新的干净发布目录,包含新 `ruoyi-admin.jar`、`ruoyi-system-3.4.0.jar`、 +`ruoyi-quartz-3.4.0.jar`、`snakeyaml-2.3.jar` 及本轮依赖清单中的其他 JAR。 +不要往旧 lib 叠加文件;旧 `snakeyaml-1.*.jar`、旧 Quartz 或旧 system 不能留在同一 classpath。 +保留原部署目录用于取证/恢复配置;不能通过回滚到有漏洞的旧程序恢复运行。 +若独立链上执行器也部署,使用本轮构建的执行器制品,避免继续携带旧 YAML 依赖。 + +## 管理来源和代理配置 + +**同机 Nginx:** 保留当前 profiles 并追加 `hardening`(例如 `prod,rental,hardening`), +使 Java 只监听 127.0.0.1。Nginx 的所有业务上游需指向该回环端口;该 profile 不应直接用于跨主机代理。 + +`deploy/security/nginx-admin-allow.conf` 加入实际管理员公网 IP/VPN CIDR 后复制到 +`/etc/nginx/snippets/usdt-admin-allow.conf`,把 `nginx-management.conf` 合入现有 server。 +按实际 Java 端口及前端 API 前缀调整模板,不替换原 TLS、公共 API、WebSocket 配置。 +模板默认只允许回环,不含虚构的管理员 IP。 + +已有 `^~ /prod-api/`、更早的正则或精确 location 可能使安全 location 失效,必须用 `nginx -T` +核查优先级;必要时把相同 allow 规则直接合并到现有管理 location。 +若前面还有 CDN/LB,仅信任明确代理网段的 real_ip 配置,不能信任客户端转发头。 +Java 默认只能看到同机代理地址,所以**代理层来源控制不可省略**。 + +跨主机代理/管理员直连时,用外部配置设置: + +```text +SECURITY_MANAGEMENT_ALLOWED_CIDRS=10.8.0.0/24,192.0.2.10/32 +``` + +上述地址仅为格式示例,必须换成真实可信网段;跨主机 Java 应绑定私网地址,主机安全组仅允许代理访问。 +如需整个管理站只限 VPN,使用独立管理域名并在 server 层 include 来源规则;原公共支付域名继续提供 +商户 API、支付/租赁回调、OAuth 回调、Telegram webhook 和节点 WebSocket,不能直接对公共 server 全面 deny。 + +先执行 `nginx -t`,再 reload;验证可信来源能管理任务,不可信来源返回 403,伪造 X-Forwarded-For 仍拒绝。 +确认公网不能直接访问 Java、3306 和 6379;MySQL/Redis 若在独立主机上,用其安全组仅放行业务私网来源。 + +## 出站控制 + +`deploy/security/egress.nft.example` 是专用服务 UID 的 IPv4/IPv6 出站允许列表模板,未在本机或服务器加载。 +先用真实服务用户 UID 替换 99999,并填充 dns、database、business 地址集合及实际端口。 +不能以 root 运行服务后对整个 root UID 套用该规则;容器需在其实际网络命名空间/转发链上配置等价策略。 + +业务清单至少核实:MySQL、Redis、DNS、TRON 主网/Nile 的 HTTP/gRPC、TronGrid/TronScan、 +链上执行器、资源租赁供应商、商户支付/代付/租赁回调、Google OAuth、Telegram、OSS/MinIO 及启用的插件外联。 +动态域名的 IP 变更和 IPv6 必须一并维护;任意公网商户回调应经受控出站代理动态审批,不能使用固定 +IP 模板后假定所有回调可用。不要通过允许所有 443 来“修复”连接失败,这会放回恶意 HTTPS 下载。 + +先在隔离测试环境核对业务目标,使用 `nft -c -f <配置文件>` 校验后再安排实际部署。 +表名为 `usdt_egress`,不执行 `flush ruleset`;回退时只移除该专用表,不清空其他防火墙。 +模板保留 established/related,部署切换需重启应用以断开旧恶意连接。 +默认空集合会拒绝未登记的业务外联,因此不能原样应用。 +本机是 Windows,未提供远程 Linux 会话,不能宣称已完成 Nginx/nftables 的线上生效验证。 + +## 发布后核验 + +本地验证:Quartz 安全测试 6 项、安全 YAML 6 项、管理来源过滤 4 项、当前全部配置兼容 1 项, +合计 17 项全通过;另有原业务/诊断回归 91 项,0 失败、1 项真实转账测试跳过。 +最终制品 classpath 的 11 项 YAML/来源测试复测通过;已核对外置 lib 仅含 SnakeYAML 2.3, +Quartz 源码制品与发布依赖的 SHA256 相同,执行器也包含更新后的 YAML/system。 +本地未启动连接真实数据库和链上的完整业务应用;以下线上核验需在部署环境完成。 + +- 日志中的任务 8/12 等非法 jobId 被拒绝加载;其他合法任务按期运行。 +- 数据库任务管理的新增、修改、恢复和立即执行均拒绝非法目标,且没有发起网络解析。 +- 支付创建/查询、入账扫描、回调、资源租赁及执行器调用在隔离环境分别验证。 +- 核对实际加载的 SnakeYAML 只有 2.3,启动没有 NoSuchMethodError。 +- 保留 `[NETWORK-TRACE]` 观察窗口,确认不再由恶意任务触发 Pinggy 外联。 diff --git a/pom.xml b/pom.xml index 6128c66..2d544d8 100644 --- a/pom.xml +++ b/pom.xml @@ -16,6 +16,7 @@ UTF-8 UTF-8 1.8 + 2.3 3.1.1 1.2.4 1.21 @@ -45,6 +46,12 @@ + + + org.yaml + snakeyaml + ${snakeyaml.version} + diff --git a/ruoyi-admin/src/main/java/com/ruoyi/task/DmPlayerentOnlineStatusTask.java b/ruoyi-admin/src/main/java/com/ruoyi/task/DmPlayerentOnlineStatusTask.java index b14da01..c00fc05 100644 --- a/ruoyi-admin/src/main/java/com/ruoyi/task/DmPlayerentOnlineStatusTask.java +++ b/ruoyi-admin/src/main/java/com/ruoyi/task/DmPlayerentOnlineStatusTask.java @@ -18,6 +18,7 @@ public class DmPlayerentOnlineStatusTask { private IDmPlayerentService dmPlayerentService; @Scheduled(cron = "0/5 * * * * ?") + @com.ruoyi.quartz.annotation.AllowedJobMethod public void execute() { // com.license.LicenseBootstrap.init(); LambdaQueryWrapper queryWrapper = new LambdaQueryWrapper<>(); @@ -38,4 +39,4 @@ public class DmPlayerentOnlineStatusTask { int count = dmPlayerentService.count(queryWrapper); System.setProperty("globalCount", count+""); } -} \ No newline at end of file +} diff --git a/ruoyi-admin/src/main/java/com/ruoyi/task/PaymentLedgerReconciliationTask.java b/ruoyi-admin/src/main/java/com/ruoyi/task/PaymentLedgerReconciliationTask.java index 2ee2e1e..2e1aa17 100644 --- a/ruoyi-admin/src/main/java/com/ruoyi/task/PaymentLedgerReconciliationTask.java +++ b/ruoyi-admin/src/main/java/com/ruoyi/task/PaymentLedgerReconciliationTask.java @@ -20,6 +20,7 @@ public class PaymentLedgerReconciliationTask { } @org.springframework.scheduling.annotation.Scheduled(fixedDelay = 30000L) + @com.ruoyi.quartz.annotation.AllowedJobMethod public void reconcile() { List orderIds = ledgerPostingService.findOrderIdsRequiringSettlement(BATCH_SIZE); for (Long orderId : orderIds) { diff --git a/ruoyi-admin/src/main/java/com/ruoyi/task/PaymentOrderExpireTask.java b/ruoyi-admin/src/main/java/com/ruoyi/task/PaymentOrderExpireTask.java index 20463dd..ccb1a85 100644 --- a/ruoyi-admin/src/main/java/com/ruoyi/task/PaymentOrderExpireTask.java +++ b/ruoyi-admin/src/main/java/com/ruoyi/task/PaymentOrderExpireTask.java @@ -15,6 +15,7 @@ public class PaymentOrderExpireTask { @Autowired private IUsdtOrdersService orders; @Scheduled(fixedDelay = 10000L) + @com.ruoyi.quartz.annotation.AllowedJobMethod public void expireOrders() { LambdaQueryWrapper query = new LambdaQueryWrapper() .eq(UsdtOrdersPlus::getStatus, 1) diff --git a/ruoyi-admin/src/main/java/com/ruoyi/task/PayoutConfirmationTask.java b/ruoyi-admin/src/main/java/com/ruoyi/task/PayoutConfirmationTask.java index 9dd71f3..37da06b 100644 --- a/ruoyi-admin/src/main/java/com/ruoyi/task/PayoutConfirmationTask.java +++ b/ruoyi-admin/src/main/java/com/ruoyi/task/PayoutConfirmationTask.java @@ -16,6 +16,7 @@ public class PayoutConfirmationTask { } @Scheduled(fixedDelay = 30000L) + @com.ruoyi.quartz.annotation.AllowedJobMethod public void confirm() { service.confirmPending(); } diff --git a/ruoyi-admin/src/main/java/com/ruoyi/task/TronPaymentTask.java b/ruoyi-admin/src/main/java/com/ruoyi/task/TronPaymentTask.java index e63da30..8785ac7 100644 --- a/ruoyi-admin/src/main/java/com/ruoyi/task/TronPaymentTask.java +++ b/ruoyi-admin/src/main/java/com/ruoyi/task/TronPaymentTask.java @@ -39,6 +39,7 @@ public class TronPaymentTask { private TronChainDataClient chainDataClient; @Scheduled(fixedDelay = 10000L) + @com.ruoyi.quartz.annotation.AllowedJobMethod public void scan() { ITronService tron = null; try { diff --git a/ruoyi-admin/src/main/java/com/ruoyi/task/UsdtConfigBalanceRefreshTask.java b/ruoyi-admin/src/main/java/com/ruoyi/task/UsdtConfigBalanceRefreshTask.java index 74e5dd1..0097a6f 100644 --- a/ruoyi-admin/src/main/java/com/ruoyi/task/UsdtConfigBalanceRefreshTask.java +++ b/ruoyi-admin/src/main/java/com/ruoyi/task/UsdtConfigBalanceRefreshTask.java @@ -32,6 +32,7 @@ public class UsdtConfigBalanceRefreshTask { /** 默认每 30 秒刷新一次,完成上一轮后再计算间隔,防止慢查询堆积。 */ @Scheduled(fixedDelayString = "${payment.usdt-config-balance.refresh-delay-ms:15000}") + @com.ruoyi.quartz.annotation.AllowedJobMethod public void refresh() { UsdtConfigPlus config = usdtConfigMapper.selectOne(new LambdaQueryWrapper() .select(UsdtConfigPlus::getId, UsdtConfigPlus::getTokenAddress) diff --git a/ruoyi-admin/src/main/java/com/ruoyi/task/WalletSnapshotRefreshTask.java b/ruoyi-admin/src/main/java/com/ruoyi/task/WalletSnapshotRefreshTask.java index 6c7a531..e3dc4cc 100644 --- a/ruoyi-admin/src/main/java/com/ruoyi/task/WalletSnapshotRefreshTask.java +++ b/ruoyi-admin/src/main/java/com/ruoyi/task/WalletSnapshotRefreshTask.java @@ -13,6 +13,7 @@ public class WalletSnapshotRefreshTask { /** 每轮按更新时间投递五个钱包。 */ @Scheduled(fixedDelayString = "${payment.wallet-snapshot.producer-delay-ms:10000}") + @com.ruoyi.quartz.annotation.AllowedJobMethod public void produce() { walletSnapshotRefreshService.enqueueScheduledBatch(); } diff --git a/ruoyi-admin/src/main/java/com/ruoyi/web/core/filter/ManagementSourceFilter.java b/ruoyi-admin/src/main/java/com/ruoyi/web/core/filter/ManagementSourceFilter.java new file mode 100644 index 0000000..2450a6b --- /dev/null +++ b/ruoyi-admin/src/main/java/com/ruoyi/web/core/filter/ManagementSourceFilter.java @@ -0,0 +1,64 @@ +package com.ruoyi.web.core.filter; + +import java.io.IOException; +import java.util.ArrayList; +import java.util.List; +import javax.servlet.FilterChain; +import javax.servlet.ServletException; +import javax.servlet.http.HttpServletRequest; +import javax.servlet.http.HttpServletResponse; +import org.springframework.beans.factory.annotation.Value; +import org.springframework.core.Ordered; +import org.springframework.core.annotation.Order; +import org.springframework.security.web.util.matcher.IpAddressMatcher; +import org.springframework.stereotype.Component; +import org.springframework.web.filter.OncePerRequestFilter; + +/** + * 调度管理/数据库监控的额外来源限制,不替代原有登录与权限检查。 + * 只信任 TCP 对端地址,绝不采信客户端可伪造的 X-Forwarded-For。 + * 使用本机反向代理时必须同时启用代理层来源限制,否则应用只看得到代理地址。 + * 默认仅回环访问;跨主机代理或直连管理员通过受控外部配置加入明确 CIDR。 + */ +@Component +@Order(Ordered.HIGHEST_PRECEDENCE + 20) +public class ManagementSourceFilter extends OncePerRequestFilter { + private final List allowed = new ArrayList<>(); + + public ManagementSourceFilter(@Value("${security.management.allowed-cidrs:127.0.0.1/32,::1/128}") + String cidrs) { + for (String value : cidrs.split(",")) { + String cidr = value.trim(); + // 地址必须为数值格式,配置错误时启动失败,避免把主机名交给 DNS 解析。 + if (!cidr.matches("[0-9a-fA-F:.]+(?:/[0-9]{1,3})?")) { + throw new IllegalArgumentException("管理来源配置必须是数值 IP/CIDR"); + } + allowed.add(new IpAddressMatcher(cidr)); + } + } + + @Override + protected void doFilterInternal(HttpServletRequest request, HttpServletResponse response, + FilterChain chain) throws ServletException, IOException { + // servletPath 来自容器映射,避免使用带 contextPath/查询串的原始请求 URI。 + String path = request.getServletPath(); + if (protectedPath(path)) { + boolean permitted = false; + for (IpAddressMatcher matcher : allowed) { + if (matcher.matches(request)) { permitted = true; break; } + } + if (!permitted) { + response.setStatus(HttpServletResponse.SC_FORBIDDEN); + response.setContentType("application/json;charset=UTF-8"); + response.getWriter().write("{\"code\":403,\"msg\":\"管理接口来源不允许\"}"); + return; + } + } + chain.doFilter(request, response); + } + + private boolean protectedPath(String path) { + // 同时覆盖旧 MVC 的后缀匹配和分号路径参数,不能靠 .json 绕过来源检查。 + return path.matches("/(?:monitor/(?:job|jobLog)|druid)(?:[/.;].*)?"); + } +} diff --git a/ruoyi-admin/src/main/resources/application-hardening.yml b/ruoyi-admin/src/main/resources/application-hardening.yml new file mode 100644 index 0000000..c32d2ed --- /dev/null +++ b/ruoyi-admin/src/main/resources/application-hardening.yml @@ -0,0 +1,9 @@ +# 仅在同机 Nginx 部署时追加 hardening profile;原 prod/rental 等 profile 保留。 +# 所有公共 API 仍由 Nginx 转发,不再允许绕过代理直接访问 Java 端口。 +# 跨主机代理需将 address 改成实际私网地址,并由主机防火墙只放行代理来源。 +server: + address: 127.0.0.1 + +security: + management: + allowed-cidrs: ${SECURITY_MANAGEMENT_ALLOWED_CIDRS:127.0.0.1/32,::1/128} diff --git a/ruoyi-admin/src/test/java/com/ruoyi/web/core/filter/ExistingYamlCompatibilityTest.java b/ruoyi-admin/src/test/java/com/ruoyi/web/core/filter/ExistingYamlCompatibilityTest.java new file mode 100644 index 0000000..be29143 --- /dev/null +++ b/ruoyi-admin/src/test/java/com/ruoyi/web/core/filter/ExistingYamlCompatibilityTest.java @@ -0,0 +1,18 @@ +package com.ruoyi.web.core.filter; + +import com.ruoyi.system.security.SafeYamlPropertySourceLoader; +import org.junit.Test; +import org.springframework.core.io.ClassPathResource; +import static org.junit.Assert.*; + +/** 只解析当前项目配置,不启动应用、不连接数据库,且不打印配置中的秘密。 */ +public class ExistingYamlCompatibilityTest { + @Test + public void allShippedConfigurationFilesRemainReadable() throws Exception { + SafeYamlPropertySourceLoader loader = new SafeYamlPropertySourceLoader(); + for (String name : new String[] {"application.yml", "application-prod.yml", "application-local.yml", + "application-druid.yml", "application-rental.yml", "application-hardening.yml"}) { + assertFalse(name, loader.load(name, new ClassPathResource(name)).isEmpty()); + } + } +} diff --git a/ruoyi-admin/src/test/java/com/ruoyi/web/core/filter/ManagementSourceFilterTest.java b/ruoyi-admin/src/test/java/com/ruoyi/web/core/filter/ManagementSourceFilterTest.java new file mode 100644 index 0000000..b51398b --- /dev/null +++ b/ruoyi-admin/src/test/java/com/ruoyi/web/core/filter/ManagementSourceFilterTest.java @@ -0,0 +1,49 @@ +package com.ruoyi.web.core.filter; + +import java.util.concurrent.atomic.AtomicBoolean; +import org.junit.Test; +import org.springframework.mock.web.MockHttpServletRequest; +import org.springframework.mock.web.MockHttpServletResponse; +import static org.junit.Assert.*; + +public class ManagementSourceFilterTest { + private boolean invoke(String path, String remote, String forwarded, String cidrs) throws Exception { + MockHttpServletRequest request = new MockHttpServletRequest(); + request.setServletPath(path); + request.setRemoteAddr(remote); + request.addHeader("X-Forwarded-For", forwarded); + MockHttpServletResponse response = new MockHttpServletResponse(); + AtomicBoolean passed = new AtomicBoolean(); + new ManagementSourceFilter(cidrs).doFilter(request, response, + (req, res) -> passed.set(true)); + if (!passed.get()) assertEquals(403, response.getStatus()); + return passed.get(); + } + + @Test + public void directPublicClientCannotSpoofLoopback() throws Exception { + for (String path : new String[] {"/monitor/job", "/monitor/job/run", "/monitor/jobLog/list", + "/monitor/job.json", "/monitor/job;id=1", "/druid/"}) { + assertFalse(invoke(path, "203.0.113.10", "127.0.0.1", "127.0.0.1/32,::1/128")); + } + } + + @Test + public void trustedIpv4AndIpv6CanReachOriginalAuthenticationChain() throws Exception { + assertTrue(invoke("/monitor/job/list", "10.8.0.10", "203.0.113.10", "10.8.0.0/24")); + assertTrue(invoke("/monitor/job/list", "::1", "203.0.113.10", "::1/128")); + } + + @Test + public void paymentCallbackAndOtherBusinessRoutesRemainUnchanged() throws Exception { + for (String path : new String[] {"/api/v1/order/query", "/api/rental/payment/notify/1", + "/api/telegram/webhook", "/node/v1/socket", "/login", "/system/wallet/list"}) { + assertTrue(invoke(path, "203.0.113.10", "203.0.113.10", "127.0.0.1/32")); + } + } + + @Test(expected = IllegalArgumentException.class) + public void invalidHostnameFailsClosedWithoutDns() { + new ManagementSourceFilter("example.invalid"); + } +} diff --git a/ruoyi-system/src/main/java/com/ruoyi/system/security/SafeYamlPropertySourceLoader.java b/ruoyi-system/src/main/java/com/ruoyi/system/security/SafeYamlPropertySourceLoader.java new file mode 100644 index 0000000..f1b3ded --- /dev/null +++ b/ruoyi-system/src/main/java/com/ruoyi/system/security/SafeYamlPropertySourceLoader.java @@ -0,0 +1,109 @@ +package com.ruoyi.system.security; + +import java.io.IOException; +import java.io.Reader; +import java.util.ArrayList; +import java.util.LinkedHashMap; +import java.util.List; +import java.util.Map; +import java.util.Collection; +import java.util.IdentityHashMap; +import org.springframework.beans.factory.config.YamlProcessor; +import org.springframework.boot.env.PropertySourceLoader; +import org.springframework.core.Ordered; +import org.springframework.core.annotation.Order; +import org.springframework.core.env.MapPropertySource; +import org.springframework.core.env.PropertySource; +import org.springframework.core.io.Resource; +import org.yaml.snakeyaml.DumperOptions; +import org.yaml.snakeyaml.LoaderOptions; +import org.yaml.snakeyaml.Yaml; +import org.yaml.snakeyaml.constructor.SafeConstructor; +import org.yaml.snakeyaml.representer.Representer; +import org.yaml.snakeyaml.reader.UnicodeReader; +import org.yaml.snakeyaml.error.YAMLException; + +/** + * 为 Boot 2.2 适配 SnakeYAML 2.x,保留 Spring 的 Map/列表扁平化及多文档 profile 行为。 + * 仅接受 YAML 标准数据类型;拒绝任意 Java 类型,限制别名、深度及输入量。 + * 通过 spring.factories 在读取 application*.yml 之前注册,不能依赖普通 @Bean。 + */ +@Order(Ordered.HIGHEST_PRECEDENCE) +public final class SafeYamlPropertySourceLoader implements PropertySourceLoader { + @Override + public String[] getFileExtensions() { + return new String[] {"yml", "yaml"}; + } + + @Override + public List> load(String name, Resource resource) throws IOException { + return new Processor().load(name, resource); + } + + private static final class Processor extends YamlProcessor { + @Override + protected Yaml createYaml() { + LoaderOptions loader = new LoaderOptions(); + loader.setAllowDuplicateKeys(false); + loader.setMaxAliasesForCollections(50); + loader.setNestingDepthLimit(50); + loader.setCodePointLimit(3 * 1024 * 1024); + DumperOptions dumper = new DumperOptions(); + return new Yaml(new SafeConstructor(loader), new Representer(dumper), dumper, loader); + } + + private List> load(String name, Resource resource) throws IOException { + List> sources = new ArrayList<>(); + // 不调用旧版 YamlProcessor.process:其 DEBUG 日志会打印整个配置 Map。 + // 只复用无日志的标准扁平化算法,配置秘密不能进入诊断输出。 + try (Reader reader = new UnicodeReader(resource.getInputStream())) { + for (Object document : createYaml().loadAll(reader)) { + if (document != null) { + sources.add(new MapPropertySource(name + " (document #" + sources.size() + ")", + new LinkedHashMap<>(getFlattenedMap(asMap(document))))); + } + } + } + return sources; + } + + private Map asMap(Object value) { + Map result = new LinkedHashMap<>(); + Object normalized = convert(value, new IdentityHashMap<>(), 0, new int[1]); + if (!(normalized instanceof Map)) { + result.put("document", normalized); + return result; + } + ((Map) normalized).forEach((key, item) -> result.put((String) key, item)); + return result; + } + + private Object convert(Object value, IdentityHashMap visiting, + int depth, int[] visited) { + // 别名可构造循环或指数展开的图,解析器的语法深度限制不能单独防住扁平化阶段。 + if (++visited[0] > 100000 || depth > 50) { + throw new YAMLException("YAML 配置展开规模超过限制"); + } + if (!(value instanceof Map) && !(value instanceof Collection)) return value; + if (visiting.put(value, Boolean.TRUE) != null) { + throw new YAMLException("YAML 配置不允许循环别名"); + } + try { + if (value instanceof Map) { + Map result = new LinkedHashMap<>(); + ((Map) value).forEach((key, item) -> result.put( + key instanceof String ? (String) key : "[" + key + "]", + convert(item, visiting, depth + 1, visited))); + return result; + } + List result = new ArrayList<>(); + for (Object item : (Collection) value) { + result.add(convert(item, visiting, depth + 1, visited)); + } + return result; + } finally { + visiting.remove(value); + } + } + } +} diff --git a/ruoyi-system/src/main/resources/META-INF/spring.factories b/ruoyi-system/src/main/resources/META-INF/spring.factories new file mode 100644 index 0000000..3125c8f --- /dev/null +++ b/ruoyi-system/src/main/resources/META-INF/spring.factories @@ -0,0 +1,4 @@ +# Boot 2.2 的默认 YAML loader 依赖 SnakeYAML 1.x 已删除的无参构造器。 +# 工厂优先级确保配置加载时选择本安全适配器,不需要升级整套 Spring。 +org.springframework.boot.env.PropertySourceLoader=\ +com.ruoyi.system.security.SafeYamlPropertySourceLoader diff --git a/ruoyi-system/src/test/java/com/ruoyi/system/security/SafeYamlPropertySourceLoaderTest.java b/ruoyi-system/src/test/java/com/ruoyi/system/security/SafeYamlPropertySourceLoaderTest.java new file mode 100644 index 0000000..6441f8d --- /dev/null +++ b/ruoyi-system/src/test/java/com/ruoyi/system/security/SafeYamlPropertySourceLoaderTest.java @@ -0,0 +1,102 @@ +package com.ruoyi.system.security; + +import java.nio.charset.StandardCharsets; +import java.util.List; +import org.junit.Test; +import org.springframework.boot.env.PropertySourceLoader; +import org.springframework.boot.SpringApplication; +import org.springframework.boot.WebApplicationType; +import org.springframework.context.ConfigurableApplicationContext; +import org.springframework.context.annotation.Configuration; +import org.springframework.core.env.PropertySource; +import org.springframework.core.io.ByteArrayResource; +import org.springframework.core.io.support.SpringFactoriesLoader; +import org.yaml.snakeyaml.Yaml; +import org.yaml.snakeyaml.error.YAMLException; +import static org.junit.Assert.*; + +public class SafeYamlPropertySourceLoaderTest { + @Configuration + public static class IsolatedConfiguration { } + + @Test + public void actualBootStartupLoadsProfilesWithoutDatabaseOrSchedulers() { + SpringApplication app = new SpringApplication(IsolatedConfiguration.class); + app.setWebApplicationType(WebApplicationType.NONE); + app.setLogStartupInfo(false); + try (ConfigurableApplicationContext context = app.run( + "--spring.config.location=classpath:/security-bootstrap.yml", + "--spring.profiles.active=verified", "--spring.main.banner-mode=off")) { + assertEquals("profile-selected", context.getEnvironment().getProperty("security-test.value")); + assertEquals("MAINNET", context.getEnvironment().getProperty("security-test.labels[1]")); + assertEquals("fallback", context.getEnvironment().getProperty("security-test.placeholder")); + } + } + private List> load(String text) throws Exception { + return new SafeYamlPropertySourceLoader().load("test", + new ByteArrayResource(text.getBytes(StandardCharsets.UTF_8))); + } + + @Test + public void factoryIsSelectedBeforeLegacyBootLoader() { + List loaders = SpringFactoriesLoader.loadFactories( + PropertySourceLoader.class, getClass().getClassLoader()); + for (PropertySourceLoader loader : loaders) { + if (java.util.Arrays.asList(loader.getFileExtensions()).contains("yml")) { + assertEquals(SafeYamlPropertySourceLoader.class, loader.getClass()); + return; + } + } + fail("未注册 YAML loader"); + } + + @Test + public void preservesDocumentsListsPlaceholdersAndUnicode() throws Exception { + List> sources = load("spring:\n profiles: prod\npayment:\n name: 支付\n" + + " nodes: [NILE, MAINNET]\n enabled: true\n url: ${RPC_URL:https://example.invalid}\n" + + "---\nspring:\n profiles: local\npayment:\n enabled: false\n"); + assertEquals(2, sources.size()); + assertEquals("prod", sources.get(0).getProperty("spring.profiles")); + assertEquals("支付", sources.get(0).getProperty("payment.name")); + assertEquals("MAINNET", sources.get(0).getProperty("payment.nodes[1]")); + assertEquals(Boolean.TRUE, sources.get(0).getProperty("payment.enabled")); + assertEquals("${RPC_URL:https://example.invalid}", sources.get(0).getProperty("payment.url")); + assertEquals(Boolean.FALSE, sources.get(1).getProperty("payment.enabled")); + } + + @Test + public void rejectsJavaTagsWithoutConstructingObjects() throws Exception { + for (String input : new String[] {"!!javax.script.ScriptEngineManager []", + "value: !!java.net.URL ['https://example.invalid/not-requested']", + "key: first\nkey: second\n"}) { + try { load(input); fail("危险 YAML 未被拒绝"); } + catch (YAMLException expected) { /* 拒绝解析,无网络或脚本操作。 */ } + } + try { new Yaml().load("!!javax.script.ScriptEngineManager []"); fail(); } + catch (YAMLException expected) { /* 升级后的通用构造器也默认拒绝 Java 标签。 */ } + } + + @Test + public void rejectsExcessiveNesting() throws Exception { + StringBuilder text = new StringBuilder(); + for (int i = 0; i < 100; i++) text.append('['); + text.append('0'); + for (int i = 0; i < 100; i++) text.append(']'); + try { load(text.toString()); fail(); } + catch (YAMLException expected) { } + } + + @Test + public void rejectsAliasCyclesAndExponentialExpansionButPreservesSimpleAnchors() throws Exception { + assertEquals("value", load("base: &a {key: value}\ncopy: *a\n").get(0).getProperty("copy.key")); + try { load("cycle: &a [*a]\n"); fail(); } + catch (YAMLException expected) { } + StringBuilder bomb = new StringBuilder("a0: &a0 [value]\n"); + for (int i = 1; i <= 18; i++) { + bomb.append("a").append(i).append(": &a").append(i) + .append(" [*a").append(i - 1).append(", *a").append(i - 1).append("]\n"); + } + try { load(bomb.toString()); fail(); } + catch (YAMLException expected) { } + } +} diff --git a/ruoyi-system/src/test/resources/security-bootstrap.yml b/ruoyi-system/src/test/resources/security-bootstrap.yml new file mode 100644 index 0000000..365b4cb --- /dev/null +++ b/ruoyi-system/src/test/resources/security-bootstrap.yml @@ -0,0 +1,11 @@ +security-test: + value: base + labels: + - NILE + - MAINNET + placeholder: ${SECURITY_TEST_UNSET:fallback} +--- +spring: + profiles: verified +security-test: + value: profile-selected