本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
使用本主题将您的 AWS CloudHSM PKCS#11 库从客户端 SDK 3 迁移到客户端 SDK 5。有关迁移的好处,请参阅 AWS CloudHSM 客户 SDK 5 的好处。
在中 AWS CloudHSM,客户应用程序使用 AWS CloudHSM 客户端软件开发套件 (SDK) 执行加密操作。客户端 SDK 5 SDK 是继续添加新功能和平台支持的主要客户端。
要查看所有提供程序的迁移说明,请参阅从 AWS CloudHSM 客户端 SDK 3 迁移到客户端 SDK 5。
通过解决重大更改做好准备
查看这些重大更改,并在开发环境中相应地更新您的应用程序。
包装机制已更改
客户端 SDK 3 机制 | 等效客户端 SDK 5 机制 |
---|---|
|
|
|
|
|
|
|
|
|
|
ECDH
在客户端 SDK 3 中,您可以使用ECDH并指定KDF。此功能目前在客户端 SDK 5 中不可用。如果您的应用程序需要此功能,请联系支持人员
密钥句柄现在是特定于会话的
要在客户端 SDK 5 中成功使用密钥句柄,每次运行应用程序时都必须获取密钥句柄。如果您希望现有应用程序在不同的会话中使用相同的密钥句柄,则您必须修改代码以在每次运行应用程序时获得密钥句柄。有关检索密钥句柄的信息,请参阅此 AWS CloudHSM PKCS #11 示例
迁移到客户端 SDK 5
按照本节中的说明从客户端 SDK 3 迁移到客户端 SDK 5。
注意
客户端 5 目前不支持亚马逊 Linux、Ubuntu 16.04、Ubuntu 18.04、CentOS 6、CentOS 8 和 6。RHEL SDK如果您当前在客户端 SDK 3 上使用其中一个平台,则在迁移到客户端 SDK 5 时需要选择其他平台。
-
卸载客户端 SDK 3 的 PKCS #11 库。
$
sudo yum remove cloudhsm-client-pkcs11
-
卸载客户端 SDK 3 的客户端守护程序。
$
sudo yum remove cloudhsm-client
注意
需要再次启用自定义配置。
-
按照中的步骤安装客户端 SDK PKCS #11 库为 AWS CloudHSM 客户端 SDK 5 安装 PKCS #11 库 。
-
客户端 SDK 5 引入了新的配置文件格式和命令行引导工具。要引导您的 Client SDK 5 PKCS #11 库,请按照下方的引导客户端 SDK用户指南中列出的说明进行操作。
-
在您的开发环境中,测试您的应用程序。在最终迁移之前,更新现有代码以解决重大更改。