启用 Tomcat 下的 HTTPS/java 证书签证

仅供备忘。

在 Tomcat 5.0 中启用 HTTPS 的连接。

重要提示：两种容易出错的情况
1、keystore的密码与tomcat的主密码不一致；在接下来的步骤中，请把这两个密码输入成相同的；
2、用来生成keystore的java版本与运行tomcat的java版本不一致；运行下面的命令之前，先检查一下。
wakan@wakan:~/tomcat2/bin>which java
/home/jdk150/bin/java
在启动tomcat时，看看所用的JAVA_HOME是不是上面的/home/jdk150，如果不是，请修改用户的profile文件，或者修改tomcat的启动文件。
最简单的做法是在/etc/profile文件中加入下面几行，然后重新登录，再进行后续操作：
JAVA_HOME=/home/jdk150
PATH=$JAVA_HOME/bin:$PATH
export JAVA_HOME PATH

一、生成 KeyStore

这一步比较简单，利用 JDK 自带的 keytool 即可完成。命令如下：

wakan@wakan:~/tomcat2/bin> [color=red]keytool -genkey -alias tomcat -keyalg RSA[/color]
输入keystore密码： ************
您的名字与姓氏是什么？
[Unknown]： aaa
您的组织单位名称是什么？
[Unknown]： bbb
您的组织名称是什么？
[Unknown]： ccc
您所在的城市或区域名称是什么？
[Unknown]： BeiJing
您所在的州或省份名称是什么？
[Unknown]： BeiJing
该单位的两字母国家代码是什么
[Unknown]： CN
CN=aaa, OU=bbb, O=ccc, L=BeiJing, ST=BeiJing, C=CN 正确吗？
[否]： 是

输入的主密码
（如果和 keystore 密码相同，按回车）：

特别说明：上边输入的“的主密码”，与keystore密码一定要相同，否则TOMCAT起不来。至少我试了几次都不行。报错如下：
2007-3-26 17:07:01 org.apache.coyote.http11.Http11BaseProtocol init
严重: Error initializing endpoint
java.io.IOException: Cannot recover key
at org.apache.tomcat.util.net.jsse.JSSE14SocketFactory.init(JSSE14Socket Factory.java:125)

二、修改 server.xml

在 TOMCAT/conf/server.xml 中，修改与 SSL 相关的那一段，我改成下面这样：

maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
enableLookups="false" disableUploadTimeout="true"
acceptCount="100" [color=red]scheme="https" secure="true" keystorePass="******"
clientAuth="false" sslProtocol="TLS"[/color] />

这里要指定keystorePass，如果写错了，会出现下边的错误：
严重: Error initializing endpoint
java.io.IOException: Keystore was tampered with, or password was incorrect
at sun.security.provider.JavaKeyStore.engineLoad(JavaKeyStore.java:768)

三、启动 Tomcat

这一步比较简单，就不多说了。启动完成后，在浏览器中输入：[url]https://localhost:8443[/url]，即可看到TOMCAT的主页面。

wakan@wakan:~/tomcat2/bin> ./startup.sh
Using CATALINA_BASE: /home/wakan/tomcat2
Using CATALINA_HOME: /home/wakan/tomcat2
Using CATALINA_TMPDIR: /home/wakan/tomcat2/temp
Using JRE_HOME: /home/jdk150/jre
2007-3-26 17:09:39 org.apache.catalina.core.AprLifecycleListener lifecycleEvent


利用keytool产生自签证书的步骤2如下：

第一步，用-genkey命令选项，产生公私密钥对。在控制台界面输入：keytool -genkey -alias testkeypair -keyalg RSA -keysize 1024 -sigalg MD5withRSA。这里的-alias表示使用这对公私密钥产生新的keystore入口的别名(keystore是用来存放管理密钥对和证书链的，缺省位置是在使用者主目录下，以.keystore为名的隐藏文件，当然也可指定某个路径存放.keystore文件)；-keyalg是产生公私钥对所用的算法，这里是RSA；-keysize定义密钥的长度；-sigalg是签名算法，选择MD5withRSA，即用RSA签名，然后用MD5哈希算法摘要。接下来，系统会提示进行一些输入：

输入keystore密码： abc123
您的名字与姓氏是什么？
[Unknown]： Li
您的组织单位名称是什么？
[Unknown]： InfosecLab
您的组织名称是什么？
[Unknown]： InfosecLab Group
您所在的城市或区域名称是什么？
[Unknown]： Beijing
您所在的州或省份名称是什么？
[Unknown]： Beijing
该单位的两字母国家代码是什么
[Unknown]： CN
CN=Li, OU=InfosecLab, O=InfosecLab Group, L=Beijing, ST=Beijing, C=CN 正确吗？
[否]： y
输入 的主密码 (如果和 keystore 密码相同，按回车）：


第二步，产生自签证书，输入以下命令：

keytool -selfcert -alias testkeypair -dname "CN=Li, OU=InfosecLab, O=InfosecLab
Group, L=Beijing, ST=Beijing, C=CN"
输入keystore密码： abc123


第三步，导出自签证书，由上面两步产生的证书，已经存放在以“testkeypair”为别名的keystore入口了，如果使用其文件，必须导出证书。输入:

keytool -export -rfc -alias testkeypair -file mycert.crt
输入keystore密码： abc123
保存在文件中的认证


这样，就得到了一个自签的证书mycert.crt。注意，选项rfc是把证书输出为RFC1421定义的、用Base64最终编码的格式。