tomcat的ssl配置.doc

Tomcat SSL配置大全
关键字: tomcat ssl
由于配置CAS的单点登陆系统，需要先配置Tomcat的SSL, 在配置tomcat的SSL过程中，我配置的版本是tomcat5.5.20,参考了很多资料，但发现一直不行，后来我换到了5.5.9,结果非常顺利，我于是换了总共4个主要版本，发现SSL的配置还真有些不同，但所有的相关配置都必须使用PKI厂商提供的cacheFile文件将你所使用的JDK下jre里面的cacheFile文件体会掉才可以使用，现在我将这些配置记录下来，供下次参考。

参考文档
Keytool使用指南：

Tomcat-ssl配置指南：
http://tomcat.apache.org/tomcat-5.5-doc/ssl-howto.html
配置过程
1.      生成 server key ：
以命令行方式切换到目录%TOMCAT_HOME%，在command命令行输入如下命令（jdk1.4以上带的工具）： 
keytool -genkey -alias tomcat -keyalg RSA -keypass changeit -storepass changeit -keystore server.keystore -validity 3600
用户名输入域名，如localhost（开发或测试用）或hostname.domainname(用户拥有的域名)，其它全部以 enter 跳过，最后确认，此时会在%TOMCAT_HOME%下生成server.keystore 文件。
注：参数 -validity 指证书的有效期(天)，缺省有效期很短，只有90天。
2.  将证书导入的JDK的证书信任库中:
这步对于Tomcat的SSL配置不是必须，但对于CAS SSO是必须的，否则会出现如下错误：edu.yale.its.tp.cas.client.CASAuthenticationException: Unable to validate ProxyTicketValidator。。。
导入过程分2步，第一步是导出证书，第二步是导入到证书信任库，命令如下：
keytool -export -trustcacerts -alias tomcat -file server.cer -keystore  server.keystore -storepass changeit
keytool -import -trustcacerts -alias tomcat -file server.cer -keystore  %JAVA_HOME%/jre/lib/security/cacerts -storepass changeit
如果有提示，输入Y就可以了。
其他有用keytool命令（列出信任证书库中所有已有证书，删除库中某个证书）：
keytool -list -v -keystore D:/sdks/jdk1.5.0_11/jre/lib/security/cacerts
keytool -delete -trustcacerts -alias tomcat  -keystore  D:/sdks/jdk1.5.0_11/jre/lib/security/cacerts -storepass changeit
3.  配置TOMCAT :
修改%TOMCAT_HOME%\conf\server.xml，以文字编辑器打开，查找这一行：
xml 代码
1.   
将之后的那段的注释去掉，并加上 keystorePass及keystoreFile属性。
注意，tomcat不同版本配置是不同的:
Tomcat4.1.34配置：
xml 代码
1.   
2.    <Connector className="org.apache.coyote.tomcat4.CoyoteConnector"  
3.            port="8443" enableLookups="true" scheme="https" secure="true"  
4.            acceptCount="100"  
5.            useURIValidationHack="false" disableUploadTimeout="true"  
6.            clientAuth="false" sslProtocol="TLS"    
7.            keystoreFile="server.keystore"    
8.            keystorePass="changeit"/>  
Tomcat5.5.9配置：

xml 代码
1.   
2. <Connector port="8443" maxHttpHeaderSize="8192"  
3.            maxThreads="150" minSpareThreads="25" maxSpareThreads="75"  
4.            enableLookups="false" disableUploadTimeout="true"  
5.            acceptCount="100" scheme="https" secure="true"  
6.            clientAuth="false" sslProtocol="TLS"    
7.            keystoreFile="server.keystore"    
8.            keystorePass="changeit"/>  
Tomcat5.5.20配置(此配置同样可用于Tomcat6.0)：

xml 代码
1.   
2. <Connector protocol="org.apache.coyote.http11.Http11Protocol"    
3.                      port="8443" maxHttpHeaderSize="8192"  
4.            maxThreads="150" minSpareThreads="25" maxSpareThreads="75"  
5.            enableLookups="false" disableUploadTimeout="true"  
6.            acceptCount="100" scheme="https" secure="true"  
7.            clientAuth="false" sslProtocol="TLS"                   
8.            keystoreFile="server.keystore"    
9.            keystorePass="changeit"/>  
Tomcat6.0.10配置：
xml 代码
1. <Connector protocol="org.apache.coyote.http11.Http11NioProtocol"  
2.            port="8443" minSpareThreads="5" maxSpareThreads="75"  
3.            enableLookups="true" disableUploadTimeout="true"    
4.            acceptCount="100"  maxThreads="200"  
5.            scheme="https" secure="true" SSLEnabled="true"  
6.            clientAuth="false" sslProtocol="TLS"  
7.            keystoreFile="D:/tools/apache-tomcat-6.0.10/server.keystore"    
8.            keystorePass="changeit"/>  
tomcat6支持3种，请参考以下文档：
http://tomcat.apache.org/tomcat-6.0-doc/ssl-howto.html

keystoreFile:是私钥放置的位置，可以放在服务器根目录，那么只需要写私钥名字即可。
keystorePass：私钥的密码
如果你使用的jdk为1.4及以下版本，那需要找一个1.4以上的版本，将jdk中\jre\lib\security下面的cacerts文件覆盖到相应位置就可以了，这样在ssl中读取证书时才不会找不到证书。
验证配置
访问 https://localhost:8443/
<connector protocol="org.apache.coyote.http11.Http11NioProtocol"></connector>
· 17:11
· 浏览 (7075)
· 论坛浏览 (12011)
· 评论 (4)
· 分类: Tomcat
· 收藏
· 相关推荐
评论
4 楼 wumingsx 2007-10-28   引用
你配置完成后,证书是可以信任的吗,你的证书如何获得的,只是用命令生成的吗
3 楼 eddie 2007-10-18   引用
这句有问题，
keytool -import -trustcacerts -alias tomcat -file server.cer -keystore  cacerts -storepass changeit

请将它改为：
keytool -export -trustcacerts -alias tomcat -file server.cer -keystore  server.keystore -storepass changeit
2 楼 boddi 2007-10-11   引用
为什么
导入过程分2步，第一步是导出证书，第二步是导入到证书信任库，命令如下：
keytool -import -trustcacerts -alias tomcat -file server.cer -keystore  cacerts -storepass changeit
出现
keytool错误： java.io.FileNotFoundException: server.cer (系统找不到指定的文件。)
1 楼 smiles_van 2007-08-08   引用
原文好像有点问题：
导入过程分2步，第一步是导出证书，第二步是导入到证书信任库，命令如下：
keytool -import -trustcacerts -alias tomcat -file server.cer -keystore  cacerts -storepass changeit
（应该修正为
keytool -export -trustcacerts -alias tomcat -file server.cer -keystore server.keystore -storepass changeit
）
keytool -import -trustcacerts -alias tomcat -file server.cer -keystore  D:/sdks/jdk1.5.0_11/jre/lib/security/cacerts -storepass changeit