Tomcat SSL配置大全


一、准备工作
    1). 安装JDK 1.5 或更高版本, 并配置JAVA_HOME 环境变量;
    2). 安装tomcat 6 ;
  
二、配置过程
    1.生成 server key :
      以命令行方式切换到目录%tomcat_HOME%,在command命令行输入如下命令(jdk1.4以上带的工具):
      keytool -genkey -alias tomcat -keyalg RSA -keypass changit -storepass changit -keystore server.keystore -validity 3600
     
      用户名输入域名,如localhost(开发或测试用)或hostname.domainname(用户拥有的域名),其它全部以 enter 跳过,最后确认,
      此时会在%JAVA_HOME%/bin下生成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 changit
     
      keytool -import -trustcacerts -alias tomcat -file server.cer -keystore  %JAVA_HOME%/jre/lib/security/cacerts -storepass changeit
     
      如果有提示,输入Y就可以了。
  
   其他有用keytool命令(列出信任证书库中所有已有证书,删除库中某个证书):
  
   keytool -list -v -keystore %JAVA_HOME%/jre/lib/security/cacerts
   keytool -delete -trustcacerts -alias tomcat  -keystore  %JAVA_HOME%/jre/lib/security/cacerts -storepass changit

  3.配置tomcat :
   修改%TOMCAT_HOME%"conf"server.xml,以文字编辑器打开,查找这一行:
   xml 代码
  
   将之后的那段的注释去掉,并加上 keystorePass及keystoreFile属性。
   注意,tomcat不同版本配置是不同的:
   tomcat4.1.34配置:
   xml 代码     <Connector className="org.apache.coyote.tomcat4.CoyoteConnector"             port="8443" enableLookups="true" scheme="https" secure="true"             acceptCount="100"             useURIValidationHack="false" disableUploadTimeout="true"             clientAuth="false" sslProtocol="TLS"               keystoreFile="server.keystore"               keystorePass="changit"/>  tomcat5.5.9配置:
  
    
   xml 代码
     
   <Connector port="8443" maxHttpHeaderSize="8192"  
              maxThreads="150" minSpareThreads="25" maxSpareThreads="75"  
              enableLookups="false" disableUploadTimeout="true"  
              acceptCount="100" scheme="https" secure="true"  
              clientAuth="false" sslProtocol="TLS"    
              keystoreFile="server.keystore"    
              keystorePass="changit"/>  
   tomcat5.5.20配置(此配置同样可用于tomcat6.0):
   
   xml 代码
     
   <Connector protocol="org.apache.coyote.http11.Http11Protocol"    
                        port="8443" maxHttpHeaderSize="8192"  
              maxThreads="150" minSpareThreads="25" maxSpareThreads="75"  
              enableLookups="false" disableUploadTimeout="true"  
              acceptCount="100" scheme="https" secure="true"  
              clientAuth="false" sslProtocol="TLS"                   
              keystoreFile="server.keystore"    
              keystorePass="changit"/>  
   tomcat6.0.10配置:
  
   xml 代码
   <Connector protocol="org.apache.coyote.http11.Http11NioProtocol"  
              port="8443" minSpareThreads="5" maxSpareThreads="75"  
              enableLookups="true" disableUploadTimeout="true"    
              acceptCount="100"  maxThreads="200"  
              scheme="https" secure="true" SSLEnabled="true"  
              clientAuth="false" sslProtocol="TLS"  
              keystoreFile="server.keystore"    
              keystorePass="changit"/>  
   tomcat6支持3种,请参考以下文档:
   http://tomcat.apache.org/tomcat-6.0-doc/ssl-howto.html
  
  4.验证配置
   访问 https://localhost:8443/
   <connector protocol="org.apache.coyote.http11.Http11NioProtocol"></connector>
  
  5. 如果默认想用HTTPS 方式进行网站, 可以作如下配置:
  一般Tomcat默认的SSL端口号是8443,但是对于SSL标准端口号是443,
  这样在访问网页的时候,直接使用https而不需要输入端口号就可以访问,如https://localhost
 
   1).non-SSL HTTP/1.1 Connector定义的地方,一般如下:
        <Connector port="80" maxHttpHeaderSize="8192"  scheme="https"
                maxThreads="500" minSpareThreads="25" maxSpareThreads="75"
                enableLookups="false" redirectPort="443" acceptCount="100"
                connectionTimeout="20000" disableUploadTimeout="true" />  
 
      将其中的redirectPort端口号改为:443

   2).SSL HTTP/1.1 Connector定义的地方,修改端口号为:443,如下:
       <Connector    
       port="443" maxHttpHeaderSize="8192"
       maxThreads="150" minSpareThreads="25"
       maxSpareThreads="75"
       enableLookups="false"
       disableUploadTimeout="true"
       acceptCount="100" scheme="https"
       secure="true"
       clientAuth="false" sslProtocol="TLS"
        SSLEnabled="true"  
       keystoreFile="e:/server.keystore"
       keystorePass="changit" />
    3).AJP 1.3 Connector定义的地方,修改redirectPort为443,如下:  
    <Connector port="8009"
          enableLookups="false" redirectPort="443" protocol="AJP/1.3" />
                   
                   
   如上配置好后便可以用 Https://localhost 方式直接访问,无需输入端口号;

三、参考资料
  1. Keytool使用指南:
    http://java.sun.com/j2se/1.4.2/docs/tooldocs/windows/keytool.html

  2. tomcat-ssl配置指南:
    http://tomcat.apache.org/tomcat-5.5-doc/ssl-howto.html
    http://tomcat.apache.org/tomcat-6.0-doc/ssl-howto.html

你可能感兴趣的:(java,tomcat)