Fastjson 不能升级时的三层加固:关 JDK 远程 Codebase 与 trustSerialData、关 autoType 并开 SafeMode、必须用 @type 时改走 addAccept 白名单
defense/hardening · verified
一句话结论
Fastjson 反序列化链的落点几乎都要经过 JNDI 的远程加载或反序列化,所以在"不能升级 fastjson/JDK"的场景下,加固要按三层同时做:第一层在 JVM 启动参数上关掉 com.sun.jndi.ldap.object.trustURLCodebase、com.sun.jndi.rmi.object.trustURLCodebase 与 com.sun.jndi.ldap.object.trustSerialData,把远程 Codebase 与 LDAP 反序列化两条通路掐死;第二层用 ParserConfig.getGlobalInstance().setAutoTypeSupport(false)(高版本另有 SafeMode)让 @type 直接失效;第三层只对确有 @type 需求的业务,改走 addAccept(...) 包/类白名单或 -Dfastjson.parser.autoTypeAccept=... 启动参数,把可实例化的类收敛到一个极小集合。三层缺一层都还剩利用面——尤其"只加白名单不关 autoType、或只在代码里 setProperty"这类半吊子加固。
原理
- 为什么第一层是 JNDI:
JdbcRowSetImpl(dataSourceName+autoCommit)、各类第三方JndiConverter/JndiObjectFactory/JndiDataSourceFactory的终点都是InitialContext.lookup。lookup 之后能做什么,取决于 JDK 允不允许①远程 Codebase 加载类、②对 LDAP 返回的序列化数据做反序列化。把这两件事关掉,即便@type通关,也拿不到代码执行。 - JDK 版本差异:8u191 起默认禁用 LDAP/RMI 远程 Codebase(
trustURLCodebase默认 false),但"本地工厂 + 本地 gadget"(BeanFactory、c3p0、H2 INIT 等)仍可用,所以仍要显式设置;com.sun.jndi.ldap.object.trustSerialData默认允许,用于关闭 LDAP 侧序列化数据的反序列化,这是"远程 Codebase 已禁用后"的主要残余面。 - 为什么必须用启动参数而非代码:
System.setProperty只有在相关 JNDI 代码执行前生效才有意义。应用中若存在"类加载前就发生 lookup"(静态初始化、容器启动期装配)或攻击者能影响类加载顺序,代码方式会被绕过;启动参数在 JVM 启动即生效,且不受业务代码部署形态影响。 - 第二层的作用面:
setAutoTypeSupport(false)让checkAutoType对未登记的@type直接抛异常,@type指定类不再被实例化,setter 不会被调用,链断在第一步。高版本的 SafeMode 语义更强(完全禁止 autoType 与部分反序列化特性),但会让依赖@type的业务直接失败,这是它的代价。 - 第三层的必要性:若业务确实用
@type,白名单是唯一可行的收敛方式。addAccept("com.example.model.")是前缀匹配(末尾点表示整包),addAccept("com.example.another.SpecificClass")才是单类;-Dfastjson.parser.autoTypeAccept=<包前缀或类名,逗号分隔>与之等价但走启动参数,能避免"代码没执行到"的问题。 - 半吊子加固为什么等于没加固:只
setAutoTypeSupport(true)+addAccept而不关 JNDI → 白名单外的类仍可能通过java.lang.Class缓存/描述符绕过(1.2.25–1.2.47 的L...;、[、java.lang.Class三套手法);只在代码里设trustURLCodebase而不设启动参数 → 时序上可能晚于首次 lookup;把 JVM 参数写进application.yml的spring.application.jvm.args→ JVM 启动时还没读到这份配置,参数不会生效,必须走JAVA_OPTS/容器启动命令/setenv.sh之类真正的启动入口。 - 为什么这三层是互补而非重复:①断掉"加载什么"(JNDI 远程能力)、②断掉"能不能指定类"(autoType)、③断掉"能指定哪些类"(白名单)。任意一层单独存在都能被针对:只有①时本地工厂链仍可用;只有②时管理员手工开 autoType 就复原;只有③时白名单前缀写宽(如
com.、java.)等于裸奔。
触发条件
- 目标使用 Fastjson(1.2.x 全系,或 fastjson2 的兼容模式),且存在把用户输入交给
JSON.parse/parseObject的入口。 - 业务因兼容性无法升级 fastjson 到已默认关闭 autoType 的安全版本、无法升级 JDK 到 8u191+(或虽升级但仍有本地 gadget 风险)。
- 具备修改 JVM 启动参数与发布流程的权限(否则第一层、第三层的启动参数无从落地)。
- 存在需要保留
@type的合法业务(否则直接第二层即可,不需要白名单)。
利用步骤
- 盘点入口:找出所有把外部输入交给
JSON.parse/parseObject/parseArray的位置,确认是否显式传了目标类型(传了具体类时@type影响力较小,传Object/Map/JSONObject时风险最高)。 - 第一层(启动参数):在真实启动入口(
JAVA_OPTS、DockerfileENTRYPOINT、Tomcatsetenv.sh、systemdEnvironment=)追加:-Dcom.sun.jndi.ldap.object.trustURLCodebase=false -Dcom.sun.jndi.rmi.object.trustURLCodebase=false -Dcom.sun.jndi.ldap.object.trustSerialData=false。 - 第二层(关 autoType):在应用初始化最早处(如
@PostConstruct、ServletContextListener、main第一行)执行ParserConfig.getGlobalInstance().setAutoTypeSupport(false);高版本同时开启 SafeMode(ParserConfig.getGlobalInstance().setSafeMode(true))。 - 第三层(白名单):确需
@type的业务,改为setAutoTypeSupport(true)后addAccept("<精确包前缀>.", ...)与addAccept("<精确类全名>")组合;或改用-Dfastjson.parser.autoTypeAccept=<包前缀,类名>,避免代码路径未执行。 - 验证不得回退:构造
{"@type":"com.sun.rowset.JdbcRowSetImpl","dataSourceName":"ldap://127.0.0.1:1389/x","autoCommit":true}与{"@type":"Lcom.sun.rowset.JdbcRowSetImpl;",...},确认均抛异常且无外连;再用业务真实报文确认白名单内类仍正常反序列化。 - 复核配置来源:确认没有另一处代码/配置文件把
setAutoTypeSupport(true)或宽前缀白名单加回来(含第三方 starter、低代码平台、@type相关的兼容开关)。
PoC
# 第一层:真实启动入口追加(示例为容器/JVM 参数)
JAVA_OPTS="-Dcom.sun.jndi.ldap.object.trustURLCodebase=false \
-Dcom.sun.jndi.rmi.object.trustURLCodebase=false \
-Dcom.sun.jndi.ldap.object.trustSerialData=false"
// 第二层:全局关 autoType(越早越好);高版本再开 SafeMode
@Configuration
public class FastjsonSecurityConfig {
@PostConstruct
public void init() {
ParserConfig.getGlobalInstance().setAutoTypeSupport(false);
// 高版本:ParserConfig.getGlobalInstance().setSafeMode(true);
}
}
// 第三层:确需 @type 时的最小白名单(前缀 + 单类)
@Configuration
public class FastjsonWhitelistConfig {
@PostConstruct
public void init() {
ParserConfig.getGlobalInstance().setAutoTypeSupport(true);
ParserConfig.getGlobalInstance().addAccept("com.example.model."); // 整包
ParserConfig.getGlobalInstance().addAccept("com.example.dto.OrderView"); // 单类
}
}
# 第三层替代写法(启动参数,避免代码未执行)
-Dfastjson.parser.autoTypeAccept=com.example.model.,com.example.dto.OrderView
# 加固后的回归判据
{"@type":"com.sun.rowset.JdbcRowSetImpl","dataSourceName":"ldap://127.0.0.1:1389/x","autoCommit":true}
-> 应抛 autoType is not support / 未在白名单,且 LDAP 服务无连接
{"@type":"Lcom.sun.rowset.JdbcRowSetImpl;","dataSourceName":"..."}
-> 同上(描述符绕过也应被拒)
白名单内类 -> 正常反序列化(业务不回归)
变体与关联
- 关联:[[web-java-deser-fastjson-thirdparty-jndi-factory-blacklist-gap]](给出"黑名单覆盖不到的第三方 JNDI 工厂"这一攻击面,本卡是对应的收敛方案)、[[web-java-deser-fastjson-autotype-descriptor-bypass-evolution]](
L...;/[描述符绕过,说明为何白名单必须是精确前缀)、[[web-java-deser-fastjson-1247-class-cache-bypass]](java.lang.Class缓存绕过,说明"只关 autoType 不关 JNDI 不够")、[[web-java-deserialization-jndi-low-version-rmi-ldap-remote-codebase]](trustURLCodebase的版本分界与远程 Codebase 利用)、[[defense-hardening-java-rasp-sink-hookpoints-limits]](运行期 hook 兜底与其绕过面,可与本卡的配置层叠加)。 - 变体:Spring Boot 可在启动类里用
SpringApplicationBuilder.properties()或System.setProperty于main最前置;fastjson2 有独立的JSONFactory/JSONReader.Feature与 autoType 过滤接口(ObjectReaderProvider.addAutoTypeFilter),思路相同但 API 不同;网关/WAF 侧可再加"JSON 体含@type即拦截"的规则作为补丁(会误伤合法用法,只做兜底)。 - 边界:白名单只覆盖类名,若白名单内的类本身带危险 setter(如可控
URL/DataSource属性)仍可能被二次利用;trustSerialData=false只作用于 LDAP 侧,RMI 侧另有com.sun.jndi.rmi.object.trustURLCodebase;若容器/JDK 版本过低根本不支持某些系统属性,需实测确认生效。
检测与防御
- 检测:启动参数中缺失上述三个
-D项;代码里出现setAutoTypeSupport(true);白名单前缀过宽(com.、org.、java.);运行期出现@type指向com.sun.rowset、org.apache.xbean、com.mchange、org.apache.shiro.jndi等敏感类的请求;JVM 出现向非常规 LDAP/RMI 端口的出连。 - 防御:优先升级 fastjson 到默认关闭 autoType 的版本与 JDK 8u191+;无法升级时按本卡三层同时落地并由发布流程强制校验启动参数;把白名单纳入代码评审(禁止前缀放宽);对
JSON.parse入口统一封装,强制传具体目标类型;上线前用标准 PoC 做回归,确保加固未被回退。