使用java内置keytool配置tomcat双向SSL认证


在Tomcat 6中配置SSL双向认证是相当容易的，本文将介绍如何使用JDK的keytool来为Tomcat配置双向SSL认证。


系统需求：


JDK 5.0

Tomcat 6.0.16


第一步：为服务器生成证书


使用keytool为Tomcat生成证书，假定目标机器的域名是“localhost”，keystore文件存放在“C:/tomcat.keystore”，口令为“password”，使用如下命令生成： 



1. keytool -genkey -v -alias tomcat -keyalg RSA -keystore c:/tomcat.keystore -dname
2. "CN=localhost,OU=,O=,L=,ST=,C=" -storepass password -keypass password


复制代码



如果Tomcat所在服务器的域名不是“localhost”，应改为对应的域名，如“www.sina.com.cn”，否则浏览器会弹出警告窗口，提示用户证书与所在域不匹配。在本地做开发测试时，应填入“localhost”

；证书如果没有指定有效期，默认为90天


第二步：为客户端生成证书


下一步是为浏览器生成证书，以便让服务器来验证它。为了能将证书顺利导入至IE和Firefox，证书格式应该是PKCS12，因此，使用如下命令生成： 



1. keytool -genkey -v -alias mykey -keyalg RSA -storetyp PKCS12 C:/my.p12
2.   -dname "CN=localhost,OU=,O=,L=,ST=,C=" -storepas password -keypass password



复制代码



对应的证书库存放在“C:/my.p12”，客户端的CN可以是任意值。稍候，我们将把这个“my.p12”证书库导入到IE和Firefox中。


第三步：让服务器信任客户端证书


由于是双向SSL认证，服务器必须要信任客户端证书，因此，必须把客户端证书添加为服务器的信任认证。由于不能直接将PKCS12格式的证书库导入，我们必须先把客户端证书导出为一个单独的CER文件，使用如下命令： 



1. keytool -export -alias mykey -keystore cL/my.p12 -storetype PKCS12 -storepass password -rfc -file C:/my.cer


复制代码



通过以上命令，客户端证书就被我们导出到“C:/my.cer”文件了。下一步，是将该文件导入到服务器的证书库，添加为一个信任证书： 



1. keytool -import -v -file C:/my.cer -keystore C:/tomcat.keystore -storepass password



复制代码



通过list命令查看服务器的证书库，我们可以看到两个输入，一个是服务器证书，一个是受信任的客户端证书：




  1. keytool -list c:/tomcat.keystore -storepass password



复制代码



第四步：配置Tomcat服务器


打开Tomcat根目录下的/conf/server.xml，找到如下配置段，修改如下： 



1. <Connector port="8443" protocol="HTTP/1.1" SSLEnabled="true"
2.     maxThreads="150" scheme="https" secure="true"
3.     clientAuth="true" sslProtocol="TLS"
4.     keystoreFile="C:/tomcat.keystore" keystorePass="password"
5.     truststoreFile="C:/tomcat.keystore" truststorePass="password"
6. />



复制代码



其中，clientAuth指定是否需要验证客户端证书，如果该设置为“false”，则为单向SSL验证，SSL配置可到此结束。如果clientAuth设置为“true”，表示强制双向SSL验证，必须验证客户端证书。如果clientAuth设置为“want”，则表示可以验证客户端证书，但如果客户端没有有效证书，也不强制验证。


第五步：导入客户端证书


如果设置了clientAuth="true"，则需要强制验证客户端证书。双击“C:/my.p12”即可将证书导入至IE：




导入证书后，即可启动Tomcat，用IE进行访问。如果需要用FireFox访问，则需将证书导入至FireFox：





============================================

DName 信息域含义

CN

域名或 IP

OU

部门，没有部门的可不要此项

O

单位名称

L

单位地址

S

省份的拼音（第一个字母大写）

C

国家的简写 （ CN 代表中国）