使用使用者介面建立金鑰環

您必須具有服務 "Writer" 或 "Manager" 角色，才能建立金鑰環。

要製作一個鑰匙圈：

1. 按一下左導覽中的 鑰匙環。
2. 在「金鑰環」畫面中，按一下 建立 按鈕。
3. 在 建立金鑰環 標籤中，遵循允許字元的指示，提供新金鑰環的名稱。 接著點擊「建立」。

建立金鑰環之後，您的新金鑰環會出現在金鑰環清單中，您可以將金鑰傳送給它，或為它建立金鑰。

如果您在多個環境中一致地管理鑰匙圈，您可以使用 Key Protect Key Ring 模組或更廣泛的 Key Protect All-Inclusive 模組自動化鑰匙圈和鑰匙佈局。 有關上下文，請參閱 關於 Terraform IBM 模組。

使用 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. 選取 實例 ID 屬性，並選取金鑰環所在的實例。

9. 選取 金鑰環 ID 屬性，並輸入與金鑰環相關聯的 ID。

10. 選擇組合 平台及服務存取角色，以指派使用者的存取權。

11. 按一下新增。

12. 視需要繼續新增平台及服務存取角色，並在完成時按一下 指派。 請注意，使用者必須至少獲指派整個實例的 讀者 存取權，才能列出、建立及刪除實例內的金鑰環。

使用 API 列出金鑰環

若要獲得高層級概覽，您可以透過 對以下端點發出 GET 請求， 瀏覽您已配置的 Key Protect 實例中所管理的鑰匙圈。

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 時刪除金鑰環。 處於該狀態的金鑰會自動傳送至 default 金鑰環。

1. 擷取鑑別認證以使用服務中的金鑰。

2. 取得您要刪除的鑰匙圈的 ID。

   您可以在中找到金鑰環的 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 回應，表示已成功刪除鑰匙圈。表示已成功刪除鑰匙圈。