Decrypts ciphertext into plaintext. - Key Management Service: Central de Documentação do Alibaba Cloud

Descrição da operação

Após chamar a operação Encrypt ou GenerateDataKey para gerar texto cifrado, use Decrypt para decifrá-lo.

Para obter mais informações sobre especificações de chave e modos de criptografia, consulte Key management types and key specifications.

Observações de uso

Todos os parâmetros da solicitação são codificados com Protocol Buffers. O corpo da solicitação resultante não pode exceder 3 MB. Se o volume de dados ultrapassar 3 MB, o servidor rejeitará a solicitação e retornará o código de status HTTP 413.

Em uma única chamada de criptografia ou descriptografia, mantenha os dados dentro dos seguintes limites:

Tipo de chave	Volume máximo de dados recomendado
Chave simétrica	6 KB
Chave assimétrica	1 KB

Se seus dados excederem esses limites, use criptografia de envelope. Para mais informações, consulte Envelope encryption.

Nota

Quanto maior o volume de dados em uma única chamada, maior o risco de falha na transmissão de rede, maior o tempo de transmissão e maior o tempo necessário para a instância do KMS concluir a criptografia ou descriptografia.

Parâmetros da solicitação

Name	Type	Required	Example	Description
KeyId	string	Yes	key-hzz62f1cb66fa42qo****	Identificador globalmente exclusivo da chave. Você também pode especificar um alias de chave para este parâmetro.
Algorithm	string	No	AES_GCM	Algoritmo de descriptografia. Importante O valor deve ser idêntico ao algoritmo usado na criptografia.
Iv	bytes	No	Binary data	Vetor de inicialização. Este parâmetro é obrigatório apenas se o algoritmo de descriptografia (parâmetro Algorithm) for AES_GCM, AES_CBC ou . Se o algoritmo de descriptografia (Algorithm) for AES_CBC, o comprimento de Iv será de 16 bytes. Se o algoritmo de descriptografia (Algorithm) for AES_GCM ou , o comprimento de Iv será de 12 bytes. Importante O valor deve ser idêntico ao vetor de inicialização usado na criptografia.
CiphertextBlob	bytes	Yes	Binary data	Texto cifrado a ser decifrado. Nota Se o algoritmo ECIES for utilizado, o formato do texto cifrado segue o padrão SEC 1: Elliptic Curve Cryptography, Version 2.0.
Aad	bytes	No	Binary data	Dados autenticados adicionais. O comprimento não pode exceder 8.192 bytes. Este parâmetro é necessário apenas quando o algoritmo de descriptografia (Algorithm) é AES_GCM ou SM4_GCM e os dados autenticados adicionais (Aad) foram especificados durante a criptografia. Importante O valor deve ser idêntico aos dados autenticados adicionais usados na criptografia.
PaddingMode	string	No	PKCS7_PADDING	Modo de preenchimento. Este parâmetro é obrigatório apenas se o algoritmo de criptografia for AES_CBC ou AES_ECB. Importante O valor deve ser idêntico ao modo de preenchimento usado na criptografia. Valores válidos: PKCS7_PADDING (padrão): preenchimento PKCS#7. O comprimento do texto simples não precisa ser múltiplo do tamanho de bloco (K bytes) do algoritmo de cifra de bloco. Se o comprimento do texto simples de entrada for L bytes, o sistema preenche K - (L mod K) bytes, e o valor de cada byte preenchido é K - (L mod K). NO_PADDING: nenhum preenchimento é aplicado ao texto simples. O comprimento do texto simples deve ser múltiplo inteiro do tamanho de bloco do algoritmo de cifra de bloco.

Dados da resposta

Name	Type	Example	Description
Plaintext	bytes	Binary data	Texto simples decifrado.
KeyId	string	key-hzz62f1cb66fa42qo****	Identificador globalmente exclusivo da chave. Se um alias de chave for usado como parâmetro KeyId na solicitação, a resposta retornará o identificador globalmente exclusivo da chave correspondente a esse alias.
Algorithm	string	AES_GCM	Algoritmo de descriptografia.
PaddingMode	string	PKCS7_PADDING	Modo de preenchimento.
RequestId	string	475f1620-b9d3-4d35-b5c6-3fbdd941423d	ID da solicitação. A Alibaba Cloud gera um ID exclusivo para cada solicitação. Use o ID da solicitação para solucionar problemas.

Códigos de erro

Código de status HTTP

Error code

Error message

Description

500

InternalFailure

Internal Failure.

Possíveis causas:

Os dados do texto cifrado não atendem aos requisitos.
Por exemplo, ao usar a descriptografia RSA (RSAES_OAEP_SHA_256), o algoritmo de resumo usado quando a chave pública criptografa o texto simples é SHA-1, ou o comprimento dos dados do texto cifrado não é múltiplo de 16 bytes (tamanho de bloco do algoritmo AES) ao usar a descriptografia AES_ECB.
A chave especificada nos parâmetros da solicitação não é a mesma usada para criptografia.

Se as causas acima forem descartadas, entre em contato com o suporte técnico.

Para obter mais informações sobre códigos de erro, consulte Common error codes.