java jasypt_jasypt命令行工具的使用说明

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

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

如下图：

根目录：

命令行工具目录：

说明：

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

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

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

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

1.listAlgorithms.bat(listAlgorithms.sh)

DIGEST ALGORTHMS:摘要算法

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

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

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

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

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

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

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

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

加密：

解密：

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

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

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

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内容是：

// Some countries have import limits on crypto strength. This policy file

// is worldwide importable.

grant {

permission javax.crypto.CryptoPermission “DES”, 64;

permission javax.crypto.CryptoPermission “DESede”, *;

permission javax.crypto.CryptoPermission “RC2”, 128,

“javax.crypto.spec.RC2ParameterSpec”, 128;

permission javax.crypto.CryptoPermission “RC4”, 128;

permission javax.crypto.CryptoPermission “RC5”, 128,

“javax.crypto.spec.RC5ParameterSpec”, *, 12, *;

permission javax.crypto.CryptoPermission “RSA”, *;

permission javax.crypto.CryptoPermission *, 128;

};

JCE的local_policy.policy内容是：

// Country-specific policy file for countries with no limits on crypto strength.

grant {

// There is no restriction to any algorithms.

permission javax.crypto.CryptoAllPermission;

};

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

关于jasypt的命令行工具使用介绍和可能产生的问题做了说明，要想了解具体的机密解密的原理可以参加《Java加密与解密的艺术》作者博客：http://snowolf.iteye.com/blog/379860。