建立適配器

單一實例上最多可以建立 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 對稱金鑰的動作將無法撤銷。

在 API 中建立和使用 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 適配器。