## 证书安装指引 https://cloud.tencent.com/document/product/400/4143 # 证书安装指引 最近更新时间:2018-12-12 16:26:09 [查看pdf](https://main.qcloudimg.com/raw/document/product/pdf/400_4141_cn.pdf) * 1\. Apache 2.x 证书部署] * 2\. Nginx 证书部署 * 3\. IIS 证书部署] * 4\. Tomcat 证书部署 下载得到的`www.domain.com.zip`文件,解压获得3个文件夹,分别是 Apache、IIS、Nginx 服务器的证书文件。 下面提供了4类服务器证书安装方法的示例: ### 1\. Apache 2.x 证书部署 #### 1.1 获取证书 Apache文件夹内获得证书文件`1_root_bundle.crt`,`2_www.domain.com_cert.crt`和私钥文件`3_www.domain.com.key`。 `1_root_bundle.crt`文件包括一段证书代码 “-----BEGIN CERTIFICATE-----” 和 “-----END CERTIFICATE-----”, `2_www.domain.com_cert.crt`文件包括一段证书代码 “-----BEGIN CERTIFICATE-----” 和 “-----END CERTIFICATE-----”, `3_www.domain.com.key`文件包括一段私钥代码 “-----BEGIN RSA PRIVATE KEY-----” 和 “-----END RSA PRIVATE KEY-----”。 #### 1.2 证书安装 1)编辑 Apache 根目录下 conf/d.conf 文件,找到`#LoadModule ssl_module modules/mod_ssl.so`和`#Include conf/extra/httpd-ssl.conf`,去掉代码前面的`#`号。 2)编辑 Apache 根目录下 conf/extra/httpd-ssl.conf 文件,修改成如下内容: ~~~ <VirtualHost 0.0.0.0:443> DocumentRoot "/var/www/html" ServerName www.domain.com SSLEngine on SSLCertificateFile /usr/local/apache/conf/2_www.domain.com_cert.crt SSLCertificateKeyFile /usr/local/apache/conf/3_www.domain.com.key SSLCertificateChainFile /usr/local/apache/conf/1_root_bundle.crt </VirtualHost> ~~~ 配置完成后,重启 Apache 即可使用`https://www.domain.com`来访问。 相关参数说明如下: | 配置文件参数 | 说明 | | --- | --- | | SSLEngine on | 启用 SSL 功能 | | SSLCertificateFile | 证书文件 | | SSLCertificateKeyFile | 私钥文件 | | SSLCertificateChainFile | 证书链文件 | ### 2\. Nginx 证书部署 #### 2.1 获取证书 Nginx 文件夹内获得 SSL 证书文件`1_www.domain.com_bundle.crt`和私钥文件`2_www.domain.com.key`。 `1_www.domain.com_bundle.crt`文件包括两段证书代码 “-----BEGIN CERTIFICATE-----” 和 “-----END CERTIFICATE-----”, `2_www.domain.com.key`文件包括一段私钥代码 “-----BEGIN RSA PRIVATE KEY-----” 和 “-----END RSA PRIVATE KEY-----”。 #### 2.2 证书安装 将域名`www.domain.com`的证书文件`1_www.domain.com_bundle.crt`、私钥文件`2_www.domain.com.key`保存到同一个目录,例如 /usr/local/nginx/conf 目录下。 修改 Nginx 根目录下 conf/nginx.conf 文件,内容如下: ~~~ server { listen 443; server_name www.domain.com; #填写绑定证书的域名 ssl on; ssl_certificate 1_www.domain.com_bundle.crt; ssl_certificate_key 2_www.domain.com.key; ssl_session_timeout 5m; ssl_protocols TLSv1 TLSv1.1 TLSv1.2; #按照这个协议配置 ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:HIGH:!aNULL:!MD5:!RC4:!DHE;#按照这个套件配置 ssl_prefer_server_ciphers on; location / { root html; #站点目录 index index.html index.htm; } } ~~~ 配置完成后,请先执行命令`bin/nginx –t`测试 Nginx 配置是否有误。若无报错,重启 Nginx 之后,即可使用`https://www.domain.com`来访问。 相关参数说明如下: | 配置文件参数 | 说明 | | --- | --- | | listen 443 | SSL 访问端口号为 443 | | ssl on | 启用 SSL 功能 | | ssl\_certificate | 证书文件 | | ssl\_certificate\_key | 私钥文件 | | ssl\_protocols | 使用的协议 | | ssl\_ciphers | 配置加密套件,写法遵循 openssl 标准 | #### 2.3 使用全站加密,HTTP 自动跳转 HTTPS(可选) 对于用户不知道网站可以进行 HTTPS 访问的情况下,让服务器自动把 HTTP 的请求重定向到 HTTPS。 在服务器这边的话配置的话,可以在页面里加 js 脚本,也可以在后端程序里写重定向,当然也可以在 web 服务器来实现跳转。Nginx 是支持 rewrite 的(只要在编译的时候没有去掉 pcre) 在 HTTP 的 server 里增加`rewrite ^(.*) https://$host$1 permanent;` 这样就可以实现 80 进来的请求,重定向为 HTTPS 了。 ### 3\. IIS 证书部署 #### 3.1 获取证书 IIS 文件夹内获得SSL证书文件`www.domain.com.pfx`。 #### 3.2 证书安装 1、打开 IIS 服务管理器,单击计算机名称,双击 “服务器证书”。 ![3.2.1](https://mccdn.qcloud.com/static/img/6d7b25b42c493bfd9d9d871b00c67398/image.png) 2、双击打开服务器证书后,单击右则的导入。 ![3.2.2](https://mccdn.qcloud.com/static/img/9fbedac0a2c160c72f0ef95bfaca9e18/image.png) 3、选择证书文件,如果输入申请证书时有填写私钥密码需要输入密码,否则输入文件夹中密码文件 keystorePass.txt 的密码内容,单击确定。具体操作请[参考私钥密码指引](https://cloud.tencent.com/doc/product/400/4461)。 ![3.2.3](https://mccdn.qcloud.com/static/img/77fdc7cd57281b03d41a19c81af1158d/image.png) 4、单击网站下的站点名称,单击右则的绑定。 ![3.2.4](https://mccdn.qcloud.com/static/img/6c7eee199d1da5d141942af170022a09/image.png) 5、打开网站绑定界面后,单击添加。 ![3.2.5](https://mccdn.qcloud.com/static/img/58e4ee6bb90307fbe1a238ebf818ff9b/image.png) 6、添加网站绑定内容:选择类型为 HTTPS,端口443和指定对应的 SSL 证书,单击确定。 ![3.2.6](https://mccdn.qcloud.com/static/img/813256e938d26fb71d3223cf1eb6082b/image.png) 7、添加完成后,网站绑定界面将会看到刚刚添加的内容。 ![3.2.7](https://mccdn.qcloud.com/static/img/0748888723acf5671ba9a1ed7ef9ebd2/image.png) ### 4\. Tomcat 证书部署 #### 4.1 获取证书 如果申请证书时有填写私钥密码,下载可获得 Tomcat 文件夹,其中有密钥库`www.domain.com.jks`。 如果没有填写私钥密码,证书下载包的 Tomcat 文件夹中包括密钥库文件`www.domain.com.jks`与密钥库密码文件`keystorePass.txt`。 当用户选择粘贴 CSR 时,不提供 Tomcat 证书文件的下载,需要用户手动转换格式生成,操作方法如下: > 可以通过 Nginx 文件夹内证书文件和私钥文件生成jks格式证书 > 转换工具:https://www.trustasia.com/tools/cert-converter.htm > 使用工具时注意填写**密钥库密码**,安装证书时配置文件中需要填写。 #### 4.2 证书安装 配置SSL连接器,将`www.domain.com.jks`文件存放到 conf 目录下,然后配置同目录下的`server.xml`文件: ~~~ <Connector port="443" protocol="HTTP/1.1" SSLEnabled="true" maxThreads="150" scheme="https" secure="true" keystoreFile="conf/www.domain.com.jks" keystorePass="changeit" clientAuth="false" sslProtocol="TLS" /> ~~~ > 说明: > > 如需更多帮助,请查看[Tomcat 官方指导文档](https://tomcat.apache.org/tomcat-7.0-doc/ssl-howto.html)。 相关参数说明如下: | 配置文件参数 | 说明 | | --- | --- | | clientAuth | 如果设为 true,表示 Tomcat 要求所有的 SSL 客户出示安全证书,对 SSL 客户进行身份验证 | | keystoreFile | 指定 keystore 文件的存放位置,可以指定绝对路径,也可以指定相对于 (Tomcat安装目录)环境变量的相对路径。如果此项没有设定,默认情况下,Tomcat 将从当前操作系统用户的用户目录下读取名为 “.keystore” 的文件。 | | keystorePass | 密钥库密码,指定 keystore 的密码。(如果申请证书时有填写私钥密码,密钥库密码即私钥密码,否则填写密钥库密码文件中的密码) | | sslProtocol | 指定套接字(Socket)使用的加密/解密协议,默认值为 TLS | #### 4.3 HTTP 自动跳转 HTTPS 的安全配置 找到 conf 目录下的 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>SSL</web-resource-name> <url-pattern>/*</url-pattern> </web-resource-collection> <user-data-constraint> <transport-guarantee>CONFIDENTIAL</transport-guarantee> </user-data-constraint> </security-constraint> ~~~ 为了让非 SSL 的 connector 可以跳转到 SSL 的 connector 中,还需要前往 server.xml 进行配置: ~~~ <Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="443" /> ~~~ redirectPort 改成 SSL 的 connector 的端口443,重启后便会生效。