アダプターの作成

単一のインスタンスに作成できるアダプタは最大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 のリージョン内では、1つの証明書を1つのアダプターにのみ関連付けることができます。

KMIPプロトコルを通じて管理されているリソースには、 HTTP API からはアクセスできません。

アップロードした証明書の秘密鍵は、安全に保管してください。 KMIPアダプタにアップロードされた証明書であれば、サポートされているすべてのKMIP操作を実行できます。

アダプターの詳細の表示と更新

アダプタの詳細パネルには、アダプタに関する情報が表示され、証明書の追加などの操作を行うことができます。

アダプターの詳細を表示するには：

1. アダプターのアクションメニュー（⋯）をクリックしてください。
2. 「 詳細 」を選択してください。

詳細パネルには、アダプタの名前、説明、関連付けられたKMIP対称鍵、およびアップロードされた証明書が表示されます。 このパネルから、追加の証明書をアップロードすることもできます。

KMIPの対称鍵は、コンソールからは削除できません。 キーを削除するには、 CLI を使用してください。 Active 状態（状態 1 ）ではないKMIP対称鍵のみを削除できます。 Active 状態のキーが含まれているアダプタは削除できません。

各アダプタのリソースは、ルートキーによって保護されています。 アクティブ状態で、かつアダプタに関連付けられているルートキーは削除できません。

作成される各KMIP対称キーは、1つのキーバージョンとしてカウントされ、 1つのキーバージョンの料金が発生します。 KMIPの対称鍵の削除は取り消すことができません。

APIにおけるKMIPアダプタの作成と使用

このセクションでは、プロファイル「 native_1.0 」のKMIPアダプタをAPIで使用する方法について説明します。これには、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をコピーする。

   鍵の ID は、以下の場所にあります。 Key Protect インスタンスの鍵の ID は、鍵のリストを取得するか、または 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 オブジェクトが削除されている場合のみです。