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

Firma datos mediante una clave asimétrica.

Notas de uso

Después de codificar todos los parámetros de la solicitud con Protocol Buffers, el cuerpo de la solicitud no debe superar los 3 MB. Si el cuerpo excede este límite, el servidor rechaza la solicitud y devuelve un error HTTP 413. Para mensajes grandes, genere un hash localmente y páselo con MessageType establecido en DIGEST; luego, llame a la operación Sign o Verify.

Para consultar las especificaciones de claves y los algoritmos de firma compatibles, consulte Tipos y especificaciones de claves.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
KeyId	string	Sí	`1234abcd-12ab-34cd-56ef-12345678****`	Identificador único global de la clave. También puede especificar un alias vinculado a la clave.
Algorithm	string	Sí	`RSAES_OAEP_SHA_256`	Algoritmo de firma. Valores válidos: `RSA_PSS_SHA_256`, `RSA_PKCS1_SHA_256`, `ECDSA_SHA_256`, `SM2DSA`.
MessageType	string	Sí	`RAW`	Tipo de mensaje. Valores válidos: `RAW` (predeterminado): datos sin procesar. KMS utiliza el algoritmo de hash especificado por `Algorithm` para generar un hash y luego lo firma. `DIGEST`: hash de mensaje precalculado. KMS usa la clave privada para firmar el hash directamente. El hash puede tener hasta 32 bytes.
Message	bytes	Sí	Datos binarios	Mensaje que se va a firmar.

Elementos de respuesta

Parámetro	Tipo	Ejemplo	Descripción
Signature	bytes	Datos binarios	Valor de la firma calculada.
KeyId	string	`1234abcd-12ab-34cd-56ef-12345678****`	Identificador único global de la clave. Si especificó un alias, este campo devuelve el identificador de la clave a la que está vinculado dicho alias.
Algorithm	string	`RSAES_OAEP_SHA_256`	Algoritmo de firma.
MessageType	string	`RAW`	Tipo de mensaje.
RequestId	string	`475f1620-b9d3-4d35-b5c6-3fbdd941423d`	Identificador de la solicitud.

Códigos de error

Para obtener la lista de códigos de error, consulte Códigos de error del servicio.