|
|
@@ -45,14 +45,15 @@
|
|
|
- #### <font face="幼圆" ><font face="幼圆" color = "#86CA5E">**方式一**</font>:通过maven插件自动加密</font>
|
|
|
```xml
|
|
|
<!--
|
|
|
- class-winter插件
|
|
|
+ class-winter插件``
|
|
|
注:自Maven3.0.3起, 绑定到同一phase的Maven插件将按照pom.xml中声明的顺序执行
|
|
|
注:此插件最好放置在同一phase的最后执行。
|
|
|
+ 注:此插件不具备打包功能,需要在此插件前有打包插件进行项目打包,否则加密不会生效。
|
|
|
-->
|
|
|
<plugin>
|
|
|
<groupId>com.idea-aedi</groupId>
|
|
|
<artifactId>class-winter-maven-plugin</artifactId>
|
|
|
- <version>2.8.5</version>
|
|
|
+ <version>2.8.6</version>
|
|
|
<!-- 相关配置 -->
|
|
|
<configuration>
|
|
|
<!-- <finalName></finalName>-->
|
|
|
@@ -83,15 +84,15 @@
|
|
|
```
|
|
|
注:不必担心信息泄漏问题,使用此方式生成混淆的jar包时,会擦除pom.xml中关于class-winter-plugin的信息。
|
|
|
|
|
|
-- #### <font face="幼圆" ><font face="幼圆" color = "#86CA5E">**方式二**</font>:通过 [**class-winter-core.jar**](https://gitee.com/JustryDeng/class-winter/raw/master/class-winter-core/src/test/resources/class-winter-core-2.8.5.jar) 主动加密</font>
|
|
|
+- #### <font face="幼圆" ><font face="幼圆" color = "#86CA5E">**方式二**</font>:通过 [**class-winter-core.jar**](https://gitee.com/JustryDeng/class-winter/raw/master/class-winter-core/src/test/resources/class-winter-core-2.8.6.jar) 主动加密</font>
|
|
|
|
|
|
```bash
|
|
|
- java -jar class-winter-core-2.8.5.jar originJarOrWar=${要加密的项目.jar或.war包} includePrefix=${加密范围} [k3=v3 k4=v4 ...]
|
|
|
+ java -jar class-winter-core-2.8.6.jar originJarOrWar=${要加密的项目.jar或.war包} includePrefix=${加密范围} [k3=v3 k4=v4 ...]
|
|
|
# 对于复杂的参数值,可以使用引号引起来
|
|
|
# linux
|
|
|
- java -jar class-winter-core-2.8.5.jar k1='v1' k2='v2'
|
|
|
+ java -jar class-winter-core-2.8.6.jar k1='v1' k2='v2'
|
|
|
# windows
|
|
|
- java -jar class-winter-core-2.8.5.jar k1="v1" k2="v2"
|
|
|
+ java -jar class-winter-core-2.8.6.jar k1="v1" k2="v2"
|
|
|
```
|
|
|
|
|
|
## <font face="幼圆" color = "#3399EA" >加密参数</font>
|
|
|
@@ -120,12 +121,15 @@
|
|
|
<tr align="center">
|
|
|
<td>includePrefix</td>
|
|
|
<td>是</td>
|
|
|
- <td>通过前缀匹配的形式定位要加密的class
|
|
|
+ <td>通过前缀匹配的形式定位要加密的class,支持正则匹配
|
|
|
<br/>
|
|
|
注:多个通过逗号分割。</td>
|
|
|
<td>includePrefix=com
|
|
|
<br/>
|
|
|
-includePrefix=com,org</td>
|
|
|
+includePrefix=com,org
|
|
|
+ <br/>
|
|
|
+includePrefix=com.*.dao,org
|
|
|
+</td>
|
|
|
</tr>
|
|
|
<tr align="center">
|
|
|
<td>cca(依托于includePrefix)</td>
|
|
|
@@ -145,39 +149,48 @@ includePrefix=com,org</td>
|
|
|
<td>作为includePrefix的附加设置,设置是否清空字段上的注解(写法同url后面设置参数)</td>
|
|
|
<td>includePrefix=com?cca=true&cma=true&cfa=true</td>
|
|
|
</tr>
|
|
|
+<tr align="center">
|
|
|
+ <td>caPrefix(依托于cca、cma、cfa开关)</td>
|
|
|
+ <td>否</td>
|
|
|
+ <td>作为includePrefix的附加设置,依托与cca、cma、cfa开关,清空类、方法、字段上的指定注解(写法同url后面设置参数)
|
|
|
+ <br/>
|
|
|
+注:多个通过|分割,注解请写完全路径例如:com.xx.anno.MyAnnotation
|
|
|
+ </td>
|
|
|
+ <td>includePrefix=com?cca=true&cma=true&cfa=true&caPrefix=com.xx.anno.MyAnnotation|com.bb.anno.MyAnnotation</td>
|
|
|
+ </tr>
|
|
|
<tr align="center">
|
|
|
<td>excludePrefix</td>
|
|
|
<td>否</td>
|
|
|
- <td>通过前缀匹配的形式排除class,不对其加密
|
|
|
+ <td>通过前缀匹配的形式排除class,不对其加密,支持正则匹配
|
|
|
<br/>
|
|
|
注:多个通过逗号分割。
|
|
|
<br/>
|
|
|
注:excludePrefix优先级高于includePrefix。</td>
|
|
|
- <td>excludePrefix=com.example.service,com.example.util.StrUtil.class</td>
|
|
|
+ <td>excludePrefix=com.example.service,com.example.util.*.class</td>
|
|
|
</tr>
|
|
|
</tr>
|
|
|
<tr align="center">
|
|
|
<td>includeXmlPrefix</td>
|
|
|
<td>否</td>
|
|
|
- <td>通过打出来的包中条目的entryName前缀匹配的形式定位要加密的xml
|
|
|
+ <td>通过打出来的包中条目的entryName前缀匹配的形式定位要加密的xml,支持正则匹配
|
|
|
<br/>
|
|
|
注:多个通过逗号分割。
|
|
|
<br/>
|
|
|
注:如果您打出来的加密包是准备作为一个lib包提供给第三方使用的,那么请不要使用此参数,因为解密时是不会解密项目所依赖的lib包中的xml的。</td>
|
|
|
<td>includeXmlPrefix=BOOT-INF/classes/
|
|
|
<br/>
|
|
|
-includeXmlPrefix=BOOT-INF/classes/com/demo/mapper/,BOOT-INF/classes/com/demo/dao/</td>
|
|
|
+includeXmlPrefix=BOOT-INF/classes/com/demo/mapper/,BOOT-INF/classes/com/*/dao/</td>
|
|
|
</tr>
|
|
|
</tr>
|
|
|
<tr align="center">
|
|
|
<td>excludeXmlPrefix</td>
|
|
|
<td>否</td>
|
|
|
- <td>通过打出来的包中条目的entryName前缀匹配的形式排除xml,不对其加密
|
|
|
+ <td>通过打出来的包中条目的entryName前缀匹配的形式排除xml,不对其加密,支持正则匹配
|
|
|
<br/>
|
|
|
注:多个通过逗号分割。</td>
|
|
|
<td>excludeXmlPrefix=BOOT-INF/classes/com/demo/mapper/
|
|
|
<br/>
|
|
|
-excludeXmlPrefix=BOOT-INF/classes/com/demo/mapper/,BOOT-INF/classes/com/demo/dao/UserDao.xml</td>
|
|
|
+excludeXmlPrefix=BOOT-INF/classes/com/demo/mapper/,BOOT-INF/classes/com/demo/*/UserDao.xml</td>
|
|
|
</tr>
|
|
|
</tr>
|
|
|
<tr align="center">
|
|
|
@@ -210,12 +223,12 @@ excludeXmlPrefix=BOOT-INF/classes/com/demo/mapper/,BOOT-INF/classes/com/demo/dao
|
|
|
<tr align="center">
|
|
|
<td>includeLibs</td>
|
|
|
<td>否</td>
|
|
|
- <td>指定将lib包也纳入加密范围内
|
|
|
+ <td>指定将lib包也纳入加密范围内,支持正则匹配
|
|
|
<br/>
|
|
|
注:多个通过逗号分割。
|
|
|
<br/>
|
|
|
注:lib中的class是否会被加密,还得由includePrefix和excludePrefix决定。</td>
|
|
|
- <td>includeLibs=a.jar,b.jar</td>
|
|
|
+ <td>includeLibs=a.jar,b.jar,c-.*.jar</td>
|
|
|
</tr>
|
|
|
<tr align="center">
|
|
|
<td>alreadyProtectedRootDir</td>
|
|
|
@@ -295,6 +308,7 @@ linux示例:tips='请不要直接使用混淆后的jar/war'</td>
|
|
|
|
|
|
|
|
|
|
|
|
+
|
|
|
## <font face="幼圆" color = "#3399EA" >解密(启动)</font>
|
|
|
|
|
|
通过-javaagent指定代理进行解密启动。
|
|
|
@@ -302,8 +316,8 @@ linux示例:tips='请不要直接使用混淆后的jar/war'</td>
|
|
|
```bash
|
|
|
# 假设your-project-encrypted.jar是由class-winter加密后的包,那么你可以这么启动
|
|
|
java -javaagent:/your-project-encrypted.jar -jar /your-project-encrypted.jar
|
|
|
- # 也可以用class-winter-core-2.8.5.jar
|
|
|
- # java -javaagent:/class-winter-core-2.8.5.jar -jar /your-project-encrypted.jar
|
|
|
+ # 也可以用class-winter-core-2.8.6.jar
|
|
|
+ # java -javaagent:/class-winter-core-2.8.6.jar -jar /your-project-encrypted.jar
|
|
|
# 或者指定参数
|
|
|
# java -javaagent:/your-project-encrypted.jar=debug=true,password=pwd12345 -jar /your-project-encrypted.jar
|
|
|
# 参数可以引起来(linux)
|
|
|
@@ -319,9 +333,9 @@ linux示例:tips='请不要直接使用混淆后的jar/war'</td>
|
|
|
编辑tomcat/bin/catalina.sh文件,在最上面加上
|
|
|
|
|
|
```bash
|
|
|
- # 如果你有参数, 那么 -javaagent:/class-winter-core-2.8.5.jar=k1=v1,k2=v2
|
|
|
+ # 如果你有参数, 那么 -javaagent:/class-winter-core-2.8.6.jar=k1=v1,k2=v2
|
|
|
# tomcat启动往往需要通过decryptProjectPathPrefix指定要解密的路径
|
|
|
- CATALINA_OPTS="$CATALINA_OPTS -javaagent:/class-winter-core-2.8.5.jar=debug=true,decryptProjectPathPrefix=/usr/local/xxx/";
|
|
|
+ CATALINA_OPTS="$CATALINA_OPTS -javaagent:/class-winter-core-2.8.6.jar=debug=true,decryptProjectPathPrefix=/usr/local/xxx/";
|
|
|
export CATALINA_OPTS;
|
|
|
```
|
|
|
|
|
|
@@ -330,9 +344,9 @@ linux示例:tips='请不要直接使用混淆后的jar/war'</td>
|
|
|
在tomcat/bin目录下创建setenv.sh文件,并写上
|
|
|
|
|
|
```bash
|
|
|
- # 如果你有参数, 那么 -javaagent:/class-winter-core-2.8.5.jar=k1=v1,k2=v2
|
|
|
+ # 如果你有参数, 那么 -javaagent:/class-winter-core-2.8.6.jar=k1=v1,k2=v2
|
|
|
# tomcat启动往往需要通过decryptProjectPathPrefix指定要解密的路径
|
|
|
- JAVA_OPTS="$JAVA_OPTS -javaagent:/class-winter-core-2.8.5.jar=debug=true,decryptProjectPathPrefix=/usr/local/xxx/";
|
|
|
+ JAVA_OPTS="$JAVA_OPTS -javaagent:/class-winter-core-2.8.6.jar=debug=true,decryptProjectPathPrefix=/usr/local/xxx/";
|
|
|
export JAVA_OPTS;
|
|
|
```
|
|
|
|
|
|
@@ -341,9 +355,9 @@ linux示例:tips='请不要直接使用混淆后的jar/war'</td>
|
|
|
编辑tomcat/bin/catalina.bat文件,在@echo off后加上catalina参数
|
|
|
|
|
|
```bash
|
|
|
- rem 如果你有参数, 那么 -javaagent:D:/class-winter-core-2.8.5.jar=k1=v1,k2=v2
|
|
|
+ rem 如果你有参数, 那么 -javaagent:D:/class-winter-core-2.8.6.jar=k1=v1,k2=v2
|
|
|
rem tomcat启动往往需要通过decryptProjectPathPrefix指定要解密的路径
|
|
|
- set CATALINA_OPTS="-javaagent:D:/class-winter-core-2.8.5.jar=decryptProjectPathPrefix=/D:/tmp/"
|
|
|
+ set CATALINA_OPTS="-javaagent:D:/class-winter-core-2.8.6.jar=decryptProjectPathPrefix=/D:/tmp/"
|
|
|
```
|
|
|
|
|
|
- windows方式二
|
|
|
@@ -351,9 +365,9 @@ linux示例:tips='请不要直接使用混淆后的jar/war'</td>
|
|
|
在tomcat/bin目录下创建setenv.bat文件,并写上
|
|
|
|
|
|
```bash
|
|
|
- rem 如果你有参数, 那么 -javaagent:D:/class-winter-core-2.8.5.jar=k1=v1,k2=v2
|
|
|
+ rem 如果你有参数, 那么 -javaagent:D:/class-winter-core-2.8.6.jar=k1=v1,k2=v2
|
|
|
rem tomcat启动往往需要通过decryptProjectPathPrefix指定要解密的路径
|
|
|
- set JAVA_OPTS="-javaagent:D:/class-winter-core-2.8.5.jar=decryptProjectPathPrefix=/D:/tmp/"
|
|
|
+ set JAVA_OPTS="-javaagent:D:/class-winter-core-2.8.6.jar=decryptProjectPathPrefix=/D:/tmp/"
|
|
|
```
|
|
|
|
|
|
- #### <font face="幼圆" color = "#86CA5E" >IDE解密(启动)</font>
|
|
|
@@ -425,7 +439,7 @@ linux示例:tips='请不要直接使用混淆后的jar/war'</td>
|
|
|
|
|
|
- 背景说明:我们利用class-winter混淆项目时,项目是被混淆了,但是class-winter本身还是明文的,这就留下了一些安全隐患(即:那些不指定密码的混淆,可能会被反向破解)
|
|
|
- 增强支持:我们可以对class-winter本身进行加密,你可以切换至`enhance-*`分支,在首页下载被混淆的class-winter进行测试,或者clone代码,install后进行测试
|
|
|
-- <font face="幼圆" color = "#F53B45">**声明**</font>:因为在`enhance-*`分支里对class-winter本身进行加密时用到了名义上的收费工具allatori(实际上有破解版之类的),所以`enhance-*`分支的代码,本人并未发布至maven官方仓库
|
|
|
+- <font face="幼圆" color = "#F53B45">**声明**</font>:因为在`enhance-*`分支里对class-winter本身进行加密时用到了收费工具allatori(实际上有供学习使用的破解版之类的),所以`enhance-*`分支的代码,本人并未发布至maven官方仓库
|
|
|
|
|
|
|
|
|
## <font face="幼圆" color = "#3399EA" >将已加密的包提供给客户使用</font>
|
|
|
@@ -464,7 +478,7 @@ linux示例:tips='请不要直接使用混淆后的jar/war'</td>
|
|
|
<parent>
|
|
|
<groupId>org.springframework.boot</groupId>
|
|
|
<artifactId>spring-boot-starter-parent</artifactId>
|
|
|
- <version>2.8.5</version>
|
|
|
+ <version>2.8.6</version>
|
|
|
<relativePath/> <!-- lookup parent from repository -->
|
|
|
</parent>
|
|
|
<groupId>com.example</groupId>
|