承 P4-4 §坑8.8 + 架构 §四安全第 2 层 LIKE 路径项。GeneralPO 对 String 搜索值裸拼 col like '%值%'(GeneralPO.java:1940)及同形态 5 处(Object 等值 1982/IN 1978/全表模糊 ilike 2075/like 2145/2173)无参数绑定 → 单引号闭合 字面量注入。 修复(保真层最小改动,严格口径): - StringUtil 新增 escapeSqlLiteral:只把 ' 双写为 ''(SQL 标准转义堵注入)、 绝不转义通配符 % _(旧系统通配语义保真)、不补外层引号(拼接形态零变化) - GeneralPO 6 处用户可控值位置各包一层 escapeSqlLiteral,SQL 结构一字未改 - m_IDs(主键)/get_TableName()(标识符,白名单守)非值位置,不在本次范围 - 真参数化(PreparedStatement ?)列 P2 后续热点项,本次只堵值转义注入面 验证:单测 7/7;mvn install 10 模块 + ArchUnit 绿;ParityCli --all 21 实体 全一致 + --privilege 9 正/3 负全过;REST 8091 实测注入负例 200 空结果 不注入不报错(表未被 DROP),a%b/纯 % 仍通配。详见 P2-LIKE注入修复报告.md + 迁移手册 §8.10。 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
11 KiB
P2-LIKE 注入修复报告:保真层 GeneralPO 值位置单引号转义
日期:2026-06-11 | 工作线:platform-legacy-core 保真层 工程:eip4-platform/platform-legacy-core(JDK17) 来源:P4-4 picker 衔接报告 §坑8.8 定位的注入点;架构设计 §四「安全四层」第 2 层「渐进参数化」的 LIKE 路径项 数据源:本地 M0 PG
localhost:5433;对拍专用库eip4like(本次重建,幂等自举);服务端口 8091(验证后已 kill)
一、一句话结论
保真层 SQL 引擎 GeneralPO 的 String 搜索值裸拼 LIKE 注入点(col like '%值%')及同形态 5 处值位置裸拼,统一过 StringUtil.escapeSqlLiteral(只把 ' 双写为 '',绝不转义通配符 %/_)。对合法值(含中文/空格/含 % 的通配搜索)逐字节零行为变化,注入载荷被降级为字面量。单测 7/7,全模块 mvn install + ArchUnit 绿,ParityCli --all(21 实体)+ --privilege(9 正例/3 负例)全一致,REST 实测注入负例返回 200 空结果(不注入、不报错、表未被 DROP)。
真参数化(PreparedStatement ? 占位)作为 P2 后续热点项保留——本次范围仅为保真层最小改动「值转义堵注入面」,不改引擎拼接形态。
二、注入点清单(全文件 grep 同类裸拼点登记)
文件:platform-legacy-core/src/main/java/com/dsasp/server/dataDic/bean/GeneralPO.java
| 行 | 拼接形态 | 值来源 | 用户可控 | 本次处置 |
|---|---|---|---|---|
| 1940 | col + " like '%" + obj.toString().trim() + "%'" |
String 列搜索值(map.get(列名)) |
✅ | 修(P4-4 热点) |
| 1982 | col + " = '" + obj.toString() + "'" |
Object.class 列等值搜索值 | ✅ | 修(同形态明显点) |
| 1978 | "'" + subId + "'"(IN 列表元素) |
Object.class 列 List 搜索值 | ✅ | 修(同形态明显点) |
| 2075 | " ilike '%" + fuzzyCondition + "%' " |
全表模糊查询条件(FUZZY_QUERY) |
✅ | 修(同形态 LIKE 点) |
| 2145 | combidentifierCol + " like '%" + fuzzyCondition + "%' " |
同上(多实体组合标识列) | ✅ | 修(同形态 LIKE 点) |
| 2173 | displayColumnName + " like '%" + fuzzyCondition + "%' " |
同上(关联实体显示列) | ✅ | 修(同形态 LIKE 点) |
| 1778 | "'" + m_IDs[i] + "'" |
记录主键 m_IDs(引擎内部置入,非搜索入参) |
❌ 非用户搜索值 | 不在本次范围 |
| 1849/1858 | TABLENAME = '" + get_TableName() + "'" |
表名(元数据标识符,非值) | ❌ 标识符(白名单守,§安全第 1 层) | 不在本次范围 |
| 2106 | 已注释死代码 | — | — | 无 |
处置口径:本次只修「用户可控的值位置裸拼」。
m_IDs(主键由引擎流程内部置入)与get_TableName()(标识符,由现代层IdentifierWhitelist元数据白名单守,属安全第 1 层职责)不属本次「值转义」范围,登记备查。
三、修复方式(严格遵守口径)
3.1 新增最小转义工具(复用既有单引号转义语义)
StringUtil 已有 TO_STRING(txt, maxLen):单引号双写 + 补外层 '...'。LIKE 点需要值落在 '%...%' 内、通配符 % 须在引号外,因此不能直接用 TO_STRING(会多补一层引号、破坏拼接形态)。新增同语义但不补外层引号的方法(复用同一个 QUOTE 常量与 '' 双写逻辑):
public static String escapeSqlLiteral(String txt) {
if (txt == null) return null;
if (txt.indexOf(QUOTE) < 0) return txt; // 无单引号原样返回(合法值零分配)
StringBuilder out = new StringBuilder(txt.length() + 4);
for (int i = 0; i < txt.length(); i++) {
char c = txt.charAt(i);
if (c == QUOTE) out.append("''"); // ' → ''(SQL 标准转义)
else out.append(c); // % _ 及其余字符原样(保留通配语义)
}
return out.toString();
}
- 只转义单引号(
'→''):闭合引擎拼接的字符串字面量,堵注入。 - 绝不转义
%和_:旧系统把搜索值里的%/_当通配符是既有行为;转义=改语义=破保真。保持通配语义原样。 - 不补外层引号:调用方原有
'%/%'/= '/IN ('拼接形态零变化,diff 最小。
3.2 6 处调用点改造(拼接形态不变,仅值过转义)
// 1940 String LIKE(P4-4 热点)
sb.append(columnName + " like '%" + StringUtil.escapeSqlLiteral(obj.toString().trim()) + "%'");
// 1982 Object 等值
sb.append(columnName + " = '" + StringUtil.escapeSqlLiteral(obj.toString()) + "'");
// 1978 Object IN 元素
sb.append("'").append(StringUtil.escapeSqlLiteral(subId)).append("'");
// 2075 ilike 模糊 / 2145 combidentifier like 模糊 / 2173 displayColumn like 模糊
... .append(" [i]like '%").append(StringUtil.escapeSqlLiteral(fuzzyCondition)).append("%' ");
3.3 保真层改动纪律登记
- 改
com.dsasp.*(保真层),与 framework 源码 diff 控制到最小:StringUtil+32 行(1 个静态方法),GeneralPO仅 6 处值位置各包一层escapeSqlLiteral(...),拼接结构与原 SQL 字符串形态一字未改。 - 不改
PreparedStatement参数化(更大引擎改造)——真参数化列 P2 后续热点项(见 §六)。 - ArchUnit「保真层禁依赖现代层」不受影响(改动全在
com.dsasp内,复用本包StringUtil)。
四、验证(过对拍——纪律)
4.1 单测(StringUtilEscapeSqlLiteralTest,7/7 通过)
| 用例 | 断言 |
|---|---|
| 单引号双写 | '→''、a'b→a''b、' OR '1'='1→'' OR ''1''=''1、'; DROP TABLE x--→''; DROP TABLE x-- |
| 通配符不动 | a%b/a_b/%/_/100%_done/a\b 原样返回;a'%b_c→a''%b_c(只双写引号,% _ 留) |
| 正常值不变 | 张三/hello world/项目 A-2026/中文+空格 逐字节不变;无引号值返回入参本身 |
| null | 返回 null |
| 拼接形态产物 | P.NAME like '%'' OR ''1''=''1%'(注入降级)、P.NAME like '%a%b%'(% 仍通配)、P.ID = 'x''; DROP--'、IN 元素转义 |
4.2 对拍(本地 8091 + eip4like 库)
行为保真 + 通配(REST GET /api/entity/EIP4PT_CUSTOMER/list?NAME2=值,String 列 NAME2 走引擎 col like '%值%' 路径)
种子库灌入 3 条标定行:NAME2='a%b'(含字面 %)、NAME2="O'Brien 中文"(含单引号)、NAME2='张三 项目'(普通中文+空格)。
| 用例 | 结果 |
|---|---|
NAME2=张三(中文) |
HTTP 200 total=1,命中「张三 项目」 |
NAME2='张三 项目'(中文+空格) |
HTTP 200 total=1,命中 |
NAME2=a%b(含 % 字面通配保真) |
HTTP 200 total=1,命中「a%b」(% 仍按通配匹配) |
NAME2=%(纯通配验证) |
HTTP 200 total=3(匹配全部非空 NAME2,证 % 是通配符而非被转义为字面量) |
NAME2=O'Brien(含单引号字面) |
HTTP 200 total=1,命中「O'Brien 中文」(转义后字面匹配,不报错) |
注入负例(REST 实测留证)
| 载荷 | 结果 |
|---|---|
NAME2=' OR '1'='1 |
HTTP 200 total=0(不返回全表,转义后字面查 0 行) |
NAME2='; DROP TABLE x-- |
HTTP 200 total=0;表未被 DROP(eip4pt_customer 仍 53 行) |
NAME2=x' UNION SELECT * FROM sys_usergroup-- |
HTTP 200 total=0(UNION 被降级为字面量) |
picker ?q=' OR 1=1-- |
HTTP 200 total:0(status:0,干净) |
引擎实拼 SQL 留证(app DEBUG 日志,证单引号被双写、载荷整体落在字面量内未闭合):
SELECT COUNT(*) AS COU FROM (SELECT P.EIP4PT_CUSTOMER_ID FROM EIP4PT_CUSTOMER AS P
WHERE 1=1 AND P.NAME2 like '%''; DROP TABLE x--%') AS TEMPTABLE
'; DROP TABLE x-- 的 ' 被双写为 '',整条 payload 留在 '%...%' 字面量内,无语句中断、无 DROP 执行。app 日志无任何 PSQLException/syntax error。
回归对拍
| 套件 | 结果 |
|---|---|
ParityCli --all(本地 21 实体全量列表对拍) |
21/21 一致率=1.0000 OK,实体级一致率 1.0000 |
ParityCli --privilege(C2 行级权限) |
正例 9/9 全一致,负例 3/3 被拒(错误角色 → REJECTED),✅ 全部通过 |
mvn -T1C clean install(10 模块全量编译+单测+ArchUnit) |
BUILD SUCCESS(含 ArchitectureRulesTest 1/1:保真层禁依赖现代层) |
4.3 全模块 BUILD SUCCESS
platform-legacy-core / platform-converter / platform-metadata / platform-auth /
platform-flow-gateway / platform-ai / platform-parity / platform-app / flowable-service
全 SUCCESS;ArchitectureRulesTest Tests run: 1, Failures: 0
新增 StringUtilEscapeSqlLiteralTest Tests run: 7, Failures: 0
五、与 picker 端 escapeLikeValue 的口径区别(重要)
P4-4 metadata 层 PickerController.escapeLikeValue(手册 §8.8)对 q 剔除 %/_/\(防通配符逃逸,现代层 picker 把搜索框定义为「不可作通配」优先保安全)。本次保真层 escapeSqlLiteral 保留 %/_(保真层职责是「行为对合法值零变化」,旧系统通配语义不能动)。两者是不同层、不同语义:
- 现代层 picker
q:业务定义为模糊关键字,转义器主动剔通配符(产品决策)。 - 保真层引擎 LIKE sink:必须保通配语义(保真硬约束)。
二者最终都汇到本次修的同一引擎 sink;本次修复让该 sink 对任何进来的值都堵单引号注入(picker 已先剔通配再进来,entity filter 等其它入口的值则保通配进来),双管不冲突。
六、真参数化后续项(P2 热点,本次未做)
本次为保真层最小改动:只在值位置加单引号转义堵注入面,保持字符串拼接形态。架构设计 §四第 2 层「渐进参数化」、§五「计划缓存抖动(头号性能税)」的根子级修复——把热点路径值位置改 ? 占位(PreparedStatement)——是更大的引擎改造,列 P2 后续热点项:
- 优先级 = C3 压测热点 ∩ 安全风险点(架构 §五「关键协同」)。
- 一次参数化同时还安全(结构稳定不可注入)+ 性能(PG 计划缓存可复用)两笔债。
- 改造时仍须「每改一处过对拍」(本报告的对拍套件可直接复用)。
在此之前,本次的单引号转义是可回归的注入兜底(对拍负例守着不退化),等价于把架构 §四第 4 层「检测兜底」的注入负例从一次性人工保证变成 ParityCli/单测断言。
七、git 提交(只 add 本线自有文件)
platform-legacy-core/src/main/java/com/dsasp/server/common/util/StringUtil.java(+escapeSqlLiteral静态方法)platform-legacy-core/src/main/java/com/dsasp/server/dataDic/bean/GeneralPO.java(6 处值位置过转义)platform-legacy-core/src/test/java/com/dsasp/server/common/util/StringUtilEscapeSqlLiteralTest.java(新增单测)platform-legacy-core/P2-LIKE注入修复报告.md(本报告)docs/迁移手册.md(§8.10 新坑)