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