0 从零开始的Java RASP实现(一)
本科毕设做过Python的RASP之后,对这项技术很有兴趣,当时OpenRASP开始出现,并且Java的实现非常接近真正的运行时防御的概念。一直没有时间和足够的动力学习Java,最近一口气学了不少Java相关的东西,准备从反序列化和RASP两个方向继续深入学一下Java。这边笔记主要也是记录整个学习过程,目标是仿照OpenRASP的java实现,完成一个Java的RASP。
1 javaagent
1.1 Main方法启动前
概念介绍:
javaagent是java命令提供的一个参数,这个参数可以指定一个jar包,在真正的程序没有运行之前先运行指定的jar包。并且对jar包有两个要求:
- jar包的MANIFEST.MF文件必须指定Premain-Class
- Premain-Class指定的类必须实现premain()方法。
这个premain方法会在java命令行指定的main函数之前运行。
在java命令参数种,还可以看到其它参数,例如
-agentlib:<libname>[=<选项>]
加载本机代理库 <libname>, 例如 -agentlib:hprof
另请参阅 -agentlib:jdwp=help 和 -agentlib:hprof=help
-agentpath:<pathname>[=<选项>]
按完整路径名加载本机代理库
-javaagent:<jarpath>[=<选项>]
加载 Java 编程语言代理, 请参阅 java.lang.instrument
javaagent可以指定很多个,jvm会依次执行不同的jar。前面提到的premain方法有两种定义方式
public static void premain(String agentArgs, Instrumentation inst)
public static void premain(String agentArgs)
根据sun.instrument.InstrumentationImpl 的源代码,可以知道,会优先调用第一种写法。这种方法可以在JDK1.5及之后的版本使用
如何使用
使用javaagent需要几个步骤:
- 定义一个MANIFEST.MF文件,必须包含Premain-Class选项,也需要加入Can-Redefine-Classes和Can-Retransform-Classes选项,后面两个选项看名字就知道意思
- 创建Premain-Class指定的类,类中包含premain方法,该方法可以进一步加载RASP实现原理
- 将MANIFEST.MF和写好的各种类打包成jar
- 启动java时,添加-javaagent:xx.jar,即可让java先自动执行写好的premain方法
在premain方法执行时,获取的Instrumentation对象还会加载大部分类,包括后面main方法执行时需要加载的各种类,但是抓不到系统类。也就是说,在这个位置在main方法执行前,就可以拦截或者重写类,结合ASM、javassist、cglib方式就可以实现对类的改写或者插桩。
创建agent
现在来实现一下,目录结构如下
-java-agent
----src
----|----main
----|----------java
----|--------------com
----|-------------------bitterz
----|----------------------PreMain
----|pom.xml
pom.xml使用idea创建maven项目自带的pom.xml即可,然后加入如下配置
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-jar-plugin</artifactId>
<configuration>
<archive>
<manifestEntries>
<Premain-Class>com.bitterz.PreMain</Premain-Class>
<Can-Redefine-Classes>true</Can-Redefine-Classes>
<Can-Retransform-Classes>true</Can-Retransform-Classes>
</manifestEntries>
</archive>
</configuration>
</plugin>
</plugins>
</build>
修改里面的premain即可,这样配置之后,直接使用idea的maven->package就可以打包成一个可以使用的agent.jar。
com.bitterz.PreMain如下:
package com.bitterz;
import java.lang.instrument.ClassFileTransformer;
import java.lang.instrument.IllegalClassFormatException;
import java.lang.instrument.Instrumentation;
import java.security.ProtectionDomain;
public class PreMain {
public static void premain(String agentArgs, Instrumentation inst){
System.out.println("agentArgs:" + agentArgs);
inst.addTransformer(new DefineTransformer(), true);
}
static class DefineTransformer implements ClassFileTransformer{
@Override
public byte[] transform(ClassLoader loader, String className, Class<?> classBeingRedefined, ProtectionDomain protectionDomain, byte[] classfileBuffer) throws IllegalClassFormatException {
System.out.println("premain load Class: " + className); // 注意这里的输出
return classfileBuffer;
}
}
}
创建main
然后再创建一个要执行的main
package com.bitterz;
public class Main {
public static void main(String[] args) {
System.out.println("Main.main() in test project");
}
}
同样修改pom.xml配置,只需要再<manifestEntries>
标签下添加一个<Main-Class>
即可用idea的maven打包成一个jar,并且指定了main类。
两个项目用maven打包后,在命令行执行一下
可以看到premain先输出了加载的各种类,包括com.bitterz.Main,然后才是真正的main执行,最后结束时,premain还加载了一些结束时需要的类。到此,在启动main方法前,实现对后续类的加载或进一步修改操作,已经有了雏形
1.2 JVM启动后
前面的方法需要在main函数启动前,执行agent,但有些时候,jvm已经启动了,而且服务不能轻易暂停,但这个时候还是想对jvm中的类做一些修改应该怎么办呢?
attach机制
这就要引入attch机制了,jdk1.6之后在Instrumentation中添加了一种agentmain的代理方法,可以在main函数执行之后再运行。和premain函数一样,开发者可以编写一个包含agentmain函数的Java类,它也有两种写法:
public static void agentmain (String agentArgs, Instrumentation inst)
public static void agentmain (String agentArgs)
同样的,带有Instrumentation的方法会被优先调用,开发者必须再MANIFEST.MF文件中设置Agent-Class
来指定包含agentmain函数的类。
这种attach机制的具体实现在com.sun.tools.attach
中,有如下两个类:
-
VirtualMachine
字面意义表示一个Java 虚拟机,也就是程序需要监控的目标虚拟机,提供了获取系统信息(比如获取内存dump、线程dump,类信息统计(比如已加载的类以及实例个数等), loadAgent,Attach 和 Detach (Attach 动作的相反行为,从 JVM 上面解除一个代理)等方法,可以实现的功能可以说非常之强大 。该类允许我们通过给attach方法传入一个jvm的pid(进程id),远程连接到jvm上代理类注入操作只是它众多功能中的一个,通过
loadAgent
方法向jvm注册一个代理程序agent,在该agent的代理程序中会得到一个Instrumentation实例,该实例可以 在class加载前改变class的字节码,也可以在class加载后重新加载。在调用Instrumentation实例的方法时,这些方法会使用ClassFileTransformer接口中提供的方法进行处理。 -
VirtualMachineDescriptor
则是一个描述虚拟机的容器类,配合 VirtualMachine 类完成各种功能
具体实现过程:通过VirtualMachine类的attach(pid)
方法,便可以attach到一个运行中的java进程上,之后便可以通过loadAgent(agentJarPath)
来将agent的jar包注入到对应的进程,然后对应的进程会调用agentmain方法。
从jdk根目录的lib/tools.jar源码一路追踪了一下VirtualMachine.attach方法,发现传入一个pid之后,在Windows下会通过WindowsVirtualMachine
这个类的构造函数,调用native方法,实现对jvm进程的attach
启动一个长时间运行的jvm
底层方法还得靠c/c++来实现(滑稽),了解这个机制之后,回到前面的agentmain的实现流程。首先启动一个一直运行的jvm
package com.bitterz;
public class Main {
public static void main(String[] args) throws InterruptedException {
System.out.println("Main.main() in test project start!!");
Thread.sleep(300000000);
System.out.println("Main.main() in test project end!!");
}
}
打包一个agentmain代理jar
启动之后,把再写一个agentmain,并且还要写好MANIFEST.MF文件配置,代码和pom.xml如下:
package com.bitterz;
import java.lang.instrument.Instrumentation;
public class AgentMain {
public static void agentmain(String agentArgs, Instrumentation instrumentation) {
System.out.println("agentmain start!");
System.out.println(instrumentation.toString());
}
}
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-jar-plugin</artifactId>
<configuration>
<archive>
<manifestEntries>
<Agent-Class>com.bitterz.AgentMain</Agent-Class>
<Can-Redefine-Classes>true</Can-Redefine-Classes>
<Can-Retransform-Classes>true</Can-Retransform-Classes>
</manifestEntries>
</archive>
</configuration>
</plugin>
</plugins>
</build>
使用maven package打包成一个jar文件即可
运用attach
再开启动另一个java程序,使用进程号attach到前面一直运行的jvm,并使用loadAgent给这个jvm添加代理jar:
package com.bitterz.attach;
import com.sun.tools.attach.AgentInitializationException;
import com.sun.tools.attach.AgentLoadException;
import com.sun.tools.attach.AttachNotSupportedException;
import com.sun.tools.attach.VirtualMachine;
import java.io.IOException;
public class AttachTest {
public static void main(String[] args) throws IOException, AttachNotSupportedException, AgentLoadException, AgentInitializationException {
VirtualMachine attach = VirtualMachine.attach("12244"); // 命令行找到这个jvm的进程号
attach.loadAgent("C:\Users\helloworld\Desktop\java learn\java-attach\target\java-attach-1.0-SNAPSHOT.jar");
attach.detach();
}
}
运行这个java文件,会看到前面一直sleep运行的jvm会输出agentmain里面给定的输出!
这里也就说明,通过attach机制,我们可以对指定运行中的jvm添加agent,而在premain方法中获取到Instrumentation对象,通过对Instrumentation对象添加transformer类,可以实现类转换(Class Transform),也就是在transform函数中结合修改字节码的方法(ASM、Javassist、cglib等)可以进一步实现RASP!
后续的文章将会写一写如何实现这些对指定类方法的Hook,以及如何运行时对底层函数的参数进行过滤。
参考
https://www.cnblogs.com/rickiyang/p/11368932.html
https://www.cnblogs.com/kendoziyu/p/maven-auto-build-javaagent-jar.html