在Resin服务器上安装私有证书

前提条件

• 证书已签发且“证书状态”为“已签发”。
• 已下载Tomcat格式的私有证书，具体操作请参见下载证书。
• 申请证书时选择的“证书请求文件”生成方式为“系统生成文件”。

约束条件

• 证书安装前，务必在安装私有证书的服务器上开启“443”端口，同时在安全组增加“443”端口，避免安装后仍然无法启用HTTPS。
• 为了使客户端信任服务器证书，需要将服务器证书的根CA加入到客户端受信任的根证书颁发机构中，详细操作请参见信任根CA。
• 如果一个域名有多个服务器，则每一个服务器上都要部署。
• 待安装证书的服务器上需要运行的域名，必须与证书的域名一一对应，即申请的是哪个域名的证书，则用于哪个域名。否则安装部署后，浏览器将提示不安全。

操作步骤

在Resin服务器上安装私有证书的流程如下所示：

①获取文件 → ②配置Resin → ③效果验证

步骤一：获取文件

在本地解压已下载的Tomcat格式证书文件并获得证书文件“server.jks”和密码文件“keystorePass.txt”。

步骤二：配置Resin

修改配置文件前，请将配置文件进行备份，并建议先在测试环境中进行部署，配置无误后，再在现网环境进行配置，避免出现配置错误导致服务不能正常启动等问题，影响您的业务。

1. （可选）安装Resin。
   如果已安装，则请跳过该步骤。

   1. 登录Resin官网并根据您的系统下载不同的应用程序包。

      本步骤以下载Windows版本的Resin-4.0.38版本为例进行说明。

   2. 解压下载的Resin包。
   3. 进入Resin-4.0.38根目录并找到resin.exe文件。
   4. 运行resin.exe文件，运行期间将出现如图1所示的命令提示符窗口。
      图1 提示窗口
      
   5. 运行完成后，启动浏览器，在Web地址栏中输入Resin默认地址“http://127.0.0.1:8080”，并按“Enter”。

      当界面显示如图2所示时，则表示安装成功。

      图2 登录Resin
      
2. 修改配置文件。
   1. 在Resin安装目录下的“Resin.properties”配置文件（由于Resin版本的不同，配置文件也可能为“resin.xml”文件）中，找到如下参数：

      # specifies the --server in the config file
      # home_server : app-0
      
      # Set HTTP and HTTPS bind address
      # http_address : *
      
      # Set HTTP and HTTPS ports.
      # Use overrides for individual server control, for example: app-0.http : 8081
      app.http          : 8080
      # app.https          : 8443
      
      web.http          : 8080
      # web.https          : 8443

   2. 将“app.https”和“web.https”前的注释符“#”去掉，并将“8443端”口修改为“443”。修改后，如下所示：
      “app.https”、“web.https”：指定服务器要使用的端口号，建议配置为“443”。

      # specifies the --server in the config file
      # home_server : app-0
      
      # Set HTTP and HTTPS bind address
      # http_address : *
      
      # Set HTTP and HTTPS ports.
      # Use overrides for individual server control, for example: app-0.http : 8081
      app.http          : 8080
      app.https          : 443
      
      web.http          : 8080
      web.https          : 443

   3. 找到如下参数，并将“jsse_keystore_tye”、“jsse_keystore_file”和“jsse_keystore_password”三行前的注释符“#”去掉。

      # JSSE certificate configuration
      # Keys are typically stored in the resin configuration directory.
      jsse_keystore_tye : jks
      jsse_keystore_file : cert/server.jks
      jsse_keystore_password : 证书密码

   4. 修改证书相关配置参数，具体配置请参见表1。

      # JSSE certificate configuration
      # Keys are typically stored in the resin configuration directory.
      jsse_keystore_tye : jks
      jsse_keystore_file : cert/server.jks
      jsse_keystore_password : 证书密码

      表1 参数说明

      参数	参数说明
      jsse_keystore_tye	设定Keystore文件的类型，一般都设为jks
      jsse_keystore_file	“server.jks”文件存放路径，绝对路径和相对路径均可。示例：cert/server.jks
      jsse_keystore_password	“server.jks”的密码。填写“keystorePass.txt”文件内的密码。 须知： 如果密码中包含“&”，请将其替换成“&”，以免配置不成功。 示例： 如果keystorePass="Ix6&APWgcHf72DMu"，则修改为keystorePass="Ix6&APWgcHf72DMu"。

   5. 修改完成后保存配置文件。
3. 重启Resin。

效果验证

部署成功后，可在浏览器的地址栏中输入“https://域名”，按“Enter”。

如果浏览器地址栏显示安全锁标识，则说明证书安装成功。