Descriptografia de dados
Função
Essa API permite que você descriptografe dados.
Restrições
- Ao descriptografar dados criptografados com uma CMK assimétrica, você precisa especificar o ID da CMK e o algoritmo de criptografia. Se a CMK especificada e o algoritmo de criptografia não corresponderem ao valor usado para criptografar os dados, a operação de descriptografia falhará.
URI
POST /v1.0/{project_id}/kms/decrypt-data
Parâmetro | Obrigatoriedade | Tipo | Descrição |
|---|---|---|---|
project_id | Sim | String | ID do projeto. |
Parâmetros de solicitação
Parâmetro | Obrigatoriedade | Tipo | Descrição |
|---|---|---|---|
X-Auth-Token | Sim | String | Token do usuário. O token pode ser obtido chamando a API do IAM (valor de X-Subject-Token no cabeçalho de resposta). |
Parâmetro | Obrigatoriedade | Tipo | Descrição |
|---|---|---|---|
cipher_text | Sim | String | Texto cifrado de dados criptografados. É o valor de cipher_text no resultado da criptografia de dados e corresponde à expressão regular ^[0-9a-zA-Z+/=]{188,5648}$. |
encryption_context | Não | Object | Pares de chave-valor com um comprimento máximo de caracteres 8.192. Esse parâmetro é usado para registrar informações de contexto de recursos, excluindo informações confidenciais, para garantir a integridade dos dados. Se esse parâmetro for especificado durante a criptografia, ele também será necessário para a descriptografia. Exemplo: {"Key1":"Value1","Key2":"Value2"} |
key_id | Não | String | ID de CMK. Deve ter 36 bytes e corresponder à expressão regular ^[0-9a-z]{8}-[0-9a-z]{4}-[0-9a-z]{4}-[0-9a-z]{4}-[0-9a-z]{12}$. Este parâmetro só é necessário ao usar uma CMK assimétrica. Exemplo: 0d0466b0-e727-4d9c-b35d-f84bb474a37f |
encryption_algorithm | Não | String | Algoritmo de criptografia de dados. Use apenas CMKs assimétricas precisam especificar este parâmetro, o valor padrão é "SYMMETRIC_DEFAULT". Pode ser:
|
sequence | Não | String | Número de sequência de 36-byte de uma mensagem de solicitação. Exemplo: 919c82d4-8046-4722-9094-35c3c6524cff |
Parâmetros de resposta
Código de status: 200
Parâmetro | Tipo | Descrição |
|---|---|---|
key_id | String | ID de CMK. |
plain_text | String | Texto não criptografado. |
Código de status: 400
Parâmetro | Tipo | Descrição |
|---|---|---|
error | Object | Mensagem de erro. |
Parâmetro | Tipo | Descrição |
|---|---|---|
error_code | String | Código de erro. |
error_msg | String | Informação de erro. |
Código de status: 403
Parâmetro | Tipo | Descrição |
|---|---|---|
error | Object | Mensagem de erro. |
Parâmetro | Tipo | Descrição |
|---|---|---|
error_code | String | Código de erro. |
error_msg | String | Informação de erro. |
Código de status: 404
Parâmetro | Tipo | Descrição |
|---|---|---|
error | Object | Mensagem de erro. |
Parâmetro | Tipo | Descrição |
|---|---|---|
error_code | String | Código de erro. |
error_msg | String | Informação de erro. |
Exemplo de solicitações
{
"cipher_text" : "AgDoAG7EsEc2OHpQxz4gDFDH54Cqwaelxxxxxxx"
} Exemplo de respostas
Código de status: 200
Processamento da solicitação bem-sucedido.
{
"key_id" : "bb6a3d22-dc93-47ac-b5bd-88df7ad35f1e",
"plain_text" : "hello world"
} Código de status: 400
Parâmetros de solicitação inválidos.
{
"error" : {
"error_code" : "KMS.XXX",
"error_msg" : "XXX"
}
} Código de status: 403
Autenticação falhou.
{
"error" : {
"error_code" : "KMS.XXX",
"error_msg" : "XXX"
}
} Código de status: 404
O recurso solicitado não existe ou não foi encontrado.
{
"error" : {
"error_code" : "KMS.XXX",
"error_msg" : "XXX"
}
} Códigos de status
Código de status | Descrição |
|---|---|
200 | Processamento da solicitação bem-sucedido. |
400 | Parâmetros de solicitação inválidos. |
403 | Autenticação falhou. |
404 | O recurso solicitado não existe ou não foi encontrado. |
Códigos de erro
Consulte Códigos de erro.
