コンソールを使用した標準鍵のインポート

サービスのインスタンスを作成した後、以下の手順を実行して、IBM Cloud コンソールを使用して既存の鍵をインポートします。

Key Protect インスタンスの二重許可設定 を有効にする場合、 サービスに追加するどの鍵についても、 鍵の削除には 2 人のユーザーからの許可が必要となることに 留意してください。

1. IBM Cloudコンソールにログインする。

2. 「メニュー」>**「リソース・リスト」**に移動し、リソースのリストを表示します。

3. IBM Cloud リソース・リストで、Key Protect のプロビジョン済みインスタンスを選択します。

4. 新しい鍵をインポートするには、**「鍵の追加」をクリックして、「独自の鍵をインポート (Import your own key)」**ウィンドウを選択します。

   キーの詳細を以下のように指定します。

        (既存の鍵ラップ鍵など)。 詳しくは、[鍵素材の Base64 でのエンコード](#how-to-encode-standard-key-material)を確認してください。 鍵素材が 16 バイト、24 バイト、または 32 バイトの長さであり、128 ビット、192 ビット、または 256 ビットの長さに相当することを確認してください。 鍵はまた base64 でエンコードされている必要があります。 |

| キー・エイリアス | オプション。 鍵の別名は、表示名の制限を超える鍵の説明を入力して、鍵の識別やグループ化を可能にするものです。 鍵には最大 5 つの別名を指定できます。 | | 鍵リング | オプション。 鍵リングとは、鍵をグループに分けて、各グループを必要に応じて独立して管理できるようにするものです。 どの鍵も 1 つの鍵リングに含まれていなければなりません。 鍵リングを選択しない場合、鍵は default 鍵リングに入れられます。 作成している鍵を鍵リングに配置するには、その鍵リングに対して_マネージャー_の役割を持っている必要があることに注意してください。 役割について詳しくは、ユーザーのアクセス権限の管理を参照してください。 |

鍵の詳細の記入が完了したら、**「鍵のインポート (Import key)」**をクリックして確認します。

鍵を配置する鍵リングがわかっていて、その鍵リングの_マネージャー_である場合は、**「鍵リング」パネルにナビゲートし、「⋯」を選択して、「鍵リングへの鍵の追加」をクリックすることもできます。 この場合は、「鍵」ページで「追加」をクリックするのと同じパネルが、「鍵リング (Key rings)」**変数に鍵リング名が入力された状態で開かれます。

標準鍵のインポート

以下のエンドポイントへの POST 呼び出しを行うことにより、標準鍵をインポートします。

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

1. サービス内で鍵の処理を行うために、サービス資格情報および認証資格情報を取得します。

2. 以下の curl コマンドを使用して、 Key Protect API を呼び出します。

   $ curl -X POST \
       "https://<region>.kms.cloud.ibm.com/api/v2/keys" \
       -H "authorization: Bearer <IAM_token>" \
       -H "bluemix-instance: <instance_ID>" \
       -H "content-type: application/vnd.ibm.kms.key+json" \
       -H "correlation-id: <correlation_ID>" \
       -H "prefer: <return_preference>" \
       -d '{
               "metadata": {
                   "collectionType": "application/vnd.ibm.kms.key+json",
                   "collectionTotal": 1
               },
               "resources": [
                   {
                       "type": "application/vnd.ibm.kms.key+json",
                       "name": "<key_name>",
                       "aliases": [alias_list],
                       "description": "<key_description>",
                       "expirationDate": "<expiration_date>",
                       "payload": "<key_material>",
                       "extractable": <key_type>
                   }
               ]
           }'
   

   次の表に従って、例の要求内の変数を置き換えてください。

個人データの機密性を保護するため、サービスに鍵を追加するときに、個人の名前や場所などの個人情報 (PII) を入力しないようにしてください。 PIIの詳細な例については、セクション2.2を参照のこと。 節を参照のこと。 節を参照のこと。

成功した POST api/v2/keys 応答は、鍵の ID 値を他のメタデータと共に返します。 ID は、鍵に割り当てられ、その後の以下の呼び出しに使用される固有 ID です Key Protect API。

$ curl -X GET \
    "https://<region>.kms.cloud.ibm.com/api/v2/keys" \
    -H "accept: application/vnd.ibm.collection+json" \
    -H "authorization: Bearer <IAM_token>" \
    -H "bluemix-instance: <instance_ID>"