feat(P0②): 引擎ALTER安全通道 + AI安全门enforced

- AlterTableSqlGuard(legacy-core,纯静态白名单):只允许 加列/同族扩长/改可空,
  拒 DROP COLUMN/RENAME/SET NOT NULL/多语句/跨族/小写绕过;放legacy-core避免反向依赖
- DataDicService.executeAlterSql 受控通道(过Guard再execute,defense-in-depth)
- MetaController POST /api/meta/entity/{table}/attributes 加列端点
  (saveAttr元数据+alterAddColumnDdl镜像appendColumnDdl类型映射+evictByTable+补索引,恒可空)
- AiAgentService.applyLocalRelease 织入 AiToolRegistry.check:安全门 advisory→enforced
  (local.apply工具身份,非本机/越权写路径403)
- 单测 Guard15/alter2/gate22(112基线无回归);scripts/p0-alter-acceptance.sh 真库验收

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-06-21 13:56:14 +08:00
parent 624ffe8a15
commit 8b28595f9e
9 changed files with 530 additions and 0 deletions

View File

@@ -101,6 +101,13 @@ public interface DataDicService {
* @return
*/
public String executeCreateSql(String sql);
/**
* 受控变更实体表结构(只允许 加列 / 同族扩长 / 改可空,经 AlterTableSqlGuard 白名单校验)。
* @param sql ALTER 语句
* @return null=成功;非空=失败原因
*/
public String executeAlterSql(String sql);
/**
* get entity by table name

View File

@@ -0,0 +1,106 @@
package com.dsasp.server.dataDic.service;
import java.util.Locale;
import java.util.regex.Pattern;
/**
* P0② 引擎 ALTER 安全通道守卫(纯静态 / 无 Spring 依赖,便于单测)。
*
* <p>保真层(com.dsasp.*)的 DDL 此前只接受 CREATE({@code DataDicServiceImpl.executeCreateSql}),
* 完全不支持 ALTER。本守卫把 ALTER 从「完全不可达」收窄为「只允许 加列 / 同族扩长 / 改可空」
* 的最小安全集,显式拒绝一切破坏性 / 不可逆 DDL。
*
* <p>放在 legacy-core(而非 platform-metadata)以避免 legacy-core→metadata 的反向(循环)依赖:
* 引擎层 {@code executeAlterSql} 与控制层 {@code MetaController} 都引用本类,形成 defense-in-depth
* 双层校验。
*
* <p>受控形态(标识符大小写敏感,必须大写,匹配引擎建表正则;类型 token 小写,匹配
* {@code MetaController.appendColumnDdl} 的输出):
* <ul>
* <li>{@code ALTER TABLE <T> ADD COLUMN <C> <type>} — 加列(可带 REFERENCES 引用)</li>
* <li>{@code ALTER TABLE <T> ALTER COLUMN <C> TYPE <varchar(n)|numeric(p,s)>} — 同族扩长</li>
* <li>{@code ALTER TABLE <T> ALTER COLUMN <C> DROP NOT NULL} — 改可空</li>
* </ul>
* 其余(DROP COLUMN / RENAME / SET NOT NULL / 跨族类型转换 / 多语句 / 子查询 / 注释 / 小写绕过)
* 一律抛 {@link IllegalArgumentException}。
*/
public final class AlterTableSqlGuard {
private AlterTableSqlGuard() {
}
/** 表名/列名规则与 MetaController 建表白名单一致(大写起头,大写数字下划线)。 */
private static final String TABLE = "[A-Z][A-Z0-9_]{2,40}";
private static final String COLUMN = "[A-Z][A-Z0-9_]{1,60}";
/** 加列允许的引擎类型(对齐 appendColumnDdl:字符串/数值/整型/时间戳/定长/引用列)。 */
private static final String ADD_TYPE =
"(?:character varying\\(\\d{1,4}\\)"
+ "|numeric\\(\\d{1,2},\\d{1,2}\\)"
+ "|integer"
+ "|bigint"
+ "|character\\(36\\)(?: REFERENCES " + TABLE + ")?)";
/** 扩长只允许同族(varchar 改宽 / numeric 改精度),不允许跨族(varchar→int 会丢数据)。 */
private static final String WIDEN_TYPE =
"(?:character varying\\(\\d{1,4}\\)|numeric\\(\\d{1,2},\\d{1,2}\\))";
private static final Pattern ADD_COLUMN = Pattern.compile(
"ALTER TABLE (" + TABLE + ") ADD COLUMN (" + COLUMN + ") " + ADD_TYPE);
private static final Pattern ALTER_TYPE = Pattern.compile(
"ALTER TABLE (" + TABLE + ") ALTER COLUMN (" + COLUMN + ") TYPE " + WIDEN_TYPE);
private static final Pattern DROP_NOT_NULL = Pattern.compile(
"ALTER TABLE (" + TABLE + ") ALTER COLUMN (" + COLUMN + ") DROP NOT NULL");
/**
* 注意:不含 " NOT NULL"(会误伤合法的 "DROP NOT NULL");ADD COLUMN ... NOT NULL 由
* 「不匹配任何受控形态」自然拒绝。"SET NOT NULL" 明确列出(不会误伤 DROP NOT NULL)。
*/
private static final String[] DENY_TOKENS = {
"--", "/*", "*/", " USING ", "(SELECT", " SELECT ",
" DROP COLUMN", " RENAME ", " SET NOT NULL", " SET DEFAULT",
" DROP TABLE", " DROP CONSTRAINT", " ADD CONSTRAINT",
};
/**
* 校验并归一化一条 ALTER 语句。
*
* @param sql 原始 SQL
* @return 归一后的安全 SQL(折叠空白、去尾分号),可直接交给 jdbcTemplate.execute
* @throws IllegalArgumentException 非白名单 / 危险 / 非受控形态
*/
public static String guard(String sql) {
if (sql == null) {
throw new IllegalArgumentException("ALTER 脚本为空");
}
String s = sql.strip();
if (s.endsWith(";")) {
s = s.substring(0, s.length() - 1).strip();
}
s = s.replaceAll("\\s+", " ");
if (s.isEmpty()) {
throw new IllegalArgumentException("ALTER 脚本为空");
}
// 单语句:折叠后不得再含分号(分号注入第二句)
if (s.indexOf(';') >= 0) {
throw new IllegalArgumentException("只允许单条 ALTER 语句: " + sql);
}
String upper = s.toUpperCase(Locale.ROOT);
if (!upper.startsWith("ALTER TABLE ")) {
throw new IllegalArgumentException("只允许 ALTER TABLE 语句: " + sql);
}
for (String bad : DENY_TOKENS) {
if (upper.contains(bad)) {
throw new IllegalArgumentException("ALTER 含禁止操作 [" + bad.trim() + "]: " + sql);
}
}
// 必须精确匹配三种受控形态之一(整串 matches,标识符大小写敏感)
if (ADD_COLUMN.matcher(s).matches()
|| ALTER_TYPE.matcher(s).matches()
|| DROP_NOT_NULL.matcher(s).matches()) {
return s;
}
throw new IllegalArgumentException(
"非受控的 ALTER 形态(只允许 加列 / 同族扩长 / 改可空): " + sql);
}
}

View File

@@ -204,6 +204,18 @@ public class DataDicServiceImpl implements DataDicService {
return "非合法的创建表脚本";
}
@Override
public String executeAlterSql(String sql) {
String safe;
try {
safe = AlterTableSqlGuard.guard(sql);
} catch (IllegalArgumentException e) {
return e.getMessage();
}
jdbcTemplate.execute(safe);
return null;
}
@OriginServiceMethod(name="新增实体的默认属性", type = "dataDic" , description = "新增实体,默认产生createby,updatby,createtime,updatetime,version,isactive,orgid,departid")
@Override
public GeneralPOJO getTableDefaultAttribute() {