管理HSM凭证 managing-hsm-credentials

从“信任存储区管理”页面,您可以管理Hardware Security Module (HSM)凭据。 HSM是第三方PKCS#11设备,可用于安全生成和存储私钥。 HSM可物理保护对私钥的访问和使用。

客户端软件需要与HSM进行通信。 必须在与AEM Forms相同的计算机上安装和配置HSM客户端软件。

AEM forms Digital Signatures可以使用存储在HSM上的凭据来应用服务器端数字签名。 按照本节中的说明为Digital Signatures将使用的每个HSM凭据创建别名。 别名包含HSM所需的所有参数。

NOTE
更改HSM配置后,重新启动AEM Forms服务器。

在HSM设备联机时创建HSM凭据的别名 create-an-alias-for-an-hsm-credential-when-the-hsm-device-is-online

  1. 在管理控制台中,单击“设置”>“信任存储区管理”>“HSM凭据”,然后单击“添加”。

  2. 在“配置文件名称”框中,键入用于标识别名的字符串。 此值用作某些数字签名操作(如“签名签名字段”操作)的属性。

  3. 在“PKCS11库”框中,键入服务器上HSM客户端库的完全限定路径。 例如,c:\Program Files\LunaSA\cryptoki.dll。在群集环境中,此路径对于群集中的所有服务器必须相同。

  4. 单击“测试HSM连通性”。 如果AEM Forms能够连接到HSM设备,则会显示一条消息,说明HSM可用。 单击“下一步”。

  5. 使用令牌名称、插槽ID或插槽列表索引来标识凭据在HSM上的存储位置。

    • 令牌名称: 对应于要使用的HSM分区的名称(例如HSMPART1)。
    • 插槽ID: 插槽ID是数据类型为long的插槽标识符。
    • 插槽列表索引: 如果选择“槽列表索引”,请将“槽信息”设置为与槽相对应的整数。 这是一个基于0的索引,这意味着如果客户端首先在HSMPART1分区中注册,则使用SlotListIndex值0引用HSMPART1。
  6. 在“令牌固定”框中,键入访问HSM密钥所需的密码,然后单击“下一步”。

  7. 在“凭据”框中,选择一个凭据。 单击“保存”。

在HSM设备脱机时创建HSM凭据的别名 create-an-alias-for-an-hsm-credential-when-the-hsm-device-is-offline

  1. 在管理控制台中,单击“设置”>“信任存储区管理”>“HSM凭据”,然后单击“添加”。

  2. 在“配置文件名称”框中,键入用于标识别名的字符串。 此值用作某些数字签名操作(如“签名签名字段”操作)的属性。

  3. 在“PKCS11库”框中,键入服务器上HSM客户端库的完全限定路径。 例如,c:\Program Files\LunaSA\cryptoki.dll。在群集环境中,此路径对于群集中的所有服务器必须相同。

  4. 选中Offline Profile Creation复选框。 单击“下一步”。

  5. 在HSM设备列表中,选择存储凭据的HSM设备的制造商。

  6. 在“插槽类型”列表中,选择“插槽ID”、“插槽索引”或“令牌名称”,然后在“插槽信息”框中指定一个值。 AEM Forms使用这些设置来确定凭据在HSM中的存储位置。

    • 令牌名称: 对应于分区名称(例如HSMPART1)。

    • 插槽ID: 插槽ID是对应于插槽的整数,该整数又对应于分区。 例如,客户端(Forms Server)首先在HSMPART1分区中注册。 这会将插槽1映射到此客户端的HSMPART1分区。 由于HSMPART1是第一个注册的分区,因此插槽ID为1,您应该将插槽信息设置为1。

      插槽ID是逐个客户端设置的。 如果您将另一台计算机注册到不同的分区(例如,同一HSM设备上的HSMPART2),则插槽1将与该客户端的HSMPART2分区相关联。

    • 插槽索引: 如果选择“槽索引”,请将“槽信息”设置为与槽相对应的整数。 这是一个基于0的索引,这意味着如果客户端首先在HSMPART1分区中注册,则插槽1将映射到该客户端的HSMPART1。 由于HSMPART1是第一个注册的分区,因此插槽索引为0。

  7. 选择以下选项之一,并提供路径:

    • 证书:(如果使用SHA1,则不需要)单击浏览并找到要使用的凭据的公共密钥的路径。
    • 证书SHA1: (如果使用物理证书,则不需要)为正在使用的凭据键入公钥(.cer)文件的SHA1值(指纹)。 确保SHA1值中没有使用空格。
  8. 在“密码”框中,键入访问给定插槽信息的HSM密钥所需的密码,然后单击“保存”。

查看HSM凭据别名属性 view-hsm-credential-alias-properties

  1. 在管理控制台中,单击“设置”>“信任存储区管理”>“HSM凭据”。
  2. 单击凭据别名的别名以查看属性,然后单击确定。

检查HSM凭据的状态 check-the-status-of-an-hsm-credential

  1. 在管理控制台中,单击“设置”>“信任存储区管理”>“HSM凭据”。
  2. 单击要检查的凭据旁边的复选框,然后单击检查状态。

状态列反映凭据的当前状态。 如果发生故障,“状态”列中将显示一个红色的X。 将鼠标悬停在X上可显示包含失败原因的工具提示。

更新HSM凭据别名属性 update-hsm-credential-alias-properties

  1. 在管理控制台中,单击“设置”>“信任存储区管理”>“HSM凭据”。
  2. 单击凭据别名的别名。
  3. 单击更新凭据,并根据需要更新设置。

重置所有HSM连接 reset-all-hsm-connections

在Forms服务器与HSM设备之间的网络会话出现任何中断后,重置与HSM设备的开放连接。 例如,由于网络中断或HSM设备因软件更新而脱机,可能会发生中断。 中断后,现有连接将过时,针对这些连接的任何签名请求都将失败。 使用“重置所有HSM连接”选项可清除旧连接。

  1. 在管理控制台中,单击“设置”>“信任存储区管理”>“HSM凭据”。
  2. 单击“重置所有HSM连接”。

删除HSM凭据别名 delete-an-hsm-credential-alias

  1. 在管理控制台中,单击“设置”>“信任存储区管理”>“HSM凭据”。
  2. 选中要删除的HSM凭据的复选框,单击“删除”,然后单击“确定”。

配置远程HSM支持 configure-remote-hsm-support

AEM Forms使用基于Web服务的IPC/RPC机制。 此机制使AEM表单能够使用安装在远程计算机上的HSM。 要使用此功能,请在安装HSM的远程计算机上安装Web服务。 请参阅 在Windows 64位平台上使用Sun JDK配置AEM Forms ES的HSM支持以了解更多信息。

此机制不支持在线创建HSM配置文件或进行状态检查。 但是,可通过两种方式创建HSM配置文件和执行状态检查:

  • 通过传递签名者证书来创建AEM Forms客户端凭据。 请按照中的步骤操作 在Windows 64位平台上使用Sun JDK配置AEM Forms ES的HSM支持. Web服务位置作为Credential属性传入。 还支持使用证书或证书SHA-1十六进制创建离线HSM配置文件。 但是,如果您已从早期版本的AEM表单升级到AEM表单,则进行客户端更改,因为凭据包含证书和Web服务信息。
  • Web服务位置在Signature服务的管理控制台中指定。 (请参阅 签名服务设置.) 在此,客户端仅携带信任存储区中HSM配置文件的别名。 即使您从早期版本的AEM表单升级到AEM表单,也可以无缝地使用此选项,而无需进行任何客户端更改。 此选项不支持使用证书SHA-1的HSM配置文件。
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2