feat(gateway): Modeler source 转发+超管门(中文 procDefId 编码硬验收)

阶段1 T1.6 代码部分:流程 Modeler 存量源 XML 经网关超管门载入。

- FlowableClient.procDefSource(procDefId):转发 GET /api/flow/process-definitions/{id}/source,
  procDefId 作为 uri 变量由 RestClient 严格编码(中文 percent、冒号→%3A),绝不字符串拼 URL(M-2)。
  走既有 execute() 重试/降级封装(连接级重试→503,4xx/5xx 透传)。
- ProcessModelerController GET /api/workflow/process-definitions/{procDefId}/source:
  超管门(EngineContextBinder.isSystemAdmin,非超管 403 {status:1,msg:"仅系统管理员可用"}),
  过门后透传下游返回体。flowable-service 裸 8089 无安全栈,超管门唯一落点在网关。
- EngineContextBinder.isSystemAdmin 由 private 提升为 public static + null 安全,供网关复用;
  判定口径不变(ADMIN 大小写不敏感去补白 / account 大小写敏感=admin / 含 admin 字样不误判)。

测试(mvn -pl platform-flow-gateway,platform-auth -am test 全绿,既有测试零修改):
- FlowableClientTest +2:中文 procDefId「总包合同交底:3:abc123」uri 变量严格编码(断言 %3A 且无裸中文)
  / 下游 4xx 透传 FlowRemoteException 不重试。共 11。
- ProcessModelerControllerTest 4:超管 200 透传 / 非超管 403 不触发下游 / 无身份 403 / 引擎不可达上抛。
- EngineContextBinderAdminTest 8:ADMIN 大小写·补白 / account=admin / Admin 变体不提权 / 含 admin 普通用户 / null。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
2026-07-02 10:47:00 +08:00
parent 14a825d0a0
commit 6d16206a08
6 changed files with 290 additions and 1 deletions

View File

@@ -64,8 +64,14 @@ public final class EngineContextBinder {
* DB 校验 {@code TRIM(account)='admin'}(精确小写)。不放宽成大小写不敏感,避免因 {@code SYS_USER.ACCOUNT}
* 无唯一约束、建号去重又区分大小写而把 {@code 'Admin'} 这类变体账号静默提权(安全评审 M-1)。</li>
* </ul>
*
* <p>公开为 {@code public static} 供网关层复用(流程 Modeler 超管门,flowable-service 裸 8089
* 无安全栈 → 超管门唯一落点在网关,T1.6)。{@code null} 主体安全返回 {@code false}(未认证即非超管)。
*/
private static boolean isSystemAdmin(AuthPrincipal principal) {
public static boolean isSystemAdmin(AuthPrincipal principal) {
if (principal == null) {
return false;
}
String adminId = LoggedInUser.ADMIN.trim(); // "ADMIN"
String userId = principal.userId();
if (userId != null && adminId.equalsIgnoreCase(userId.trim())) {

View File

@@ -0,0 +1,67 @@
package com.eip4.platform.auth.security;
import static org.assertj.core.api.Assertions.assertThat;
import java.util.List;
import org.junit.jupiter.api.Test;
import com.dsasp.server.common.user.service.LoggedInUser;
/**
* {@link EngineContextBinder#isSystemAdmin} 判定单测:与全站 {@code requireAdmin} 逐口径对齐。
*
* <p>本方法在 T1.6 由 {@code private} 提升为 {@code public static},供 platform-flow-gateway 的
* 流程 Modeler 超管门复用(网关层唯一保护点)。这里锁定其行为契约,防提升可见性后被随意放宽:
* ADMIN 大小写不敏感 + 去补白、account 大小写敏感等于 admin、含 "admin" 字样的普通用户不误判、null 安全。
*/
class EngineContextBinderAdminTest {
private static AuthPrincipal user(String userId, String account) {
return new AuthPrincipal(userId, account, "n", null, null, List.of());
}
@Test
void userId为ADMIN_判超管() {
assertThat(EngineContextBinder.isSystemAdmin(user("ADMIN", "someacct"))).isTrue();
}
@Test
void userId小写admin_大小写不敏感判超管() {
assertThat(EngineContextBinder.isSystemAdmin(user("admin", "someacct"))).isTrue();
}
@Test
void userId带补白_去补白后判超管() {
// 引擎 CURRENTUSER 是 CHAR(36) 补白常量("ADMIN" + 31 空格),trim 后判真
assertThat(EngineContextBinder.isSystemAdmin(user(LoggedInUser.ADMIN, "someacct"))).isTrue();
assertThat(EngineContextBinder.isSystemAdmin(user(" ADMIN ", "someacct"))).isTrue();
}
@Test
void account为admin_userId非admin_判超管() {
assertThat(EngineContextBinder.isSystemAdmin(user("U1", "admin"))).isTrue();
assertThat(EngineContextBinder.isSystemAdmin(user("U1", " admin "))).isTrue();
}
@Test
void account大小写敏感_Admin变体不判超管() {
// SYS_USER.ACCOUNT 无唯一约束,'Admin' 这类变体账号不得静默提权(安全评审 M-1)
assertThat(EngineContextBinder.isSystemAdmin(user("U1", "Admin"))).isFalse();
}
@Test
void 含admin字样的普通用户_不误判() {
assertThat(EngineContextBinder.isSystemAdmin(user("USER_ADMINISTRATOR", "user_admin"))).isFalse();
}
@Test
void 普通用户_非超管() {
assertThat(EngineContextBinder.isSystemAdmin(user("U1", "zhangsan"))).isFalse();
}
@Test
void null主体_null安全返回false() {
assertThat(EngineContextBinder.isSystemAdmin(null)).isFalse();
}
}