Tomcat (1) —— Mac下配置Tomcat Https/SSL

时间:2023-01-02 11:48:32

Tomcat (1) —— Mac下配置Tomcat Https/SSL


tomcat版本: tomcat-8.0.29

jdk版本: jdk1.8.0_65

参考来源:

SSL/TLS Configuration HOW-TO

【高可用HA】Apache (2) —— Mac下安装多个Apache Tomcat实例

完美配置Tomcat的HTTPS

两步搞定 Tomcat 下启用 https:// 访问

tomcat下配置https环境

安装与配置

首先

参照博文配置好单个Tomcat实例作为https的目标测试服务环境。"./servers/cluster/tomcat/node-c"

【高可用HA】Apache (2) —— Mac下安装多个Apache Tomcat实例

配置证书

1. 创建证书

证书是单点登录认证系统中很重要的一把钥匙,客户端于服务器的交互安全靠的就是证书;本教程由于是演示所以就自己用JDK自带的keytool工具生成证书;如果以后真正在产品环境中使用肯定要去证书提供商去购买,证书认证一般都是由VeriSign认证,中文官方网站:http://www.verisign.com/cn/

先查看当前JAVA_HOME的jdk版本:

$ java -version
java version "1.8.0_65"
Java(TM) SE Runtime Environment (build 1.8.0_65-b17)
Java HotSpot(TM) 64-Bit Server VM (build 25.65-b01, mixed mode)
* 注意以下提示输入服务器域名的时候不能用IP地址

用JDK自带的keytool工具生成证书:

$ keytool -genkey -alias hoau -keyalg RSA -keystore /Users/Richard/Documents/Dev/servers/cluster/tomcat/keys/hoaukey
输入密钥库口令:
再次输入新口令:
您的名字与姓氏是什么?
[Unknown]: sso.hoau.com
您的组织单位名称是什么?
[Unknown]: hoau.com
您的组织名称是什么?
[Unknown]: sso
您所在的城市或区域名称是什么?
[Unknown]: Shanghai
您所在的省/市/自治区名称是什么?
[Unknown]: Shanghai
该单位的双字母国家/地区代码是什么?
[Unknown]: CN
CN=sso.hoau.com, OU=hoau.com, O=sso, L=Shanghai, ST=Shanghai, C=CN是否正确?
[否]: y 输入 <hoau> 的密钥口令
(如果和密钥库口令相同, 按回车):

Tomcat (1) —— Mac下配置Tomcat Https/SSL

* 关于以上问题参数的说明
  • 单点登陆服务器的域名:

      您的名字与姓氏是什么?
    [Unknown]: sso.hoau.com
  • 公司的名称:

      您的组织单位名称是什么?
    [Unknown]: hoau.com
  • 单点登陆服务名称:

      您的组织名称是什么?
    [Unknown]: sso
  • 所在地及国别:

      您所在的城市或区域名称是什么?
    [Unknown]: Shanghai
    您所在的省/市/自治区名称是什么?
    [Unknown]: Shanghai
    该单位的双字母国家/地区代码是什么?
    [Unknown]: CN
  • 最后输入客户端所用密钥(Hoau123):

      输入 <hoau> 的密钥口令
    (如果和密钥库口令相同, 按回车):

如果出现如下错误:

keytool 错误: java.io.FileNotFoundException: /Users/Richard/Documents/Dev/servers/cluster/tomcat/keys/hoaukey (No such file or directory)

这可能是因为目标路径上文件不存在。

如果出现如下错误:

keytool 错误: java.io.FileNotFoundException: /Users/Richard/Documents/Dev/servers/cluster/tomcat/keys/hoaukey (Is a directory)

这是因为hoaukey是文件目录,将其删除即可。

2. 导出证书

:tomcat Richard$ keytool -export -file ./keys/hoau.crt -alias hoau -keystore ./keys/hoaukey
输入密钥库口令:
存储在文件 <./keys/hoau.crt> 中的证书

3. 为客户端的JVM导入证书

$ sudo keytool -import -keystore /Library/Java/JavaVirtualMachines/jdk1.8.0_65.jdk/Contents/Home/jre/lib/security/cacerts -file ./keys/hoau.crt

运行结果(此处密钥库口令与之前生成的口令相同)

输入密钥库口令:
再次输入新口令:
所有者: CN=sso.hoau.com, OU=hoau.com, O=sso, L=Shanghai, ST=Shanghai, C=CN
发布者: CN=sso.hoau.com, OU=hoau.com, O=sso, L=Shanghai, ST=Shanghai, C=CN
序列号: 54668c91
有效期开始日期: Thu Dec 10 10:30:57 CST 2015, 截止日期: Wed Mar 09 10:30:57 CST 2016
证书指纹:
MD5: 13:40:A0:58:44:73:95:C5:DD:5B:3F:A9:75:07:EF:9C
SHA1: 31:06:8C:A7:68:34:BE:A1:28:11:DE:27:3E:62:58:58:D7:D5:C1:56
SHA256: AC:6F:B2:DE:AC:69:D0:D6:BF:E6:A6:CD:BE:DF:EE:EA:79:17:FA:61:20:8D:06:24:E1:4B:00:55:5F:D9:65:BE
签名算法名称: SHA256withRSA
版本: 3 扩展: #1: ObjectId: 2.5.29.14 Criticality=false
SubjectKeyIdentifier [
KeyIdentifier [
0000: 22 7B 1A C9 78 B8 F8 B3 0B 3A F5 30 DF A9 D7 B9 "...x....:.0....
0010: FB E4 32 3D ..2=
]
] 是否信任此证书? [否]: y
证书已添加到密钥库中

可能会出现错误

keytool 错误: java.io.IOException: Keystore was tampered with, or password was incorrect

可以通过查看路径设置是否正确或查看jdk下security目录下的cacerts文件是否存在,如果存在可以通过rename的方式,将其改名。

Tomcat (1) —— Mac下配置Tomcat Https/SSL

配置服务器

打开"./tomcat/node-c/conf/server.xml"

将原来被注释掉的SSL相关配置修改成:

<Connector port="8433" protocol="org.apache.coyote.http11.Http11NioProtocol"
maxThreads="150" SSLEnabled="true" scheme="https" secure="true"
clientAuth="false" sslProtocol="TLS"
keystoreFile="/Users/Richard/Documents/Dev/servers/cluster/tomcat/keys/hoaukey" keystorePass="Hoau123"/>
*注意,此处我们将SSL的端口从"8443"修改成了"8433"

配置系统环境

在创建证书证书的时候,我们指定的服务器域名为sso.hoau.com。为了能使本地浏览器

通过域名能正常访问,我们需要修改增加host配置

127.0.0.1  sso.hoau.com

运行

执行命令

:node-c Richard$ ./bin/startup.sh

提示错误

-bash: ./bin/startup.sh: Permission denied

运行命令

sudo chmod +x ./bin/*.sh

再启动

$ ./bin/startup.sh

停止命令为

$ ./bin/startup.sh
  • *此时可能会在catalina的log中出现如下错误

      10-Dec-2015 11:03:35.473 SEVERE [main] org.apache.tomcat.util.net.jsse.JSSESocketFactory.getStore Failed to load keystore type JKS with path /Users/Richard/.keystore due to /Users/Richard/.keystore (No such file or directory)
    java.io.FileNotFoundException: /Users/Richard/.keystore (No such file or directory)
    at java.io.FileInputStream.open0(Native Method)
    at java.io.FileInputStream.open(FileInputStream.java:195)
    at java.io.FileInputStream.<init>(FileInputStream.java:138)
    at java.io.FileInputStream.<init>(FileInputStream.java:93)

    可能的原因有两个

    1. 注意SSL配置中的关键字key值都是区分大小写的,比如"keystoreFile"和"keystorePass" 。
    2. 注意确认"keystoreFile"和"keystorePass"相关参数路径的正确性。

测试

用浏览器访问https://sso.hoau.com:8433,会出现结果:

Tomcat (1) —— Mac下配置Tomcat Https/SSL

结束