限 时 特 惠: 本站每日持续稳定更新内部创业教程,一年会员只需98元,全站资源免费下载 点击查看详情
站 长 微 信: muyang-0410

前言

相信很多人都“免费激活”过 IDEA吧,在IDEA 的配置里,加行配置就行:

-javaagent_javaagent配置_javaagent参数

或者是这样“拖到IDEA窗口中”的形式:

javaagent配置_-javaagent_javaagent参数

再或者用过一些APM工具,在JVM启动脚本上增加了-:/path/to/apm-agent.jar,就可以自动进行追踪。再或者用过之类的JVM诊断工具,这些工具都是通过Java Agent的技术去实现的。**

比如上面说的“免费激活”,其实就是在运行时期修改了验证的相关代码。JAVA 李 Agent 这么强大的功能,你难道不打算自己亲自写一个试试吗?

基础知识

Java Agent 算是JVM的一个插件,以一个Jar包的形式存在。可以做到在运行时期,修改你的字节码文件,从而达到增强、修改等效果,通过 JVM 提供的 API来实现。

第一个 Java Agent

一个Java Agent,由以下几个组件构成:

javaagent参数_javaagent配置_-javaagent

废话不多说,下面正式开始编写这个Agent

1. 创建Agent Class

首先要创建一个Agent Class,这个Class作为我们Agent插件的入口类。配置好-后,JVM在启动时会执行我们Agent Class的方法

import java.lang.instrument.Instrumentation;
public class Agent {
  public static void premain(String args, Instrumentation instrumentation){
    ClassLoggerTransformer transformer = new ClassLoggerTransformer();
    instrumentation.addTransformer(transformer);
  }
}
复制代码

在方法中,除了args参数,还有一个对象。这个是Java Agent的核心对象,通过该对象可以注册。

** **就是负责字节码转换的核心接口了,已注册的可以拦截JVM中所有类的加载,并且可以获取到已加载类的字节码,来看一下这个接口的源码:

public interface ClassFileTransformer {
    byte[]
    transform(  ClassLoader         loader,
                String              className,//className,全类名(包括路径,"/"分割)
                Class            classBeingRedefined,//类定义转换时的Class对象,初始加载时为空
                ProtectionDomain    protectionDomain,//protection...
                byte[]              classfileBuffer)//加载的Class字节码数据
        throws IllegalClassFormatException;
}
复制代码

2. 定义一个

了解了接口之后,现在来写一个er实现类。为了简单,这个实现类只有一个功能:将已加载的字节码转储到文件中


public class ClassLoggerTransformer implements ClassFileTransformer {
    
    //返回值是替换的字节码数据
  @Override
  public byte[] transform(ClassLoader loader,
                          String className,
                          Class classBeingRedefined,
                          ProtectionDomain protectionDomain,
                          byte[] classfileBuffer) throws IllegalClassFormatException {
    try {
      Path path = Paths.get("classes/" + className + ".class");
      //将字节码数据classfileBuffer,存储到classes目录下,以.class文件作为后缀
      Files.write(path, classfileBuffer); 
    } catch (Throwable ignored) { // ignored, don’t do this at home kids
    } finally { return classfileBuffer; }
  }
}
复制代码

好了,第一个Agent 的功能代码部分已经完成了,下面需要 Agent 解决入口的配置

3. 构建 agent.jar

现在我们需要将代码构建成一个Jar,并且Jar内的.MF文件中,需要包含Agent Class的配置,最终我们的.MF文件应该是这样:

Manifest-Version: 1.0
Premain-Class: com.github.kongwu.agentsamples.firstagent.Agent//Agent Class的全类名
Can-Redefine-Classes: true //允许重新定义
Can-Retransform-Classes: true //允许运行时转换
复制代码

通过Maven的构建插件,很容易完成.MF文件的配置:


  org.apache.maven.plugins
  maven-jar-plugin
  ...
  
    
      src/main/resources/META-INF/MANIFEST.MF
    
  
  ...

复制代码

只需要在项目的src/main//META-INF/路径下-javaagent,增加一个.MF的模板,模板文件里按照上面介绍的定义即可,最后mvn clean 就可以构建出我们的agent jar了(默认目录在${}//),这个jar包内会包含我们上面的.MF模板文件

好了,大功告成,我们第一款Agent已经开发完了,下面来测试一下:

## 随便找个项目,或者可执行的jar包
## 默认的启动方式,直接java -jar
java -jar first-app.jar
## 启动时添加我们刚才构建的first-agent.jar
java -javaagent:/path/to/first-agent.jar -jar first-app.jar
复制代码

增加agent运行后,所有运行时期加载的Class的字节码,就会转储到我们的目录下了

如果你是在 IDEA 中运行,也可以在Run/Debug 面板中,add vm

-javaagent_javaagent参数_javaagent配置

上面这个例子好像有点过于简单,只是“拦截”了字节码数据进行了转储,并没有进行字节码的修改。其实.的返回值,就是我们要替换的数据;只需要在方法中返回新的字节码数据,就可以做到增强/替换类了(不过这个增强/替换是有一些限制的,比如不能修改方法签名之类的,本文不做过多介绍)

介绍完了基本的Agent实现,下面来学习一个Agent的实际例子:通过Agent来“免费激活”

通过Agent 实现“免费激活”

前言中提到的,IDEA“免费激活”的工具也是通过Agent实现的,其实基本原理很简单,就是写一个Agent,动态修改验证的那些代码而已。

比如我们使用一款需要授权许可证的Java 软件,其内部验证许可证的代码是下面这段(伪代码)

public boolean verifyLicense(String encryptedLicense){
	//请求服务器验证许可……
    boolean passed = licenseServer.verifyLicense(encryptedLicense);
    if(!passed){
    	//do sth
    }
    return passed;
}
复制代码

那么我们只需要通过Agent,动态的来修改这个方法,将验证结果修改为直接通过,就可以绕过这个许可验证机制了,还不用修改原始Jar包

public boolean verifyLicense(String encryptedLicense){
    //修改后,直接返回true
	return true;
}
复制代码

那么怎么修改这个类方法呢?

有两种方式:

提前解压jar包,反编译那个Class文件,得到Java文件后修改方法后重新编译在实现中,通过传入的该类字节码数据,使用一些字节码操作工具进行修改

本文例子为了简单,使用第一种方式,提前反编译、修改,再保存重新编译的Class文件到Agent 项目里:

只需要创建一个,进行这个验证许可证Class的替换:


import java.io.IOException;
import java.io.InputStream;
import java.lang.instrument.ClassFileTransformer;
import java.lang.instrument.IllegalClassFormatException;
import java.security.ProtectionDomain;
public class HackVerifierClassFileTransformer implements ClassFileTransformer {
    @Override
    public byte[] transform(ClassLoader loader, String className, Class classBeingRedefined, ProtectionDomain protectionDomain, byte[] classfileBuffer) throws IllegalClassFormatException {
        //只替换这个验证的类 - LicenseVerifier
        if(className.equals("com/github/kongwu/agentsamples/firstagent/verifierapp/LicenseVerifier")){
            return loadHackClassBuffer(loader);
        }
        return null;
    }
    private byte[] loadHackClassBuffer(ClassLoader loader) {
        //反编译 -> 修改 -> 重新编译的LicenseVerifier.class 文件,换个后缀防止被JVM自动加载
        try (InputStream input = loader.getResourceAsStream("LicenseVerifier.classdata")){
            int n;
            ByteArrayOutputStream outputBuffer = new ByteArrayOutputStream();
            byte[] buffer = new byte[4096];//4k
            //-1 : end of file
            while (-1 != (n = input.read(buffer))) {
                outputBuffer.write(buffer,0,n);
            }
            return outputBuffer.toByteArray();
        }catch (IOException e){
            System.err.println("load the hackfile failed!");
            return null;
        }
    }
}
复制代码

然后在Agent Class中,注册这个

import java.lang.instrument.Instrumentation;
public class Agent {
  public static void premain(String args, Instrumentation instrumentation){
    HackVerifierClassFileTransformer transformer = new HackVerifierClassFileTransformer();
    instrumentation.addTransformer(transformer);
  }
}
复制代码

最后只需要像上面那样,配置下.MF的生成,然后构建Agent Jar包,就完成了我们这个“免费激活”的Agent 插件

以后运行该 Java 软件时,只需要增加-:/path/to/hack-agent.jar,就实现了“免费激活”

## 默认的启动方式,直接java -jar
java -jar verifier-app.jar
## 启动时添加我们刚才构建的agent.jar
java -javaagent:/path/to/hack-agent.jar -jar verifier-app.jar
复制代码

文中例子完整的代码在.com/-/age…-javaagent,有需要的同学可以自行下载

常用的字节码操作类库

以上的几个字节码操作类库,最推荐的是,使用方式上最简单

总结

本文介绍的这个“免费激活”的方式,仅用于学习交流,不要用于一些非法的场景,做一个遵纪守法的好公民,不然会被请去喝茶就不太好了……

原文链接:

限 时 特 惠: 本站每日持续稳定更新内部创业教程,一年会员只需98元,全站资源免费下载 点击查看详情
站 长 微 信: muyang-0410