创建适配器

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

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

创建适配器

1. 使用左侧导航导航到 KMIP 适配器面板。 如果这是您的第一个适配器，表格应该是空的。 请注意，您必须在实例上设置 Manager 角色或 KmipAdapterManager 角色，才能创建适配器。

2. 找到 Create Adapter 按钮并单击。

3. 在打开的侧面板中，为适配器设置 Name 和 Description 选项。 请注意，名称必须至少包含 2 个字符，最多不超过 40 个字符。 如果您选择对其进行描述，描述必须至少两个字符，且不超过 240 个字符。 完成上述操作后，就可以选择用于创建该适配器和加密其创建的 KMIP 密钥的根密钥。 必须选择根密钥。 请注意，您的根密钥必须处于 active 状态，适配器才能正常工作。

4. 添加公共 TLS 证书后，相应私人证书的持有者就可以通过关联的 KMIP 适配器与 Key Protect 通信。 只有经 KMIP 适配器授权的证书才能对您的实例发出 KMIP 协议请求。 请注意，通过KMIP协议管理的资源无法通过 HTTP API访问。

   虽然在创建适配器时不需要添加任何证书，但如果知道要添加哪些证书，可以单击面板中的添加证书（可选） 选项卡。 在生成的屏幕中，点击 Upload certificate 按钮，为证书命名，并输入证书内容（材料必须是 PEM 格式，并包含 BEGIN CERTIFICATE 和 END CERTIFICATE 标记）。 请注意，证书关联可能需要几分钟时间。 此外，证书只能与 Key Protect 区域中的单个适配器关联。

确保任何上载证书的私钥安全，因为任何上载到 KMIP 适配器的证书都能进行所有受支持的 KMIP 操作。

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

通过适配器详细信息面板，您可以了解适配器的相关信息（例如，通过描述），还可以执行添加证书等操作。

要查看适配器详细信息，请单击 ⋯ 图标。 这将显示适配器的所有详细信息。 在这里，你可以看到它的名称、描述、与适配器相关的任何 KMIP 对称密钥以及已上载到它的证书。 您还可以根据需要使用该面板上传更多证书。

不能使用用户界面删除 KMIP 对称密钥。 要删除密钥，必须使用 CLI。 只有处于 Active（状态 1）以外状态的 KMIP 对称密钥才能被删除。 如果适配器包含处于 Active 状态的键，则无法删除该适配器。

每个适配器的资源都受 CRK 保护。 不能删除已激活并与适配器关联的 CRK。

每个创建的KMIP对称密钥都算作一个密钥版本，并 收取一个密钥版本的费用。 如果要删除 KMIP 对称密钥，只能使用 API、CLI 或 SDK。 您不能使用用户界面。 请注意，删除 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 适配器。