ModifierKeyServerKmip
Suggérer des modifications
PDF
Vous pouvez utiliser le ModifyKeyServerKmip méthode permettant de modifier un serveur de clés KMIP (Key Management Interoperability Protocol) existant selon les attributs spécifiés. Bien que le seul paramètre requis soit le keyServerID, une requête ne contenant que le keyServerID ne fera rien et ne renverra aucune erreur. Tout autre paramètre que vous spécifiez remplacera les valeurs existantes pour le serveur de clés par l'identifiant keyServerID spécifié. Le serveur clé est contacté pendant l'opération afin de s'assurer de son bon fonctionnement. Vous pouvez fournir plusieurs noms d'hôtes ou adresses IP avec le paramètre kmipKeyServerHostnames, mais uniquement si les serveurs de clés sont configurés en cluster.
Paramètres
Cette méthode possède les paramètres d'entrée suivants :
Nom |
Description |
Type |
Valeur par défaut |
Obligatoire |
ID du serveur de clés |
L'identifiant du serveur de clés KMIP à modifier. |
entier |
Aucune |
Oui |
kmipCaCertificate |
Le certificat de clé publique de l'autorité de certification racine du serveur de clés externe. Cela servira à vérifier le certificat présenté par le serveur de clés externe dans la communication TLS. Pour les clusters de serveurs critiques où chaque serveur utilise une autorité de certification différente, fournissez une chaîne concaténée contenant les certificats racine de toutes les autorités de certification. |
chaîne |
Aucune |
Non |
Certificat client kmip |
Un certificat X.509 PKCS#10 au format PEM encodé en Base64 utilisé par le client Solidfire KMIP. |
chaîne |
Aucune |
Non |
Noms d'hôte du serveur de clés kmip |
Tableau des noms d'hôtes ou des adresses IP associés à ce serveur de clés KMIP. Plusieurs noms d'hôtes ou adresses IP ne doivent être fournis que si les serveurs clés sont configurés en cluster. |
tableau de chaînes |
Aucune |
Non |
Nom du serveur de clés kmip |
Le nom du serveur de clés KMIP. Ce nom est utilisé uniquement à des fins d'affichage et n'a pas besoin d'être unique. |
chaîne |
Aucune |
Non |
kmipKeyServerPort |
Le numéro de port associé à ce serveur de clés KMIP (généralement 5696). |
entier |
Aucune |
Non |
Valeurs de retour
Cette méthode renvoie les valeurs suivantes :
Nom |
Description |
Type |
kmipKeyServer |
Un objet contenant des informations sur le serveur de clés nouvellement modifié. |
Exemple de demande
Les requêtes pour cette méthode sont similaires à l'exemple suivant :
{
"method": "ModifyKeyServerKmip",
"params": {
"keyServerID": 15
"kmipCaCertificate": "CPDCCAaUCEDyRMcsf9tAbDpq40ES/E...",
"kmipClientCertificate": "kirWmnWXbj9T/UWZYB2oK0z5...",
"kmipKeyServerHostnames" : ["server1.hostname.com", "server2.hostname.com"],
"kmipKeyServerName" : "keyserverName",
"kmipKeyServerPort" : 5696
},
"id": 1
}
Exemple de réponse
Cette méthode renvoie une réponse similaire à l'exemple suivant :
{
"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
}
}
}
Nouveautés depuis la version
11,7