JBoss 服务器 SSL 证书安装部署
本文档指导您如何在 JBoss 服务器中安装 SSL 证书。
说明:
本文档以证书名称 www.huweissl.com 为例。
JBoss 版本以 jboss-7.1.1 为例。
当前服务器的操作系统为 CentOS 7,由于操作系统的版本不同,详细操作步骤略有区别。
安装 SSL 证书前,请您在 JBoss 服务器上开启 “443” 端口,避免证书安装后无法启用 HTTPS。
已准备文件远程拷贝软件,例如 WinSCP(建议从官方网站获取最新版本)。
已准备远程登录工具,例如 PuTTY 或者 Xshell(建议从官方网站获取最新版本)。
已在当前服务器中安装配置 JBoss 服务。
安装 SSL 证书前需准备的数据如下:
名称 | 说明 |
服务器的 IP 地址 | 服务器的 IP 地址,用于 PC 连接到服务器。 |
用户名 | 登录服务器的用户名。 |
密码 | 登录服务器的密码。 |
已在 护卫SSL会员中心 中下载并解压缩 www.huweissl.com 证书文件包到本地目录。
解压缩后,可获得相关类型的证书文件。其中包含 Jboss文件夹和 CSR 文件:
文件夹名称:Jboss
文件夹内容:
www.huweissl.com.jks 密钥库
keystorePass.txt 密码文件(若已设置私钥密码,则无 keystorePass.txt 密码文件)
CSR 文件内容: www.huweissl.com.csr 文件
说明:CSR 文件是申请证书时由您上传或系统在线生成的,提供给 CA 机构。安装时可忽略该文件。
远程登录 JBoss 服务器。例如,使用 “PuTTY” 工具 登录。
进入部署证书步骤,在 /usr/local/jboss-7.1.1/standalone/configuration 目录下执行命令 mkdir cert创建 cert 文件夹。
使用 “WinSCP” (即本地与远程计算机间的复制文件工具)登录 JBoss 服务器,将已获取到的 www.huweissl.com.jks 密钥库文件从本地目录拷贝至 cert 文件夹。
编辑在 /usr/local/jboss-7.1.1/standalone/configuration 目录下的 standalone.xml 文件。修改端口配置,如下所示:
第一部分:
<interfaces>
<interface name="management">
<inet-address value="${jboss.bind.address.management:127.0.0.1}"/>
</interface>
<!--开启远程访问-->
<interface name="public">
<inet-address value="${jboss.bind.address:0.0.0.0}"/>
</interface>
<interface name="unsecure">
<inet-address value="${jboss.bind.address.unsecure:127.0.0.1}"/>
</interface></interfaces><socket-binding-group name="standard-sockets" default-interface="public" port-offset="${jboss.socket.binding.port-offset:0}">
<socket-binding name="management-native" interface="management" port="${jboss.management.native.port:9999}"/>
<socket-binding name="management-http" interface="management" port="${jboss.management.http.port:9990}"/>
<socket-binding name="management-https" interface="management" port="${jboss.management.https.port:9443}"/>
<socket-binding name="ajp" port="8009"/>
<!--修改http端口-->
<socket-binding name="http" port="80"/>
<!--修改https端口-->
<socket-binding name="https" port="443"/>
<socket-binding name="osgi-http" interface="management" port="8090"/>
<socket-binding name="remoting" port="4447"/>
<socket-binding name="txn-recovery-environment" port="4712"/>
<socket-binding name="txn-status-manager" port="4713"/>
<outbound-socket-binding name="mail-smtp">
<remote-destination host="localhost" port="25"/>
</outbound-socket-binding></socket-binding-group>
配置文件的主要调整说明如下:
开启远程访问:将 ${jboss.bind.address:127.0.0.1} 调整为 ${jboss.bind.address:0.0.0.0}。
修改 http 端口:将8080端口调整为80。
修改 https 端口:将8443端口调整为443。
第二部分:添加证书相关配置。
<subsystem xmlns="urn:jboss:domain:web:1.1" default-virtual-server="default-host" native="false">
<connector name="http" protocol="HTTP/1.1" scheme="http" socket-binding="http"/>
<connector name="https" protocol="HTTP/1.1" scheme="https" socket-binding="https" secure="true">
<ssl name="https" password="******" certificate-key-file="../standalone/configuration/cert/www.huweissl.com.jks" cipher-suite="TLS_RSA_WITH_AES_256_CBC_SHA,TLS_DHE_RSA_WITH_AES_256_CBC_SHA,TLS_DHE_DSS_WITH_AES_128_CBC_SHA,SSL_RSA_WITH_3DES_EDE_CBC_SHA,SSL_DHE_RSA_WITH_3DES_EDE_CBC_SHA,SSL_DHE_DSS_WITH_3DES_EDE_CBC_SHA" protocol="TLSv1,TLSv1.1,TLSv1.2"/>
</connector>
<virtual-server name="default-host" enable-welcome-root="true">
<alias name="localhost"/>
<alias name="example.com"/>
</virtual-server>
</subsystem>
进入 /usr/local/jboss-7.1.1/bin 目录下,执行启动命令 ./standalone.sh,确保正常启动。如下图所示:
证书已部署完成,即可使用 https://www.huweissl.com 访问。
注意:
操作过程如果出现问题,请您 联系我们。