创建适配器

单个实例最多可创建 200 个适配器。 每个适配器最多可关联 200 个证书。

KMIP 适配器使用 Key Protect 根密钥创建。 如果没有根密钥，请创建一个。

开始之前，请确保您在该实例上拥有 “Manager”角色或“KmipAdapterManager”角色。

创建适配器

1. 在导航菜单中，单击“KMIP适配器”。 如果这是您的第一个适配器，则该表格为空。

2. 单击创建。

3. 在侧边栏中，请提供以下信息：

   • 名称- 输入适配器的名称（2-40个字符）。
   • 描述 （可选）——为适配器输入描述（2-240个字符）。
   • 根密钥- 选择要用于此适配器的根密钥。 根密钥用于加密适配器生成的 KMIP 密钥。 为确保适配器正常工作，您的根密钥必须处于 active 状态。

4. 可选：添加一个公共 TLS 证书，以便相应的私有证书持有者能够通过KMIP适配器与 Key Protect 进行通信。 只有经过授权的证书才能针对您的实例发起 KMIP 协议请求。

   要添加证书：

   1. 单击添加。
   2. 请输入证书的名称。
   3. 请以 PEM 格式输入证书内容，包括 BEGIN CERTIFICATE 和 END CERTIFICATE 标签。
   4. 单击“添加证书”。

   证书关联可能需要几分钟时间。 在 Key Protect 区域中，一个证书只能与一个适配器相关联。

通过KMIP协议管理的资源无法通过 HTTP API访问。

请妥善保管任何已上传证书的私钥。 上传到 KMIP 适配器的任何证书均可执行所有受支持的 KMIP 操作。

查看和更新适配器详细信息

适配器详细信息面板会显示有关适配器的信息，并允许您执行添加证书等操作。

要查看适配器的详细信息：

1. 点击适配器的操作菜单（⋯）。
2. 选择 “详细信息”。

“详细信息”面板显示适配器的名称、描述、相关的 KMIP 对称密钥以及已上传的证书。 您还可以通过此面板上传其他证书。

无法通过控制台删除 KMIP 对称密钥。 要删除键，请使用 命令行界面（CLI）。 只有未处于 Active 状态（状态 1 ）的KMIP对称密钥才能被删除。 如果适配器中包含处于“Active”状态的密钥，则无法删除该适配器。

每个适配器的资源都由一个根密钥进行保护。 无法删除处于活动状态且与适配器关联的根密钥。

每个创建的KMIP对称密钥都算作一个密钥版本，并 收取一个密钥版本的费用。 删除 KMIP 对称密钥的操作是不可逆的。

在应用程序接口中创建和使用 KMIP 适配程序

本节介绍了如何在 API 中使用符合 native_1.0 配置文件的 KMIP 适配器，包括添加和删除 KMIP 客户端证书，以及查看和删除 KMIP 对象。

您可以通过调用 POST 以下端点来创建 KMIP 适配器。

https://<region>.kms.cloud.ibm.com/api/v2/kmip_adapters

对 KMIP 适配器子资源（包括 KMIP 客户端证书和 KMIP 对象）的操作将在以下端点中进行：

https://<region>.kms.cloud.ibm.com/api/v2/kmip_adapters/<adapter_name_or_ID>/certificates
https://<region>.kms.cloud.ibm.com/api/v2/kmip_adapters/<adapter_name_or_ID>/kmip_objects

1. 读取验证凭据，以便在服务中使用密钥。

2. 复制要用于创建 KMIP 适配器的根密钥 ID。

   您可以在您的 Key Protect实例，通过 检索密钥列表、 或访问 Key Protect 实例。 仪表盘。

3. 使用以下 curl 命令创建 KMIP 适配器：

   $ curl -X POST \
       "https://<region>.kms.cloud.ibm.com/api/v2/kmip_adapters" \
       -H "accept: application/vnd.ibm.kms.kmip_adapter+json" \
       -H "authorization: Bearer <IAM_token>" \
       -H "bluemix-instance: <instance_ID>" \
       -H "content-type: application/vnd.ibm.kms.kmip_adapter+json" \
       -d '{
               "metadata": {
                   "collectionType": "application/vnd.ibm.kms.kmip_adapter+json",
                   "collectionTotal": 1
               },
               "resources": [
                   {
                   "name": "<adapter_name>",
                   "description": "<adapter_description>",
                   "profile": "native_1.0",
                   "profile_data": {
                       "crk_id": "<root_keyID_or_alias>"
                   }
                   }
               ]
           }'
   

   根据下表替换示例请求中的变量。

4. 可选：您可以使用以下 curl 命令列出实例中存在的 KMIP 适配器：

   $ curl -X GET \
       "https://<region>.kms.cloud.ibm.com/api/v2/kmip_adapters" \
       -H "accept: application/vnd.ibm.kms.kmip_adapter+json" \
       -H "authorization: Bearer <IAM_token>" \
       -H "bluemix-instance: <instance_ID>" \
       -H "content-type: application/vnd.ibm.kms.kmip_adapter+json"
   

   您还可以使用以下 curl 命令获取特定的 KMIP 适配器：

   $ curl -X GET \
       "https://<region>.kms.cloud.ibm.com/api/v2/kmip_adapters/<adapter_name_or_ID>" \
       -H "accept: application/vnd.ibm.kms.kmip_adapter+json" \
       -H "authorization: Bearer <IAM_token>" \
       -H "bluemix-instance: <instance_ID>" \
       -H "content-type: application/vnd.ibm.kms.kmip_adapter+json"
   

   请注意，您可以使用适配器的 UUID 或适配器名称来获取特定的适配器。

5. 您可以使用以下 curl 命令删除 KMIP 适配器：

   $ curl -X DELETE \
       "https://<region>.kms.cloud.ibm.com/api/v2/kmip_adapters/<adapter_name_or_ID>" \
       -H "accept: application/vnd.ibm.kms.kmip_adapter+json" \
       -H "authorization: Bearer <IAM_token>" \
       -H "bluemix-instance: <instance_ID>" \
       -H "content-type: application/vnd.ibm.kms.kmip_adapter+json"
   

   只有删除适配器下的所有 KMIP 对象，才能删除 KMIP 适配器。