文档中心 SSL 证书 操作指南 证书安装指引

证书安装指引

最近更新时间:2019-05-08 16:42:31

操作场景

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

说明:

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

前提条件

  • 已在 SSL 证书管理控制台 中下载并解压缩 www.domain.com 证书文件包。
    解压缩后,分别获得以下文件夹和 CSR 文件:
    文件夹名称文件夹内容说明
    Apache
    • 1_root_bundle.crt 证书文件
    • 2_www.domain.com.crt 证书文件
    • 3_www.domain.com.key 私钥文件
    适用于 Apache 服务器。
    Nginx
    • 1_www.domain.com_bundle.crt 证书文件
    • 2_www.domain.com.key 私钥文件
    适用于 Nginx 服务器。
    IIS
    • www.domain.com.pfx 证书文件
    • keystorePass.txt 密码文件
    适用于 IIS 服务器。若您在申请 SSL 证书时已设置私钥密码,该文件夹下则无 keystorePass.txt 文件。
    Tomcat
    • www.domain.com.jks 密钥库
    • keystorePass.txt 密码文件
    适用于 Tomcat 服务器。若您在申请 SSL 证书时已设置私钥密码,该文件夹下则无 keystorePass.txt 文件。

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

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

    - www.domain.com.csr 文件 CSR 文件
  • 已准备远程拷贝软件 WinSCP(建议从官方网站获取最新版本)。
  • 已准备远程登录工具 PuTTY 或者 Xshell(建议从官方网站获取最新版本)。

数据

针对 Apache/Nginx 服务器,安装 SSL 证书前需准备的数据如下:

名称 说明 取值样例
服务器的 IP 地址 服务器的 IP 地址,用于 PC 连接到服务器。 192.168.22.10
用户名 登录服务器的用户名。 root
密码 登录服务器的密码。 abc

操作步骤

根据服务器类型的不同,选择不同的操作步骤。

Apache 2.x 证书部署

说明:

以下操作步骤以 CentOS 7 为例,根据操作系统的版本不同,详细操作步骤略有区别。

  1. 使用 “WinSCP” 工具,登录 Apache 服务器。
  2. 将已获取到的 1_root_bundle.crt 证书文件、2_www.domain.com.crt 证书文件以及 3_www.domain.com.key 私钥文件拷贝到 Apache 服务器的 /etc/httpd/ssl 目录下。

    说明:

    若无 /etc/httpd/ssl 目录,可新建。

  3. 关闭 WinSCP 界面。
  4. 使用 “PuTTY” 工具,登录 Apache 服务器。
  5. 找到 LoadModule ssl_module modules/mod_ssl.so(用于加载 SSL 模块)和 Include conf.modules.d/*.conf(用于加载配置 SSL 的配置目录)配置语句,并检验是否被注释。

    说明:

    由于操作系统的版本不同,目录结构也不同,请根据实际操作系统版本进行查找。LoadModule ssl_module modules/mod_ssl.soInclude conf.modules.d/*.conf 配置语句可能配置在以下配置文件中:

    • conf.modules.d 目录下的 00-ssl.conf 配置文件。
    • httpd.conf 配置文件。
    • http-ssl.conf 配置文件。

    若以上配置文件中均未找到 LoadModule ssl_module modules/mod_ssl.soInclude conf.modules.d/*.conf 配置语句,请确认是否已经安装 mod_ssl.so 模块。若未安装 mod_ssl.so 模块,您可通过执行 yum install mod_ssl 命令进行安装。

    • 是,请去掉首行的注释符号(#),并保存配置文件。
    • 否,请执行下一步。
  6. 编辑 /etc/httpd/conf.d 目录下的 ssl.conf 配置文件。修改如下内容:
    <VirtualHost 0.0.0.0:443>
         DocumentRoot "/var/www/html"
         ServerName www.domain.com
         SSLEngine on
         SSLCertificateFile /etc/httpd/ssl/2_www.domain.com_cert.crt
         SSLCertificateKeyFile /etc/httpd/ssl/3_www.domain.com.key
         SSLCertificateChainFile /etc/httpd/ssl/1_root_bundle.crt
    </VirtualHost>
    配置文件的主要参数说明如下:
    • SSLEngine on: 启用 SSL 功能
    • SSLCertificateFile:证书文件的路径
    • SSLCertificateKeyFile:私钥文件的路径
    • SSLCertificateChainFile:证书链文件的路径
  7. 重新启动 Apache 服务器,即可使用 https://www.domain.com 进行访问。

Nginx 证书部署

证书安装

  1. 使用 “WinSCP” 工具,登录 Nginx 服务器。
  2. 将已获取到的1_www.domain.com_bundle.crt 证书文件和 2_www.domain.com.key 私钥文件拷贝到 Nginx 服务器的 /usr/local/nginx/conf 目录下。

    说明:

    若无 /usr/local/nginx/conf 目录,可新建。

  3. 关闭 WinSCP 界面。
  4. 使用 “PuTTY” 工具,登录 Nginx 服务器。
  5. 更新 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;
         }
     }
    配置文件的主要参数说明如下:
    • listen 443:SSL 访问端口号为 443
    • ssl on:启用 SSL 功能
    • ssl_certificate:证书文件
    • ssl_certificate_key:私钥文件
    • ssl_protocols:使用的协议
    • ssl_ciphers:配置加密套件,写法遵循 openssl 标准
  6. 执行以下命令,检验配置是否有误。
    bin/nginx –t
    • 是,请重新配置。
    • 否,重启 Nginx。即可使用 https://www.domain.com 进行访问。

使用全站加密,HTTP 自动跳转 HTTPS(可选)

对于用户不知道网站可以通过 HTTPS 方式访问的情况,我们可以通过配置服务器,让其自动将 HTTP 的请求重定向到 HTTPS。
您可以在页面中添加 JS 脚本,也可以在后端程序中添加重定向,还可以通过 Web 服务器实现跳转。
若您在编译时没有去掉 pcre,Nginx 支持 rewrite 功能。您可在 HTTP 的 server 中增加 rewrite ^(.*) https://$host$1 permanent;,即可将80端口的请求重定向为 HTTPS。

IIS 证书部署

  1. 打开 IIS 服务管理器,选择计算机名称,双击打开 “服务器证书”。如下图所示:
    3.2.1
  2. 在服务器证书窗口的右侧“操作”栏中,单击【导入】。如下图所示:
    3.2.2
  3. 在弹出的“导入证书”窗口中,选择证书文件存放路径,输入密码,单击【确定】。

    说明:

    申请证书时若设置了私钥密码,输入密码时,请输入私钥密码。若申请证书时未设置私钥密码,输入密码时,请输入 IIS 文件夹中 keystorePass.txt 文件的密码。具体操作请参考 私钥密码指引

    3.2.3
  4. 选择网站下的站点名称,并单击右侧“操作”栏的【绑定】。如下图所示:
    3.2.4
  5. 在弹出的“网站绑定”窗口中,单击【添加】。如下图所示:
    3.2.5
  6. 在“添加网站绑定”的窗口中,将网站类型设置为 https,端口设置为443,并指定对应的 SSL 证书,单击【确定】。如下图所示:
    3.2.6
    添加完成后,即可在“网站绑定”窗口中查看到新添加的内容。如下图所示:
    3.2.7

Tomcat 证书部署

证书安装

  1. 登录 Tomcat 服务器。
  2. 将已获取到的 www.domain.com.jks 密钥库存放至 conf 目录下。
  3. 编辑同目录下的 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" />
    配置文件的主要参数说明如下:
    • clientAuth:如果设为 true,表示 Tomcat 要求所有的 SSL 客户出示安全证书,对 SSL 客户进行身份验证。
    • keystoreFile:指定 keystore 文件的存放位置,可以指定绝对路径,也可以指定相对于 <CATALINA_HOME> (Tomcat安装目录)环境变量的相对路径。如果此项没有设定,默认情况下,Tomcat 将从当前操作系统用户的用户目录下读取名为 “.keystore” 的文件。
    • keystorePass:密钥库密码,指定 keystore 的密码。申请证书时若设置了私钥密码,请填写私钥密码;若申请证书时未设置私钥密码,请填写 Tomcat 文件夹中 keystorePass.txt 文件的密码。
    • sslProtocol:指定套接字(Socket)使用的加密/解密协议,默认值为 TLS。
  4. 重启 Tomcat 服务器,即可使用 https://www.domain.com 进行访问。

HTTP 自动跳转 HTTPS 的安全配置

  1. 打开 conf 目录下的 web.xml 文件,找到 </welcome-file-list> 标签。
  2. </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>
  3. 打开同目录下的 server.xml 文件,将 redirectPort 参数修改为 SSL 的 connector 的端口,即443端口。如下所示:
    <Connector port="8080" protocol="HTTP/1.1"
     connectionTimeout="20000"
     redirectPort="443" />

    说明:

    此修改可将非 SSL 的 connector 可以跳转到 SSL 的 connector 中。

  4. 重启 Tomcat 服务器,即可生效。