查看原文
其他

每日开源 | 推荐一款java class文件安全加密工具,你也许用得到

康熙 终码一生 2022-09-22

点击“终码一生”,关注,置顶公众号

每日技术干货,第一时间送达!



1

简介


ClassFinal是一款java class文件安全加密工具,支持直接加密jar包或war包,无需修改任何项目代码,兼容spring-framework;可避免源码泄漏或字节码被反编译。


 

2

项目模块说明

 

  • classfinal-core: ClassFinal的核心模块,几乎所有加密的代码都在这里;

  • classfinal-fatjar: ClassFinal打包成独立运行的jar包;

  • classfinal-maven-plugin: ClassFinal加密的maven插件;

 

3

功能特性

 

  • 无需修改原项目代码,只要把编译好的jar/war包用本工具加密即可。

  • 运行加密项目时,无需求修改tomcat,spring等源代码。

  • 支持普通jar包、springboot jar包以及普通java web项目编译的war包。

  • 支持spring framework、swagger等需要在启动过程中扫描注解或生成字节码的框架。

  • 支持maven插件,添加插件后在打包过程中自动加密。

  • 支持加密WEB-INF/lib或BOOT-INF/lib下的依赖jar包。

  • 支持绑定机器,项目加密后只能在特定机器运行。

  • 支持加密springboot的配置文件。

 

4

环境依赖

 

JDK 1.8 +



5

使用说明


加密


执行以下命令


java -jar classfinal-fatjar.jar -file yourpaoject.jar -libjars a.jar,b.jar -packages com.yourpackage,com.yourpackage2 -exclude com.yourpackage.Main -pwd 123456 -Y


参数说明

-file        加密的jar/war完整路径
-packages    加密的包名(可为空,多个用","分割)
-libjars     jar/war包lib下要加密jar文件名(可为空,多个用","分割)
-cfgfiles    需要加密的配置文件,一般是classes目录下的yml或properties文件(可为空,多个用","分割)
-exclude     排除的类名(可为空,多个用","分割)
-classpath   外部依赖的jar目录,例如/tomcat/lib(可为空,多个用","分割)
-pwd         加密密码,如果是#号,则使用无密码模式加密
-code        机器码,在绑定的机器生成,加密后只可在此机器上运行
-Y           无需确认,不加此参数会提示确认以上信息


结果: 生成 yourpaoject-encrypted.jar,这个就是加密后的jar文件;加密后的文件不可直接执行,需要配置javaagent。


注: 以上示例是直接用参数执行,也可以直接执行 java -jar classfinal-fatjar.jar按照步骤提示输入信息完成加密。


maven插件方式


在要加密的项目pom.xml中加入以下插件配置,目前最新版本是:1.2.1。


<plugin>
    <!-- https://gitee.com/roseboy/classfinal -->
    <groupId>net.roseboy</groupId>
    <artifactId>classfinal-maven-plugin</artifactId>
    <version>${classfinal.version}</version>
    <configuration>
        <password>000000</password><!--加密打包之后pom.xml会被删除,不用担心在jar包里找到此密码-->
        <packages>com.yourpackage,com.yourpackage2</packages>
        <cfgfiles>application.yml</cfgfiles>
        <excludes>org.spring</excludes>
        <libjars>a.jar,b.jar</libjars>
    </configuration>
    <executions>
        <execution>
            <phase>package</phase>
            <goals>
                <goal>classFinal</goal>
            </goals>
        </execution>
    </executions>
</plugin>


运行mvn package时会在target下自动加密生成yourpaoject-encrypted.jar。


maven插件的参数名称与直接运行的参数相同,请参考上节的参数说明。另外,关注公号“终码一生”,回复关键词“资料”,获取视频教程和最新的面试资料!


无密码模式


加密时-pwd参数设为#,启动时可不用输入密码;如果是war包,启动时指定参数 -nopwd,跳过输密码过程。


机器绑定


机器绑定只允许加密的项目在特定的机器上运行;


在需要绑定的机器上执行以下命令,生成机器码


java -jar classfinal-fatjar.jar -C


加密时用-code指定机器码。机器绑定可同时支持机器码+密码的方式加密。


启动加密后的jar


加密后的项目需要设置javaagent来启动,项目在启动过程中解密class,完全内存解密,不留下任何解密后的文件。


解密功能已经自动加入到 yourpaoject-encrypted.jar中,所以启动时-javaagent与-jar相同,不需要额外的jar包。


启动jar项目执行以下命令:


java -javaagent:yourpaoject-encrypted.jar='-pwd 0000000' -jar yourpaoject-encrypted.jar

//参数说明
// -pwd 加密项目的密码
// -pwdname 环境变量中密码的名字


或者不加pwd参数直接启动,启动后在控制台里输入密码,推荐使用这种方式:


java -javaagent:yourpaoject-encrypted.jar -jar yourpaoject-encrypted.jar


使用nohup命令启动时,如果系统支持gui,会弹出输入密码的界面,如果是纯命令行下,不支持gui,则需要在同级目录下的classfinal.txt或yourpaoject-encrypted.classfinal.txt中写入密码,项目读取到密码后会清空此文件。


密码读取顺序已经改为:参数获取密码||环境变量获取密码||密码文件获取密码||控制台输入密码||GUI输入密码||退出


tomcat下运行加密后的war


将加密后的war放在tomcat/webapps下, tomcat/bin/catalina 增加以下配置:


//linux下 catalina.sh
CATALINA_OPTS="$CATALINA_OPTS -javaagent:classfinal-fatjar.jar='-pwd 0000000'";
export CATALINA_OPTS;

//win下catalina.bat
set JAVA_OPTS="-javaagent:classfinal-fatjar.jar='-pwd 000000'"

//参数说明
// -pwd 加密项目的密码
// -nopwd 无密码加密时启动加上此参数,跳过输密码过程
// -pwdname 环境变量中密码的名字


本工具使用AES算法加密class文件,密码是保证不被破解的关键,请保存好密码,请勿泄漏。


密码一旦忘记,项目不可启动且无法恢复,请牢记密码。


本工具加密后,原始的class文件并不会完全被加密,只是方法体被清空,保留方法参数、注解等信息,这是为了兼容spring,swagger等扫描注解的框架;方法体被清空后,反编译者只能看到方法名和注解,看不到方法的具体内容;当class被classloader加载时,真正的方法体会被解密注入。另外,关注公号“终码一生”,回复关键词“资料”,获取视频教程和最新的面试资料!


为了保证项目在运行时的安全,启动jvm时请加参数: -XX:+DisableAttachMechanism


该项目整体来说还是不错的,如果你在工作中有需要加密的代码,可以尝试通过该工具给自己的项目进行加密处理,下面给出项目地址。


开源地址:


Giteehttps://gitee.com/roseboy/classfinal
GitHubhttps://github.com/roseboy/classfinal


PS:防止找不到本篇文章,可以收藏点赞,方便翻阅查找哦。


往期推荐



SQL语句中 left join 后用 on 还是 where,区别大了!

桌面版 Linux 为什么干不过 Windows?Linus 现身说法..

面试官:toString()、String.valueOf、String 强转,有啥区别?

IntelliJ IDEA 2021.3 最终版正式发布,还是那么香!(末尾有惊喜)

每日开源 | 一款基于 SpringBoot+Vue 开发的分布式网盘系统

JetBrains:推出“新一代 IDE ”!VS Code 对手来了


您可能也对以下帖子感兴趣

文章有问题?点此查看未经处理的缓存