diff --git a/flowable-service/src/main/java/com/eip4/flowservice/api/ProcessModelController.java b/flowable-service/src/main/java/com/eip4/flowservice/api/ProcessModelController.java index d34ffd3..7a8a9b8 100644 --- a/flowable-service/src/main/java/com/eip4/flowservice/api/ProcessModelController.java +++ b/flowable-service/src/main/java/com/eip4/flowservice/api/ProcessModelController.java @@ -42,9 +42,11 @@ import io.swagger.v3.oas.annotations.tags.Tag; *

存量隔离:本控制器建的草稿一律 {@code setCategory("eip4")},{@link #list()} 只查该分类, * 库里 143 条老 shape act_re_model(旧 metaInfo + 可能悬空 editorSource)不进 Modeler 列表、避免打不开。

* - *

写入前 XML 一律过 {@link BpmnXMLConverter} 解析守卫(validateSchema=true + enableSafeBpmnXml=true, - * 后者关外部 DTD/实体解析,防 XXE/SSRF):坏 XML 返 422 且绝不落库;422 只回通用文案,原始解析原因仅进日志。 - * 守卫异常在本控制器就地 catch 转 422,不逸出到 {@code FlowExceptionHandler}(那里 FlowableException→400,语义不符)。 + *

写入前 XML 一律过解析守卫({@link #parseGuard}):①字节级拒 DOCTYPE(XXE 门);②{@link BpmnXMLConverter} + * 以 {@code validateSchema=false}(草稿是半成品,不做严格 XSD——bpmn-js 默认命名空间输出与严格 XSD 已知固有不兼容, + * 完整校验属部署门)+ {@code enableSafeBpmnXml=true}(加固解析器,双保险防外部实体)解析。坏 XML 返 422 且绝不落库; + * 422 只回通用文案,原始解析原因仅进日志。守卫异常就地 catch 转 422,不逸出到 {@code FlowExceptionHandler} + * (那里 FlowableException→400,语义不符)。 * {@code from-procdef} 复用「按 procDefId 读部署 BPMN」逻辑(本控制器自带 {@link #readProcessModel} 小方法, * 零改动 ProcessDiagramController)→ {@link BpmnIdSanitizer#sanitize} 净化中文 id → 建草稿, * 原→净化映射连同源 procDefId/原 key 写进 metaInfo,供发布逆向还原。

@@ -62,6 +64,9 @@ public class ProcessModelController { /** EIP4 草稿分类:建草稿时打此标,list() 只查此分类,隔离库里 143 条老 shape 存量 act_re_model。 */ static final String EIP4_CATEGORY = "eip4"; + /** DOCTYPE 门 prolog 扫描字节上限(BOM/XML 声明/注释/DOCTYPE 都在最前)。 */ + private static final int PROLOG_SCAN_BYTES = 8192; + private final RepositoryService repositoryService; private final ObjectMapper objectMapper = new ObjectMapper(); @@ -229,16 +234,27 @@ public class ProcessModelController { * BPMN 解析守卫:过则返回 {@code null}(放行),坏 XML 返回 422 ResponseEntity({status:1,msg})。 * 就地 catch 一切异常,不让引擎 XMLException/FlowableException 逸出到全局 advice(那里映射成 400,语义不符)。 * - *

{@code convertToBpmnModel(source, validateSchema, enableSafeBpmnXml)} 两布尔参: - * {@code validateSchema=true} 走 BPMN 2.0 XSD 校验(拒非法结构); - * {@code enableSafeBpmnXml=true} 启用 flowable 加固解析器(禁外部 DTD/参数实体/DOCTYPE), - * 关掉 XXE/SSRF 面——校验路径也走加固解析器,不给外部实体注入留口。

+ *

两道关:①解析前字节级 {@link #hasDoctypeInBytes} 拒 DOCTYPE 声明(XXE 兜底,不依赖 flowable + * 内部 {@code supportDTD=false} 实现);②{@code convertToBpmnModel(source, validateSchema, enableSafeBpmnXml)} + * 解析——{@code validateSchema=false}:草稿是可视化工具编辑的半成品,不做严格 BPMN 2.0 XSD 校验。 + * bpmn-js {@code saveXML} 用默认命名空间(无前缀 definitions/process)重序列化,Flowable 严格 Xerces XSD 校验 + * 会拒({@code cvc-complex-type.2.4.a})——这是 bpmn-js(面向 BPMN 模型,非字节级 XSD 合规)与严格 XSD 的 + * 已知固有不兼容;完整校验属部署门(T3.1 {@code ProcessValidator} 在解析后的模型上跑,非 XSD)。 + * {@code validateSchema=false} 仍解析(非良构 XML 抛→422);{@code enableSafeBpmnXml=true} 保加固解析器 + * (禁外部 DTD/参数实体/DOCTYPE),双保险关 XXE/SSRF。

* *

422 只回通用文案;原始解析原因(可能含内部路径/实体细节)仅进 {@code log.warn},不回显给调用方。

*/ private ResponseEntity> parseGuard(String xml) { + // ① XXE 兜底:解析前字节级拒 DOCTYPE。按 StringStreamSource 喂解析器的 UTF-8 字节视角扫描(含 BOM/UTF-16 + // 识别),消除「扫描端 vs 解析端编码错位」绕过。null XML 同走 422(与解析必抛等价)。 + if (xml == null || hasDoctypeInBytes(xml.getBytes(StandardCharsets.UTF_8))) { + log.warn("[流程草稿] BPMN 拒绝: {}", xml == null ? "空 XML" : "含 DOCTYPE 声明(XXE 防御)"); + return status(HttpStatus.UNPROCESSABLE_ENTITY, "BPMN 解析失败"); + } try { - new BpmnXMLConverter().convertToBpmnModel(new StringStreamSource(xml), true, true); + // ② validateSchema=false(不做严格 XSD)+ enableSafeBpmnXml=true(加固解析器);详见方法 javadoc。 + new BpmnXMLConverter().convertToBpmnModel(new StringStreamSource(xml), false, true); return null; } catch (Exception e) { log.warn("[流程草稿] BPMN 解析守卫拒绝: {}", e.toString()); @@ -246,6 +262,84 @@ public class ProcessModelController { } } + /** + * 字节级 DOCTYPE 检测(XXE 门):按 BOM / 无 BOM 的 UTF-16 空字节特征识别编码后解码 prolog,再走 + * {@link #hasDoctype}。消除「扫描端与解析端编码视角不一致」的绕过(UTF-8 BOM / UTF-16 会让纯字节扫描漏判 + * {@code 1 ? raw[1] & 0xFF : -1; + int u2 = raw.length > 2 ? raw[2] & 0xFF : -1; + if (u0 == 0xEF && u1 == 0xBB && u2 == 0xBF) { + cs = StandardCharsets.UTF_8; + off = 3; // UTF-8 BOM + } else if (u0 == 0xFF && u1 == 0xFE) { + cs = StandardCharsets.UTF_16LE; + off = 2; // UTF-16LE BOM + } else if (u0 == 0xFE && u1 == 0xFF) { + cs = StandardCharsets.UTF_16BE; + off = 2; // UTF-16BE BOM + } else if (u0 == '<' && u1 == 0x00) { + cs = StandardCharsets.UTF_16LE; // 无 BOM UTF-16LE(ASCII 起始字符夹空字节) + } else if (u0 == 0x00 && u1 == '<') { + cs = StandardCharsets.UTF_16BE; // 无 BOM UTF-16BE + } else { + cs = StandardCharsets.ISO_8859_1; // UTF-8 / Latin1:prolog 为 ASCII,字节级保真扫描 + } + int scanLen = Math.min(raw.length - off, PROLOG_SCAN_BYTES); + return hasDoctype(new String(raw, off, scanLen, cs)); + } + + /** + * 文档 prolog(根元素之前)是否含 DOCTYPE 声明(大小写不敏感)。正确跳过 XML 声明 {@code } 与注释 + * {@code },命中根元素起始标签即停(元素内容里的字面 {@code ", i + 4); + if (end < 0) { + return false; + } + i = end + 3; + continue; + } + if (xml.startsWith("", i + 2); + if (end < 0) { + return false; + } + i = end + 2; + continue; + } + return false; // 到达根元素起始标签,prolog 结束,无 DOCTYPE + } + return false; + } + /** 读流程定义部署 BPMN XML(getProcessModel 返回资源流)。读失败/为空返回 null(前端降级)。 */ private String readProcessModel(String procDefId) { try (InputStream is = repositoryService.getProcessModel(procDefId)) { diff --git a/flowable-service/src/test/java/com/eip4/flowservice/api/ProcessModelControllerTest.java b/flowable-service/src/test/java/com/eip4/flowservice/api/ProcessModelControllerTest.java index c64ea3d..e3c1c72 100644 --- a/flowable-service/src/test/java/com/eip4/flowservice/api/ProcessModelControllerTest.java +++ b/flowable-service/src/test/java/com/eip4/flowservice/api/ProcessModelControllerTest.java @@ -49,7 +49,7 @@ class ProcessModelControllerTest { MockMvc mvc; - // 最小 schema 合法 BPMN(default ns=BPMN20 MODEL),供 convertToBpmnModel(validateSchema=true) 过门。 + // 最小 schema 合法 BPMN(default ns=BPMN20 MODEL)。 private static final String VALID_BPMN = "" + "" + "" @@ -58,6 +58,31 @@ class ProcessModelControllerTest { + "" + ""; + // bpmn-js saveXML 风格:默认命名空间(无前缀 definitions/process)+ 带前缀 BPMNDI 布局段。 + // 此处 BPMNDiagram 排在 process 之前(触发严格 XSD 的 cvc-complex-type.2.4.a 序列违例——definitions 内容 + // 模型要求 rootElement* 在 BPMNDiagram* 之前)——模拟 bpmn-js 输出被严格 XSD 拒的真实故障族。 + // 草稿保存关 validateSchema 后应良构解析通过 → 200。 + private static final String BPMN_JS_STYLE = "" + + "" + + "" + + "" + + "" + + "" + + "" + + "" + + "" + + ""; + + // 含 DOCTYPE 声明(XXE 面):正文良构、关严格 XSD 后本可解析,但字节级 DOCTYPE 守卫必须拒。 + private static final String DOCTYPE_XML = "" + + "]>" + + "" + + ""; + @BeforeEach void setUp() { ProcessModelController controller = new ProcessModelController(repositoryService); @@ -178,6 +203,47 @@ class ProcessModelControllerTest { verify(repositoryService, never()).addModelEditorSource(anyString(), any()); } + @Test + void 建草稿_bpmnJs默认命名空间输出_关严格XSD后200落库() throws Exception { + // 回归锚点:bpmn-js saveXML 默认命名空间输出被严格 XSD 拒(改前必红=422)。草稿保存不该做完整 XSD 校验 + // (完整校验属部署时 ProcessValidator,非 XSD)→ 关 validateSchema 后良构解析通过 → 200 建草稿成功。 + Model m = Mockito.mock(Model.class); + when(m.getId()).thenReturn("draft-js"); + when(repositoryService.newModel()).thenReturn(m); + + String body = "{\"name\":\"新流程\",\"key\":\"newproc\",\"bpmnXml\":" + jsonString(BPMN_JS_STYLE) + "}"; + mvc.perform(post("/api/flow/models").contentType(MediaType.APPLICATION_JSON).content(body)) + .andExpect(status().isOk()) + .andExpect(jsonPath("$.modelId").value("draft-js")); + + verify(repositoryService).saveModel(m); + verify(repositoryService).addModelEditorSource(eq("draft-js"), any()); + } + + @Test + void 建草稿_含DOCTYPE声明_字节级XXE守卫返422不落库() throws Exception { + // 正文良构(关 XSD 后本可解析),但 DOCTYPE 声明是 XXE 面 → 解析前字节级守卫拒,不依赖 flowable 内部实现。 + String body = "{\"name\":\"x\",\"key\":\"k\",\"bpmnXml\":" + jsonString(DOCTYPE_XML) + "}"; + mvc.perform(post("/api/flow/models").contentType(MediaType.APPLICATION_JSON).content(body)) + .andExpect(status().isUnprocessableEntity()) + .andExpect(jsonPath("$.status").value(1)); + + verify(repositoryService, never()).saveModel(any()); + verify(repositoryService, never()).addModelEditorSource(anyString(), any()); + } + + @Test + void 建草稿_非良构XML_关严格XSD后仍返422不落库() throws Exception { + // 关 validateSchema=false 仅关严格 XSD,仍解析:标签不匹配是非良构 XML,解析必抛 → 422。 + String body = "{\"name\":\"x\",\"key\":\"k\",\"bpmnXml\":" + + jsonString("") + "}"; + mvc.perform(post("/api/flow/models").contentType(MediaType.APPLICATION_JSON).content(body)) + .andExpect(status().isUnprocessableEntity()) + .andExpect(jsonPath("$.status").value(1)); + + verify(repositoryService, never()).saveModel(any()); + } + @Test void 更新_草稿不存在返404() throws Exception { when(repositoryService.getModel("nope")).thenReturn(null);