首页云计算正文

腾讯云服务器https设置方法指南：Tomcat服务器SSL证书安装与配置

admin

2025-01-02 2 0条评论

操作场景

本文档指导您如何在 Tomcat 服务器中安装 SSL 证书。

说明：

本文档以证书名称 www.domain.com 为例。

Tomcat 版本以 tomcat7.0.94 为例。

当前服务器的操作系统为 CentOS 7，由于操作系统的版本不同，详细操作步骤略有区别。

前提条件

已准备文件远程拷贝软件，例如 WinSCP（建议从官方网站获取最新版本）。
已准备远程登录工具，例如 PuTTY 或者 Xshell（建议从官方网站获取最新版本）。
已在当前服务器中安装配置 Tomcat 服务。

安装 SSL 证书前需准备的数据如下：

名称	说明
服务器的 IP 地址	服务器的 IP 地址，用于 PC 连接到服务器。
用户名	登录服务器的用户名。
密码	登录服务器的密码。

注意：

在腾讯云官网购买的云服务器，您可以登录云服务器控制台获取服务器 IP 地址、用户名及密码。

当您申请 SSL 证书时选择了“粘贴 CSR” 方式，则不提供 Tomcat 证书文件的下载，需要您通过手动转换格式的方式生成密钥库。其操作方法如下：

访问转换工具。

将 Nginx 文件夹中的证书文件和私钥文件上传至转换工具中，并填写密钥库密码，单击【提交】，转换为 jks 格式证书。

当前 Tomcat 服务器安装在/usr目录下，例如，Tomcat 文件夹名称为tomcat7.0.94。则/usr/*/conf实际为/usr/tomcat7.0.94/conf。

操作步骤

证书安装

已在 SSL 证书管理控制台中下载并解压缩 www.domain.com 证书文件包到本地目录。
解压缩后，可获得相关类型的证书文件。其中包含 Tomcat 文件夹和 CSR 文件：
- 文件夹名称：Tomcat
- 文件夹内容：
  - www.domain.com.jks 密钥库
  - keystorePass.txt 密码文件（若已设置私钥密码，则无 keystorePass.txt 密码文件）
- CSR 文件内容： www.domain.com.csr 文件
  说明：
  CSR 文件是申请证书时由您上传或系统在线生成的，提供给 CA 机构。安装时可忽略该文件。
使用 “WinSCP” （即本地与远程计算机间的复制文件工具）登录 Tomcat 服务器。
将已获取到的 www.domain.com.jks 密钥库文件从本地目录拷贝至 /usr/*/conf 目录下。
远程登录 Tomcat 服务器。例如，使用 “PuTTY” 工具登录。

编辑在 /usr/*/conf 目录下的 server.xml 文件。添加如下内容：

<Connector port="443" protocol="HTTP/1.1" SSLEnabled="true"maxThreads="150" scheme="https" secure="true"#证书保存的路径keystoreFile="/usr/*/conf/www.domain.com.jks" #密钥库密码keystorePass="******"clientAuth="false"/>

详细 server.xml 文件请参考如下内容：

注意：
不建议您直接复制 server.xml 文件内容，避免格式有误。

<?xml version="1.0" encoding="UTF-8"?><Server port="8005" shutdown="SHUTDOWN"> <Listener className="org.apache.catalina.startup.VersionLoggerListener" /> <Listener className="org.apache.catalina.core.AprLifecycleListener" SSLEngine="on" /> <Listener className="org.apache.catalina.core.JreMemoryLeakPreventionListener" /> <Listener className="org.apache.catalina.mbeans.GlobalResourcesLifecycleListener" /> <Listener className="org.apache.catalina.core.ThreadLocalLeakPreventionListener" /><GlobalNamingResources> <Resource name="UserDatabase" auth="Container"           type="org.apache.catalina.UserDatabase"           description="User database that can be updated and saved"           factory="org.apache.catalina.users.MemoryUserDatabaseFactory"           pathname="conf/tomcat-users.xml" /></GlobalNamingResources><Service name="Catalina">     <Connector port="80" protocol="HTTP/1.1" connectionTimeout="20000"  redirectPort="8443" />     <Connector port="443" protocol="HTTP/1.1"            maxThreads="150" SSLEnabled="true" scheme="https" secure="true"            clientAuth="false"             keystoreFile="/usr/*/conf/www.domain.com.jks"             keystorePass="******" /> <Connector port="8009" protocol="AJP/1.3" redirectPort="8443" /><Engine name="Catalina" defaultHost="www.domain.com">   <Realm className="org.apache.catalina.realm.LockOutRealm">     <Realm className="org.apache.catalina.realm.UserDatabaseRealm"            resourceName="UserDatabase"/>   </Realm> <Host name="www.domain.com"  appBase="webapps"      unpackWARs="true" autoDeploy="true" >     <Context path="" docBase ="Knews" /> <Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs"        prefix="localhost_access_log" suffix=".txt"          pattern="%h %l %u %t "%r" %s %b" />   </Host> </Engine></Service></Server>

配置文件的主要参数说明如下：

keystoreFile：密钥库文件的存放位置，可以指定绝对路径，也可以指定相对于 <CATALINA_HOME> （Tomcat安装目录）环境变量的相对路径。如果此项没有设定，默认情况下，Tomcat 将从当前操作系统用户的用户目录下读取名为 “.keystore” 的文件。
keystorePass：密钥库密码，指定 keystore 的密码。申请证书时若设置了私钥密码，请填写私钥密码；若申请证书时未设置私钥密码，请填写 Tomcat 文件夹中 keystorePass.txt 文件的密码。
clientAuth：如果设为 true，表示 Tomcat 要求所有的 SSL 客户出示安全证书，对 SSL 客户进行身份验证。

确认 Tomcat 服务器是否启动。
- 若已启动，您需要在 /usr/*/bin 目录下依次执行以下命令，关闭和重启 Tomcat 服务器。
```
./shutdown.sh  (关闭 Tomcat 服务器)./startup.sh   (启动 Tomcat 服务器)
```
- 若未启动，您需要在 /usr/*/bin 目录下执行以下命令，启动 Tomcat 服务器。
```
./startup.sh
```
若启动成功，即可使用 https://www.domain.com 进行访问。

HTTP 自动跳转 HTTPS 的安全配置（可选）

若您不了解通过 HTTPS 访问网站的方式，可以通过配置服务器，让其自动将 HTTP 的请求重定向到 HTTPS。您可以通过以下操作设置：

编辑 /usr/*/conf 目录下的 web.xml 文件，找到 </welcome-file-list> 标签。

在 </welcome-file-list> 下面换行，并添加以下内容：

<login-config> <!-- Authorization setting for SSL --> <auth-method>CLIENT-CERT</auth-method> <realm-name>Client Cert Users-only Area</realm-name> </login-config> <security-constraint> <!-- Authorization setting for SSL --> <web-resource-collection> <web-resource-name>SSL</web-resource-name> <url-pattern>/*</url-pattern> </web-resource-collection> <user-data-constraint> <transport-guarantee>CONFIDENTIAL</transport-guarantee> </user-data-constraint> </security-constraint>

编辑 /usr/*/conf 目录下的 server.xml 文件，将 redirectPort 参数修改为 SSL 的 connector 的端口，即8443端口修改为443端口。如下所示：
```
<Connector port="80" protocol="HTTP/1.1"connectionTimeout="20000"redirectPort="443" />
```
说明：
此修改操作可将非 SSL 的 connector 可以跳转到 SSL 的 connector 中。
在/usr/*/bin 目录下执行以下命令，关闭 Tomcat 服务器。
```
./shutdown.sh
```
执行以下命令，确认配置是否存在问题。
```
./configtest.sh
```
- 若存在，请您重新配置或者根据提示修改存在问题。
- 若不存在，请执行下一步。
执行以下命令，启动 Tomcat 服务器，即可使用http://www.domain.com进行访问。
```
./startup.sh
```