使用 UI 创建密钥环

您必须具有服务“写入者”或“管理者”角色才能创建密钥环。

制作钥匙圈

1. 单击左侧导航中的 密钥环。
2. 在“密钥环”面板中，单击 创建 按钮。
3. 在 创建密钥环 选项卡中，遵循有关允许的字符的指示信息，为新密钥环提供名称。 然后点击创建。

创建密钥环后，新的密钥环将显示在密钥环列表中，并且您可以向其传输密钥或为其创建密钥。

使用 API 创建密钥环

向以下端点拨打 POST 电话，创建钥匙圈。

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

1. 检索认证凭证以使用服务中的密钥。

2. 通过运行以下 curl 命令来创建密钥环。

   $ curl -X POST \
       "https://<region>.kms.cloud.ibm.com/api/v2/key_rings/<key_ring_id>" \
       -H "authorization: Bearer <IAM_token>" \
       -H "bluemix-instance: <instance_ID>" \
       -H "correlation-id: <correlation_ID>"
   

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

POST api/v2/key_rings 请求成功后会返回 HTTP 201 Created 响应，指示密钥环已创建，现在可用于保存标准密钥和根密钥。

授予对密钥环的访问权

您可以使用 IBM Cloud 控制台，IAM API或 CLI{ :external}来授予对 Key Protect 实例中密钥环的访问权。

查看 角色和许可权，以了解 IBM Cloud IAM 角色如何映射到 Key Protect 操作。

要使用控制台分配对密钥环的访问权:

1. 从菜单栏中，单击 管理 > 访问权 (IAM)，然后选择 用户，用于浏览帐户中的现有用户。

2. 选择表行，然后单击 ⋯ 图标以打开该用户的选项列表。

3. 从选项菜单中，单击 分配访问权。

4. 单击为用户分配额外访问权限。

5. 单击 IAM 服务 按钮。

6. 从服务列表中选择 Key Protect.

7. 选择 基于属性的服务。

8. 选择 实例标识 属性，然后选择密钥环所在的实例。

9. 选择 密钥环标识 属性，然后输入与密钥环关联的标识。

10. 选择组合 平台和服务访问角色，用于为用户分配访问权。

11. 单击添加。

12. 根据需要继续添加平台和服务访问角色，完成后，单击 分配。 请注意，必须为用户分配对整个实例的至少 读者 访问权，以便他们列出，创建和删除实例中的密钥环。

使用 API 列出密钥环

要查看高级视图，您可以通过以下方式浏览您的 Key Protect 管理的钥匙圈。对以下端点进行 GET 调用。

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

1. 检索认证凭证以使用服务中的密钥。

2. 通过运行以下命令来查看有关密钥环的常规特征: curl 指挥。

   $ curl -X GET \ "https://<region>.kms.cloud.ibm.com/api/v2/key_rings?totalCount=<show_total>&offset=<offset_value>&limit=<offset_limit>" \
       -H "accept: application/vnd.ibm.kms.key_ring+json" \
       -H "authorization: Bearer <IAM_token>" \
       -H "bluemix-instance: <instance_ID>" \
       -H "correlation-id: <correlation_ID>"
   

   问号 ? 后面的查询参数是可选的，但此处包含这些参数以记录其使用情况。 (: :note)

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

成功的 GET api/v2/key_rings 请求将返回在您的 Key Protect 服务实例。

{
    "metadata": {
        "collectionType": "application/vnd.ibm.kms.key_ring+json",
        "collectionTotal": 2
    },
    "resources": [
        {
            "id": "default"
        },
        {
            "id": "Sample Key Ring 2",
            "creationDate": "2020-03-12T11:00:06Z",
            "createdBy": "..."
        }
    ]
}

使用 API 删除密钥环

您可以通过对以下端点进行 DELETE 调用来删除密钥环。

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

如果密钥环至少包含一个处于 已销毁 状态以外的状态的密钥，那么此操作将不会成功。 如果密钥环中只有密钥处于 已销毁 状态，那么如果将 force=true 添加到 delete 命令中，那么可以删除密钥环。 处于该状态的密钥将自动传输到 default 密钥环。

1. 检索认证凭证以使用服务中的密钥。

2. 读取要删除的钥匙圈的 ID。

   您可以在您的密钥环中找到该密钥环的标识。 Key Protect 实例 检索密钥环列表。

3. 运行以下 curl 命令删除钥匙圈。 请注意 force=true 的存在，这将强制在密钥环包含处于 已销毁 状态的密钥时删除该密钥环。

   $ curl -X DELETE \
       "https://<region>.kms.cloud.ibm.com/api/v2/key_rings/<key_ring_id>?force=true" \
       -H "authorization: Bearer <IAM_token>" \
       -H "bluemix-instance: <instance_ID>" \
       -H "prefer: <return_preference>"
   

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

请求成功后会返回 HTTP 204 No Content 响应，表示已成功删除钥匙圈。表示已成功删除钥匙圈。