Descifrar - Key Management Service - Centro de documentación de Alibaba Cloud

Llama a la operación Decrypt para descifrar texto cifrado y convertirlo en texto sin formato.

Descripción de la operación

Después de llamar a la operación Encrypt o GenerateDataKey para generar texto cifrado, puede usar Decrypt para descifrar dicho texto.

Para obtener más información sobre las especificaciones de claves y los modos de cifrado, consulte Key management types and key specifications.

Notas de uso

Todos los parámetros de solicitud se codifican con Protocol Buffers. El cuerpo de la solicitud resultante no debe superar los 3 MB. Si el volumen de datos excede este límite, el servidor rechaza la solicitud y devuelve el código de estado HTTP 413.

En una sola llamada de cifrado o descifrado, mantenga los datos dentro de los siguientes límites:

Tipo de clave	Volumen máximo de datos recomendado
Clave simétrica	6 KB
Clave asimétrica	1 KB

Si sus datos superan estos límites, utilice el cifrado de sobre. Para obtener más información, consulte Envelope encryption.

Nota

Cuanto mayor sea el volumen de datos en una sola llamada, mayor será el riesgo de fallo en la transmisión de red. Además, la transmisión tardará más tiempo y la instancia de KMS requerirá más tiempo para completar el cifrado o descifrado de datos.

Parámetros de solicitud

Nombre	Tipo	Obligatorio	Ejemplo	Descripción
KeyId	string	Sí	key-hzz62f1cb66fa42qo****	Identificador único global de la clave. También puede especificar un alias de clave para este parámetro.
Algorithm	string	No	AES_GCM	Algoritmo de descifrado. Importante El valor debe coincidir con el algoritmo usado para el cifrado.
Iv	bytes	No	Datos binarios	Vector de inicialización. Este parámetro es obligatorio solo si el algoritmo de descifrado (parámetro Algorithm) es AES_GCM, AES_CBC o . Si el algoritmo de descifrado (Algorithm) es AES_CBC, la longitud de Iv es de 16 bytes. Si el algoritmo de descifrado (Algorithm) es AES_GCM o , la longitud de Iv es de 12 bytes. Importante El valor debe coincidir con el vector de inicialización usado para el cifrado.
CiphertextBlob	bytes	Sí	Datos binarios	Texto cifrado que se va a descifrar. Nota Si se usa el algoritmo ECIES, el formato del texto cifrado sigue el estándar SEC 1: Elliptic Curve Cryptography, Version 2.0.
Aad	bytes	No	Datos binarios	Datos autenticados adicionales. La longitud no puede superar los 8,192 bytes. Este parámetro es obligatorio solo si el algoritmo de descifrado (Algorithm) es AES_GCM o SM4_GCM y se especificaron datos autenticados adicionales (Aad) durante el cifrado. Importante El valor debe coincidir con los datos autenticados adicionales usados para el cifrado.
PaddingMode	string	No	PKCS7_PADDING	Modo de relleno. Este parámetro es obligatorio solo si el algoritmo de cifrado es AES_CBC o AES_ECB. Importante El valor debe coincidir con el modo de relleno usado para el cifrado. Valores válidos: PKCS7_PADDING (predeterminado): Relleno PKCS#7. La longitud del texto sin formato no necesita ser múltiplo del tamaño de bloque (K bytes) del algoritmo de cifrado por bloques. Si la longitud del texto sin formato de entrada es L bytes, el sistema rellena K - (L mod K) bytes, y el valor de cada byte de relleno es K - (L mod K). NO_PADDING: No se aplica relleno al texto sin formato. La longitud del texto sin formato debe ser múltiplo entero del tamaño de bloque del algoritmo de cifrado por bloques.

Datos de respuesta

Nombre	Tipo	Ejemplo	Descripción
Plaintext	bytes	Datos binarios	Texto sin formato descifrado.
KeyId	string	key-hzz62f1cb66fa42qo****	Identificador único global de la clave. Si se usó un alias de clave como parámetro KeyId en la solicitud, la respuesta devuelve el identificador único global de la clave correspondiente a dicho alias.
Algorithm	string	AES_GCM	Algoritmo de descifrado.
PaddingMode	string	PKCS7_PADDING	Modo de relleno.
RequestId	string	475f1620-b9d3-4d35-b5c6-3fbdd941423d	ID de la solicitud. Alibaba Cloud genera un ID único para cada solicitud. Puede usar el ID de solicitud para solucionar problemas.

Códigos de error

Código de estado HTTP

Código de error

Mensaje de error

Descripción

500

InternalFailure

Internal Failure.

Posibles causas:

Los datos del texto cifrado no cumplen los requisitos.
Por ejemplo, al usar el descifrado RSA (RSAES_OAEP_SHA_256), el algoritmo de resumen usado cuando la clave pública cifra el texto sin formato es SHA-1; o bien, al usar el descifrado AES_ECB, la longitud de los datos del texto cifrado no es múltiplo de 16 bytes (tamaño de bloque del algoritmo AES).
La clave especificada en los parámetros de solicitud no es la clave usada para el cifrado.

Si se descartan las causas anteriores, póngase en contacto con el soporte técnico.

Para obtener más información sobre los códigos de error, consulte Common error codes.