ModifyKeyServerKmip
Sugerir alterações
PDFs
Você pode usar o ModifyKeyServerKmip Método para modificar um servidor de chaves KMIP (Key Management Interoperability Protocol) existente para os atributos especificados. Embora o único parâmetro obrigatório seja o keyServerID, uma solicitação contendo apenas o keyServerID não executará nenhuma ação e não retornará nenhum erro. Quaisquer outros parâmetros que você especificar substituirão os valores existentes para o servidor de chaves pelo keyServerID especificado. O servidor de chaves é contatado durante a operação para garantir que esteja funcionando corretamente. É possível fornecer vários nomes de host ou endereços IP com o parâmetro kmipKeyServerHostnames, mas somente se os servidores de chaves estiverem em uma configuração em cluster.
Parâmetros
Este método possui os seguintes parâmetros de entrada:
Nome |
Descrição |
Tipo |
Valor padrão |
Obrigatório |
ID do servidor de chaves |
O ID do servidor de chaves KMIP a ser modificado. |
inteiro |
Nenhum |
Sim |
kmipCaCertificado |
O certificado de chave pública da autoridade certificadora raiz do servidor de chaves externo. Isso será usado para verificar o certificado apresentado pelo servidor de chaves externo na comunicação TLS. Para clusters de servidores principais onde servidores individuais usam diferentes CAs, forneça uma string concatenada contendo os certificados raiz de todas as CAs. |
corda |
Nenhum |
Não |
kmipClientCertificate |
Um certificado PKCS#10 X.509 codificado em Base64 no formato PEM, usado pelo cliente Solidfire KMIP. |
corda |
Nenhum |
Não |
kmipKeyServerHostnames |
Matriz de nomes de host ou endereços IP associados a este servidor de chaves KMIP. Só é necessário fornecer vários nomes de host ou endereços IP se os servidores principais estiverem em uma configuração de cluster. |
matriz de strings |
Nenhum |
Não |
kmipKeyServerName |
O nome do servidor de chaves KMIP. Este nome é usado apenas para fins de exibição e não precisa ser único. |
corda |
Nenhum |
Não |
kmipKeyServerPort |
O número da porta associada a este servidor de chaves KMIP (normalmente 5696). |
inteiro |
Nenhum |
Não |
Valores de retorno
Este método tem os seguintes valores de retorno:
Nome |
Descrição |
Tipo |
kmipKeyServer |
Um objeto contendo detalhes sobre o servidor de chaves recém-modificado. |
Exemplo de solicitação
As solicitações para esse método são semelhantes ao seguinte exemplo:
{
"method": "ModifyKeyServerKmip",
"params": {
"keyServerID": 15
"kmipCaCertificate": "CPDCCAaUCEDyRMcsf9tAbDpq40ES/E...",
"kmipClientCertificate": "kirWmnWXbj9T/UWZYB2oK0z5...",
"kmipKeyServerHostnames" : ["server1.hostname.com", "server2.hostname.com"],
"kmipKeyServerName" : "keyserverName",
"kmipKeyServerPort" : 5696
},
"id": 1
}
Exemplo de resposta
Este método retorna uma resposta semelhante ao exemplo a seguir:
{
"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
}
}
}
Novidade desde a versão
11,7