如何在 Tomcat Web 服务器上安装 SSL 证书
在 Tomcat Web 服务器上设置 SSL 证书的初学者指南
在 Tomcat Web 服务器上安装 SSL 证书,可以增强网站安全性和用户信任。在 Tomcat 上安装 SSL 证书需要特定步骤,才能有效保护你的 Web 应用。本指南解释了生成证书签名请求(CSR)、从受信任的证书颁发机构获取 SSL 证书,以及配置 Tomcat 的 server.xml 文件的过程。
你将学习如何转换证书格式、把它们导入 Java 密钥库,并验证安装是否成功。按照这些说明操作,你可以在 Tomcat 服务器上启用 HTTPS,并确保服务器与网站访问者之间的数据传输是加密的。
在 Tomcat 上安装 SSL 的先决条件
在开始 SSL 安装过程之前,请确保满足以下先决条件:
- 已安装并运行 Tomcat 7 或更高版本。这些步骤应适用于 Tomcat 7 及以上的任何版本。
- 已安装 Java 运行时环境(JRE),并带有 Java 捆绑的 keytool 实用程序。
- 拥有你要使用 SSL 保护的域名,并具备其所有权和访问权。
- 端口 443(即 SSL 端口)应开放且可用。
在 Tomcat Web 服务器上安装 SSL 证书的 6 个简单步骤
请遵循在 Tomcat 服务器上安装 SSL 证书的步骤:
- 使用 Keytool 生成 CSR
- 获取 SSL 证书
- 把 SSL 证书导入密钥库
- 为 SSL 配置 server.xml
- 重启 Tomcat 使更改生效
- 测试 SSL 配置
第 1 步——使用 Keytool 生成 CSR
第一步是使用 Java JRE 的 keytool 命令创建证书签名请求(CSR)和私钥。
以下是生成 CSR 的 keytool 命令:
keytool -genkey -alias tomcat -keyalg RSA -keystore tomcat.keystore
这会提示你回答一些问题:
- 密钥库密码:选择一个强密码来保护密钥库。请务必记住它。
- 你的名字和姓氏:输入域名或服务器名称。
- 组织单位:输入你的组织信息。
- 组织:输入你组织的法定名称。
- 城市/州:输入你的所在地信息。
- 国家代码:输入两个字母的国家代码。
回答完这些提示后,CSR 和私钥就会生成并存储在 Tomcat.keystore 文件中。
请从你希望生成密钥库的目录中运行 keytool 命令。
第 2 步——获取 SSL 证书
现在你已经生成了 CSR 和私钥,下一步是从受信任的证书颁发机构(CA)获取 SSL 证书。
获取证书时,你必须提供第一步中生成的 CSR。
CA 签发 SSL 证书后,你将获得一个文件格式的证书,例如 .crt 或 .pem。
第 3 步——把 SSL 证书导入密钥库
从 CA 获得 SSL 证书文件后,我们需要把它导入已包含私钥的密钥库。
使用以下 keytool 命令把 SSL 证书导入密钥库:
keytool -import -file certificate.crt -alias tomcat -keystore tomcat.keystore
- 将 certificate.crt 替换为你实际的 SSL 证书文件。
- 当提示输入密钥库密码时,使用你在生成 CSR 时创建的密码。
这会把 CA 签名的 SSL 证书导入密钥库文件。
第 4 步——为 SSL 配置 server.xml
需要更新 Tomcat 的 server.xml 配置文件以启用 SSL 连接。
在文本编辑器中打开位于 $CATALINA_HOME/conf/server.xml 的 server.xml 文件。
添加如下带 SSL 配置的 Connector 标签:
<Connector protocol="org.apache.coyote.http11.Http11NioProtocol" port="443" maxThreads="200" scheme="https" secure="true" SSLEnabled="true" keystoreFile="/path/to/tomcat.keystore" keystorePass="mypassword" clientAuth="false" sslProtocol="TLS"/>
关键属性包括:
- scheme="https":启用 HTTPS
- secure="true":指定安全连接
- SSLEnabled="true":为该连接器启用 SSL
- keystoreFile:包含 SSL 证书的密钥库文件路径
- keystorePass:创建 CSR 时使用的密钥库密码
添加此 Connector 配置后,保存 server.xml 文件。
第 5 步——重启 Tomcat 使更改生效
要使 SSL 设置和连接器配置生效,你必须重启 Tomcat 服务器。
在 Linux/Unix 系统上,使用以下命令重启 Tomcat:
$CATALINA_HOME/bin/shutdown.sh $CATALINA_HOME/bin/startup.sh
在 Windows 上,你可以从服务面板重启 Tomcat 服务。
Tomcat 重启后,它将开始使用 SSL 证书在端口 443 上接受 HTTPS 请求。
第 6 步——测试 SSL 配置
要验证 SSL 证书是否安装正确,请通过 HTTPS 访问你的网站:
https://yourdomain.com
如果你没有收到 SSL 警告,并在浏览器 URL 栏中看到锁图标,则说明 SSL 证书已在 Tomcat 上正确配置。
你还可以使用免费的 SSL 检查工具来分析 TLS 设置。它将验证你的证书链并对实现情况进行评级。
就是这样!Tomcat 现在正在使用已安装的 SSL 证书,通过 HTTPS 安全地提供流量。
Tomcat 上常见的 SSL 问题及排查方法
以下是在 Tomcat 上启用 SSL 时面临的一些常见问题及其排查方法:
浏览器显示 SSL 连接错误或警告
这意味着 SSL 证书配置存在问题。请确保你把有效的证书文件导入了密钥库。server.xml 中提供的密钥库路径和密码,也应与生成 CSR 时使用的一致。
Tomcat 无法正确重启
检查 $CATALINA_HOME/logs/catalina.out 中的日志,查找异常或错误。确保 Connector SSL 配置中的密钥库路径和密码匹配。
端口 443 已被占用
如果另一个程序占用了端口 443,请更改 server.xml 中的 SSL 连接器端口,或终止使用该端口的进程。
HTTPS 网站无法访问
再次检查防火墙、负载均衡器或代理是否允许端口 443 的流量。SSL 连接器还必须绑定到服务器的公网 IP。
SSL 连接正常,但某些资源无法加载
当某些资源通过 HTTP 而非 HTTPS 加载时,就会发生这种情况。请确保所有链接和资源都是相对路径,或以 HTTPS 为前缀。
出现弱密码或协议支持错误
按照行业最佳实践,更新 server.xml 中的 SSL 协议和密码套件。在 Qualys SSL Labs 上测试你的网站,以识别并修复漏洞。
自签名证书警告
如果你使用未经受信任 CA 签名的自签名证书,浏览器将显示安全警告。可考虑获取 CA 签名的证书来解决此问题。
仔细梳理这些排查步骤,通常有助于识别并解决 Tomcat 的任何 SSL 问题。
结语
总之,在 Tomcat Web 服务器上安装 SSL 证书,是保护你的 Web 应用和保护用户敏感数据的关键一步。按照本指南概述的步骤,你可以快速生成自签名证书,或从证书颁发机构获取受信任的 SSL 证书,然后配置 Tomcat 使用该证书。
此过程确保所有客户端与服务器之间的通信都是加密的,从而提供安全性并与你的用户建立信任。维护和更新你的 SSL 证书,对于保护你的 Web 应用同样重要。
常见问题
以下是关于在 Tomcat 上设置和管理 SSL 证书的一些常见问题:
Tomcat 是否支持多个 SSL 证书的 SNI?
Tomcat 支持服务器名称指示(SNI),它允许在同一个 IP 地址上通过不同域名托管多个 SSL 证书。
Tomcat 上的 SSL 证书文件位于哪里?
SSL 证书和私钥存储在 Tomcat 密钥库文件中,通常名为 Tomcat.keystore,位于 Tomcat 配置目录中。
我能用 PKCS#12 文件作为 Tomcat 密钥库吗?
你可以使用扩展名为 .p12 的 PKCS#12 密钥库文件进行 Tomcat 的 SSL 配置。其过程与使用 JKS 格式相同。
Tomcat 使用的默认 SSL 端口是什么?
端口 8443 是 Tomcat 使用的默认 SSL 端口。不过,对于 HTTPS 流量,建议使用标准的 443 端口。
如何在 Tomcat 上启用 HTTP/2?
在 server.xml 的 SSL 连接器配置中添加 ALPN 协议。此外,SSL 证书必须使用 EC 密钥,且网站上启用了 HTTPS,才能支持 HTTP/2。
Tomcat SSL 中的客户端证书认证是什么?
这是一种高级 Tomcat SSL 配置,客户端必须出示其证书,并根据信任库进行验证,才能访问服务器。
Tomcat 能把 HTTP 重定向到 HTTPS 吗?
可以通过几种推荐的方法,把 Tomcat 配置为自动把不安全的 HTTP 请求重定向到 HTTPS。