使用 CLI 执行密钥管理操作-仅限标准套餐

IBM Cloud® Hyper Protect Crypto Services 标准套餐与 IBM Key Protect 命令行界面 (CLI) 插件集成，以便您可以使用 IBM Key Protect CLI 插件来创建，导入和管理加密 根密钥A symmetric wrapping key that is used for encrypting and decrypting other keys that are stored in a data service. 和标准密钥。

目前，仅标准套餐支持使用 CLI 执行密钥管理操作。 您仍可以通过 UI 或 API 使用 Unified Key Orchestrator 对 Hyper Protect Crypto Services 执行密钥管理操作。

在通过 Hyper Protect Crypto Services 实例 (简称服务实例) 使用 Key Protect CLI 之前，需要执行以下步骤:

1. 安装 IBM Key Protect CLI 插件。

2. 在工作站上设置 KP_PRIVATE_ADDR 环境变量:

   • 在 Linux 操作系统或 macOS上，运行以下命令:

     export KP_PRIVATE_ADDR=<URL>
     

     在此命令中，URL 是 Key management endpoint URL。 您可以通过 概述 > 连接 > 密钥管理端点 URL 从供应的服务实例仪表板获取端点。 或者，您可以使用 API 调用动态 检索 API 端点 URL。 例如

     export KP_PRIVATE_ADDR="https://<INSTANCE_ID>.api.us-south.hs-crypto.appdomain.cloud"
     

     要了解 Hyper Protect Crypto Services 支持的区域，请参阅区域和位置。

   • 在 Windows 操作系统上的 控制面板中，在搜索框中输入 environment variable 以找到“环境变量”窗口。 创建 KP_PRIVATE_ADDR 环境变量，并将值设置为所供应 UI 的 管理 选项卡上显示的端点。 例如，https://<INSTANCE_ID>.api.us-south.hs-crypto.appdomain.cloud。

   您也可以通过 API 来检索端点 URL。 有关详细信息，请 查看 Hyper Protect Crypto Services 密钥管理服务 API 参考文档。

   根据您使用的是公共端点还是专用端点，选择相应的端点 URL 来设置 KP_PRIVATE_ADDR 环境变量的值。

3. 在工作站上设置 KP_INSTANCE_ID 环境变量:

   • 在 Linux 操作系统或 macOS上，运行以下命令:

     export KP_INSTANCE_ID=<instance_ID>
     

     在此命令中，instance_ID 显示在供应的 UI 的 管理 选项卡上。instance_ID 采用通用唯一标识 (UUID) 格式。

   • 在 Windows上的 控制面板中，在搜索框中输入 environment variable 以找到“环境变量”窗口。 创建 KP_INSTANCE_ID 环境变量，并将值设置为显示在已供应 Hyper Protect Crypto Services 仪表板的管理选项卡上的实例标识值。

   或者，可以使用 ibmcloud kp 命令上的 -i <instance_ID> 选项来设置实例标识。

4. 运行特定命令以执行密钥管理操作。 有关命令的完整列表，请查看 密钥管理 CLI 参考。

5. 将 Key Protect CLI 插件 升级到最新版本以启用新功能部件。

6. (可选) 如果不再需要该插件，那么可以 卸载 Key Protect CLI 插件。