ModifyKeyServerKmipメソッドを使用すると、既存のKey Management Interoperability Protocol（KMIP）キー サーバを指定した属性に変更できます。唯一の必須パラメータはkeyServerIDですが、keyServerIDのみを含む要求は処理を実行せず、エラーは返されません。その他のパラメータを指定すると、キー サーバの既存の値が指定したkeyServerIDに置き換えられます。キー サーバは、機能していることを確認するため操作中に接続されます。キー サーバがクラスタ構成になっている場合にのみ、kmipKeyServerHostnamesパラメータに複数のホスト名またはIPアドレスを指定できます。
このメソッドの入力パラメータは次のとおりです。
| 名前 | 説明 | タイプ | デフォルト値 | 必須 |
|---|---|---|---|---|
| keyServerID | 変更するKMIPキー サーバのID。 | 整数 | なし | ○ |
| kmipCaCertificate | 外部キー サーバのルートCAの公開鍵証明書。これは、TLS通信で外部キー サーバから提示された証明書を検証するために使用されます。個々のサーバが異なるCAを使用するキー サーバ クラスタの場合は、すべてのCAのルート証明書を含む連結文字列を指定します。 | 文字列 | なし | × |
| kmipClientCertificate | SolidFire KMIPクライアントで使用されるPEM形式Base64エンコードPKCS#10 X.509証明書。 | 文字列 | なし | × |
| kmipKeyServerHostnames | このKMIPキー サーバに関連付けられているホスト名またはIPアドレスの配列。キー サーバがクラスタ構成の場合にのみ、複数のホスト名またはIPアドレスを指定する必要があります。 | 文字列の配列 | なし | × |
| kmipKeyServerName | KMIPキー サーバの名前。この名前は表示専用であり、一意にする必要はありません。 | 文字列 | なし | × |
| kmipKeyServerPort | KMIPキー サーバに関連付けられているポート番号（通常は5696）。 | 整数 | なし | × |
このメソッドの要求例を次に示します。
{
"method": "ModifyKeyServerKmip",
"params": {
"keyServerID": 15
"kmipCaCertificate": "CPDCCAaUCEDyRMcsf9tAbDpq40ES/E...",
"kmipClientCertificate": "kirWmnWXbj9T/UWZYB2oK0z5...",
"kmipKeyServerHostnames" : ["server1.hostname.com", "server2.hostname.com"],
"kmipKeyServerName" : "keyserverName",
"kmipKeyServerPort" : 5696
},
"id": 1
}
このメソッドの応答例を次に示します。
{
"id": 1,
"result":
{
"kmipKeyServer": {
"kmipCaCertificate":"CPDCCAaUCEDyRMcsf9tAbDpq40ES/E...",
"kmipKeyServerHostnames":[
"server1.hostname.com", "server2.hostname.com"
],
"keyProviderID":1,
"kmipKeyServerName":"keyserverName",
"keyServerID":1
"kmipKeyServerPort":1,
"kmipClientCertificate":"kirWmnWXbj9T/UWZYB2oK0z5...",
"kmipAssignedProviderIsActive":true
}
}
}
11.7