为JBoss应用程序服务器配置SSL

注意

AEM 6.4已结束扩展支持,本文档将不再更新。 有关更多详细信息,请参阅 技术支助期. 查找支持的版本 此处.

要在JBoss应用程序服务器上配置SSL,您需要SSL凭据进行身份验证。 您可以使用Java密钥工具创建凭据或请求,并从证书颁发机构(CA)导入凭据。 然后,必须在JBoss上启用SSL。

您可以使用包含创建密钥库所需的所有信息的单个命令来运行密钥工具。

在此过程中:

  • [appserver root] 是运行AEM表单的应用程序服务器的主目录。
  • [type] 文件夹名称会因您执行的安装类型而异。

创建SSL凭据

  1. 在命令提示符下,导航到 [JAVA主页]/bin并键入以下命令以创建凭据和密钥库:

    keytool -genkey -dname "CN=主机名 , OU=群组名称 , O=公司名称 ,L=城市名称 , S= , C=国家/地区代码” -alias "AEMForms Cert" -keyalg RSA -keypasskey_password -keystore密钥重命名 .keystore

    注意

    替换 [JAVA_HOME] 使用安装JDK的目录,并将斜体文本替换为与您的环境对应的值。 主机名是应用程序服务器的完全限定的域名。

  2. 输入 keystore_password 提示输入密码时。 密钥库和密钥的密码必须相同。

    注意

    keystore_password 在此步骤输入的密码可能与您在步骤1中输入的密码(key_password)相同,或者可能不同。

  3. 复制 密钥重命名.keystore到 [appserver root]/server/[type]/conf 目录,方法是键入以下命令之一:

    • (Windows单服务器) copy keystorename.keystore[appserver root]\standalone\configuration
    • (Windows服务器群集)副本 keystorename.keystore[appserver root]\domain\configuration
    • (Linux单服务器) cp keystorename.keystore [appserver root]/standalone/configuration
    • (Linux服务器群集) cp <em>keystorename</em>.keystore<em>[appserver root]</em>/domain/configuration
  4. 通过键入以下命令导出证书文件:

    • (单台服务器) keytool -export -alias "AEMForms Cert" -file AEMForms_cert.cer -keystore [appserver root]/standalone/configuration/keystorename.keystore
    • (服务器群集) keytool -export -alias "AEMForms Cert" -file AEMForms_cert.cer -keystore [appserver root]/domain/configuration/keystorename.keystore
  5. 输入 keystore_password 提示输入密码时。

  6. 将AEMForms_cert.cer文件复制到 [appserver根] \conf 目录,方法是键入以下命令:

    • (Windows单服务器) copy AEMForms_cert.cer [appserver root]\standalone\configuration
    • (Windows服务器群集) copy AEMForms_cert.cer [appserver root]\domain\configuration
    • (Linux单服务器) cp AEMForms _cert.cer [appserver root]\standalone\configuration
    • (Linux服务器群集) cp AEMForms _cert.cer [appserver root]\domain\configuration
  7. 通过键入以下命令查看证书的内容:

    • keytool -printcert -v -file [appserver root]\standalone\configuration\AEMForms_cert.cer
    • keytool -printcert -v -file [appserver root]\domain\configuration\AEMForms_cert.cer
  8. 提供对 [JAVA_HOME]\jre\lib\security(如果需要)执行以下任务:

    • (Windows)右键单击缓存文件并选择“属性”,然后取消选择“只读”属性。
    • (Linux)类型 chmod 777 cacerts
  9. 通过键入以下命令导入证书:

    keytool -import -alias “AEMForms Cert” -fileAEMForms_cert .cer -keystoreJAVA_HOME \jre\lib\security\cacerts

  10. 类型 changeit 作为密码。 此密码是Java安装的默认密码,系统管理员可能已更改此密码。

  11. 提示时 Trust this certificate? [no]:,类型 yes. 将显示确认“Certificate was added to keystore”(证书已添加到密钥库)。

  12. 如果您通过Workbench中的SSL连接,请在Workbench计算机上安装证书。

  13. 在文本编辑器中,打开以下文件进行编辑:

    • 单台服务器 — [appserver root]/standalone/configuration/lc_<dbname turnkey="">.xml

    • 服务器群集 — [appserver root]/domain/configuration/host.xml

    • 服务器群集 — [appserver root]/domain/configuration/domain_<dbname>.xml

    • 对于单台服务器, 在lc_<dbaname tunkey="">.xml文件,在 <security-realms> 部分:
    <security-realm name="SSLRealm">
    <server-identities>
    <ssl>
    <keystore path="C:/Adobe/Adobe_Experience_Manager_Forms/jboss/standalone/configuration/aemformses.keystore" keystore-password="changeit" alias="AEMformsCert" key-password="changeit"/>
    </ssl>
    </server-identities>
    </security-realm>
    

    找到 <server> 部分在以下代码之后显示:

    <http-listener name="default" socket-binding="http" redirect-socket="https" max-post-size="104857600"/>

    在 <server> 以下代码后部分:

    <https-listener name="default-secure" socket-binding="https" security-realm="SSLRealm"/>
    
    • 对于服务器群集, 在 [appserver根]\domain\configuration\host.xml在所有节点上,在 <security-realms> 部分:
    <security-realm name="SSLRealm">
    <server-identities>
    <ssl>
    <keystore path="C:/Adobe/Adobe_Experience_Manager_Forms/jboss/standalone/configuration/aemformses.keystore" keystore-password="changeit" alias="AEMForms Cert" key-password="changeit"/>
    </ssl>
    </server-identities>
    </security-realm>
    

    在服务器群集的主节点上, [appserver根]\domain\configuration\domain_<dbname>.xml,找到 <server> 部分在以下代码之后显示:

    <http-listener name="default" socket-binding="http" redirect-socket="https" max-post-size="104857600"/>

    在 <server> 以下代码后部分:

    <https-listener name="default-secure" socket-binding="https" security-realm="SSLRealm"/>
    
  14. 更改 keystoreFile 属性和 keystorePass 属性。

  15. 重新启动应用程序服务器:

    • 对于统包安装:

      • 在Windows控制面板中,单击“管理工具”,然后单击“服务”。
      • 为Adobe Experience Manager表单选择JBoss。
      • 选择操作>停止。
      • 等待服务状态显示为已停止。
      • 选择操作>开始。
    • 对于Adobe预配置或手动配置的JBoss安装:

      • 在命令提示符下,导航到 [appserver root]/bin。

      • 通过输入以下命令停止服务器:

        • (Windows) shutdown.bat -S
        • (Linux) ./shutdown.sh -S
      • 等待JBoss进程完全关闭(当JBoss进程将控制权返回到其启动的终端时)。

      • 输入以下命令以启动服务器:

        • (Windows) run.bat -c <profile>
        • (Linux) ./run.sh -c <profile>
  16. 要使用SSL访问管理控制台,请键入 https://[host name]:[port]/adminui 在web浏览器中:

    JBoss的默认SSL端口为8443。 从此处访问AEM表单时,请指定此端口。

从CA请求凭据

  1. 在命令提示符下,导航到 [JAVA主页]/bin并键入以下命令以创建密钥库和密钥:

    keytool -genkey -dname "CN=主机名 , OU=群组名称 , O=公司名称 , L=城市名称 , S= , C=国家/地区代码" -alias "AEMForms Cert" -keyalg RSA -keypass-key_password -keystore密钥重命名 .keystore

    注意

    替换 [JAVA_HOME] 使用安装JDK的目录,并将斜体文本替换为与您的环境对应的值。

  2. 键入以下命令以生成要发送到证书颁发机构的证书请求:

    keytool -certreq -alias "AEMForms Cert" -keystore密钥重命名 .keystore -fileAEMFormscertRequest.csr

  3. 在您的证书文件请求得到满足后,请完成下一个过程。

使用从CA获取的凭据启用SSL

  1. 在命令提示符下,导航到 [JAVA HOME]/bin并键入以下命令以导入已签署CSR的CA的根证书:

    keytool -import -trustcacerts -file rootcert.pem -keystore keystorename.keystore -alias root

    如果根证书不在浏览器中,则还应将其导入此处。

    注意

    替换 [JAVA_HOME]使用安装JDK的目录,并将斜体文本替换为与您的环境对应的值。

  2. 在命令提示符下,导航到 [JAVA HOME]/bin并键入以下命令以将凭据导入密钥库:

    keytool -import -trustcacerts -fileCACertificateName .crt -keystore密钥重命名 .keystore

    注意
    • 替换 [JAVA_HOME] 使用安装JDK的目录,并将斜体文本替换为与您的环境对应的值。
    • 导入的CA签名证书将替换自签名的公共证书(如果存在)。
  3. 完成创建SSL凭据的步骤13 - 18。

在此页面上