您可以下载并安装已签发的SSL证书到Tomcat服务器。Tomcat服务器支持安装PFX格式和JKS两种格式的证书,您可以根据Tomcat版本选择要下载的证书格式。本文介绍了安装PFX格式证书的具体步骤。
前提条件
已登录您的Tomcat服务器。
您的Tomcat服务器上已经开启了443端口(HTTPS服务的默认端口)。
已下载Tomcat服务器所需要的证书文件。下载证书的具体操作,请参见下载SSL证书到本地。
重要 如果您在提交证书申请时,未将CSR生成方式设置为系统生成,则您下载的证书压缩包中不包含TXT密码文件。您可以选择其他包含密码文件的服务器,下载对应PEM格式证书,并使用证书格式转换工具将您的证书文件转化为PFX格式。转换证书格式的具体操作,请参见证书格式转换。
如遇到问题,请联系产品技术专家进行咨询,详情请参见专家一对一服务。
操作步骤
本文以安装在Linux操作系统中的Tomcat 7为例介绍安装PFX格式证书的具体步骤。
解压已保存到本地的Tomcat证书文件。
解压后您将看到文件夹中有以下文件:
说明
本文中证书名称以domain_name为示例。
每次下载证书都会产生新的密码。该密码仅匹配本次下载的证书。如果需要更新证书文件,同时也要更新匹配的密码。
证书文件(domain_name.pfx)
密码文件(pfx-password.txt)
在Tomcat安装目录下,创建cert目录,将解压的证书和密码文件拷贝到cert目录下。
说明 Tomcat安装目录与您的服务器环境有关。您可以使用sudo find / -name *tomcat*命令,查询Tomcat的安装目录。
修改配置文件server.xml(路径:Tomcat安装目录/conf/server.xml),并保存。
您可以从以下方式中选择一种进行操作:
重要 使用方式一配置SSL连接器时,Tomcat将自动为您选择SSL的实现方式。如果您按照方式一无法完成后续配置,可能是因为您的环境不支持自动选定的SSL实现方式。这种情况下,您可以根据环境属性,使用方式二手动指定SSL的实现方式。
方式一:Tomcat服务器自动选择SSL的实现方式。
修改SSL连接器的属性为以下内容:
放大查看复制代码
<Connector port="443" #port属性根据实际情况修改(HTTPS默认端口为443)。如果使用其他端口号,则您需要使用https://domain_name:port的方式来访问您的网站。 protocol="HTTP/1.1" SSLEnabled="true" scheme="https" secure="true" keystoreFile="Tomcat安装目录/cert/domain_name.pfx" #证书名称前需加上证书的绝对路径,请使用您证书的文件名替换domain_name。 keystoreType="PKCS12" keystorePass="证书密码" #请替换为密码文件pfx-password.txt中的内容。 clientAuth="false" SSLProtocol="TLSv1.1+TLSv1.2+TLSv1.3" ciphers="TLS_RSA_WITH_AES_128_CBC_SHA,TLS_RSA_WITH_AES_256_CBC_SHA,TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA,TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256,TLS_RSA_WITH_AES_128_CBC_SHA256,TLS_RSA_WITH_AES_256_CBC_SHA256"/>
方式二:您手动指定SSL的实现方式。
您可以在server.xml中移除以下代码的注释,即去掉该内容前的井号(#)。指定使用JSSE实现方式:
放大查看复制代码
<Connector protocol="org.apache.coyote.http11.Http11NioProtocol" port="443" maxThreads="200" scheme="https" secure="true" SSLEnabled="true" keystoreFile="Tomcat安装目录/cert/domain_name.pfx" keystorePass="证书密码" clientAuth="false" sslProtocol="TLS"/>
可选:配置web.xml文件,开启HTTP强制跳转HTTPS。
在web.xml文件中追加以下内容:
放大查看复制代码
<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>Web项目名称</web-resource-name> #请将该参数替换为您的项目名称。 <url-pattern>/*</url-pattern> </web-resource-collection> <user-data-constraint> <transport-guarantee>CONFIDENTIAL</transport-guarantee> </user-data-constraint> </security-constraint>
重启Tomcat服务。
执行以下命令,关闭Tomcat服务:
放大查看复制代码
./shutdown.sh
执行以下命令,开启Tomcat服务:
放大查看复制代码
./startup.sh
后续操作
证书安装完成后,您可以通过访问证书绑定域名的方式验证证书是否安装成功:
放大查看复制代码
https://domain_name#请将domain_name替换成证书绑定的域名。
如果网页地址栏出现小锁标志,表示证书已安装成功。
如果无法通过HTTPS正常访问网站,请确认您安装证书的服务器的443端口是否已开启。