更新时间:2024-09-05 GMT+08:00
分享

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

本章节介绍如何将私有证书安装到Resin服务器。

由于服务器系统版本或服务器环境配置不同,在安装私有证书过程中使用的命令或修改的配置文件信息可能会略有不同,云证书管理服务提供的安装证书示例,仅供参考,请以您的实际情况为准。

如果参考文档安装证书后,HTTPS仍然不生效或遇到其他问题,请单击一对一咨询购买SSL证书配置优化服务,联系专业工程师为您排查具体问题。

前提条件

  • 证书已签发且“证书状态”“已签发”
  • 已下载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”

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

相关文档