且构网

分享程序员开发的那些事...
且构网 - 分享程序员编程开发的那些事

jasypt命令行工具的使用说明

更新时间:2022-08-14 19:20:21

  jasypt能够以很简单的方式为Java项目提供加密功能,这种简单的方式体现着它的命令行工具,与Spring,Hibernate, Springsecurity, wicket等第三方框架的集成。

    

    本文参加jasypt官方网站:http://www.jasypt.org/  下载jasypt包,解压缩到本地目录。

   如下图:

   根目录:

   jasypt命令行工具的使用说明

   命令行工具目录:

   jasypt命令行工具的使用说明

  

   说明:

           在lib目录下是jasypt的核心jar和与第三方组件集成的jar. 

           在bin目录下是jasypt的命令行工具脚本.

           在apidoc目录下自然就是帮助文档。


   下面主要介绍jasypt的命令行工具(这里的操作环境是windows系统):

   1.listAlgorithms.bat(listAlgorithms.sh)

      jasypt命令行工具的使用说明

    DIGEST ALGORTHMS:摘要算法

    PBE ALGORTHMS(PASSWORD BASE ENCRYPTION):基于口令的加密算法

  2.下面介绍如何使用digest.bat, encrypt.bat,  decrypt.bat

  •      digest.bat

    jasypt命令行工具的使用说明

   

    命令:digest.bat input=sa algorithm=SHA的意思是对输入信息:"sa" 使用SHA算法计算摘要信息,OUTPUT则是输出结果。

    说明:直接输入digest.bat可以查看命令帮助信息和参数要求,这里input是必选参数,algorithm是可选参数,默认的计算摘要信息算法是MD5。

  •     encrypt.bat和decrpt.bat

         加密和解密是对应的,同样的方式,直接输入命令就可以查看帮助信息和参数要求。比如在命令窗口输入:encrypt.bat

jasypt命令行工具的使用说明

      由于encrypt.bat和decrypt.bat是对应的,因此帮助信息和参数要求是一致的,区别在于encrypt.bat的input参数值是“原信息”,decrypt.bat的input参数值是“加密信息”。



       从上面的参数说明中可以看到algorithm是可选的,那是应为jasypt提供了默认的一套参数取值,而这里的加密的默认算法是:PBEWithMD5AndDES


     下面通过一个例子演示一下加密和解密:

     加密:

    

jasypt命令行工具的使用说明


   解密:

jasypt命令行工具的使用说明

      上述加密解密使用了“PBEWITHSHA1ANDRC2_40”算法,操作一切正常。

      经过对PBE算法中的其它三个做了同样的测试发现使用“PBEWITHMD5ANDTRIPLEDES”算法操作失败的情况。

    

jasypt命令行工具的使用说明

  

   从上面的提示信息中很难看出问题出在什么地方,于是想到用Java程序来测试一下这个算法。结果错误提示信息如下:

  

1
2
3
4
5
org.jasypt.exceptions.EncryptionOperationNotPossibleException:
 Encryption raised an exception. 
 A possible cause is you are using strong encryption algorithms and you have 
 not installed the Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy Files 
 in this Java Virtual Machine


  大致的意思是没有安装JCE不受限长度策略文件,于是百度谷歌一阵再Orcale官网找到了JDK7的JCE文件。http://www.oracle.com/technetwork/java/javase/downloads/jce-7-download-432124.html

下载后解压可以放到JAVA_HOME\jdk1.7.0_45\jre\lib\security下或者JAVA_HOME\jdk1.7.0_45_jre\lib\security下,一共两个文件local_policy.jar和US_export_policy.jar.这样会覆盖度JDK默认的这两个文件。


  为了一探究竟,这里个文件的内容不同之处,解压之后发现不同的地方在于local_policy.jar里的local_policy.policy内容。

JDK默认的local_policy.policy内容是:


1
<span style="font-family:'微软雅黑', 'Microsoft YaHei';font-size:14px;">// Some countries have import limits on crypto strength. This policy file<br>// is worldwide importable.<br><br>grant {<br>    permission javax.crypto.CryptoPermission "DES", 64;<br>    permission javax.crypto.CryptoPermission "DESede", *;<br>    permission javax.crypto.CryptoPermission "RC2", 128, <br>                                     "javax.crypto.spec.RC2ParameterSpec", 128;<br>    permission javax.crypto.CryptoPermission "RC4", 128;<br>    permission javax.crypto.CryptoPermission "RC5", 128, <br>          "javax.crypto.spec.RC5ParameterSpec", *, 12, *;<br>    permission javax.crypto.CryptoPermission "RSA", *;<br>    permission javax.crypto.CryptoPermission *, 128;<br>};<br></span>


  JCE的local_policy.policy内容是:

 

1
<span style="font-family:'微软雅黑', 'Microsoft YaHei';font-size:14px;">// Country-specific policy file for countries with no limits on crypto strength.<br>grant {<br>    // There is no restriction to any algorithms.<br>    permission javax.crypto.CryptoAllPermission; <br>};<br></span>

   

   JDK默认的policy中对一些国家进口密码强度进行了限制。


本文转自 secondriver 51CTO博客,原文链接:http://blog.51cto.com/aiilive/1420837,如需转载请自行联系原作者