Todos los productos
Search

Este producto

    Key Management Service:Compruebe

    Centro de documentos

    Key Management Service:Compruebe

    Última actualización: Sep 03, 2026

    Comprueba una firma digital creada con una clave asimétrica.

    Notas de uso

    El tamaño total de todos los parámetros de la solicitud, codificados con Protocol Buffers, no debe exceder los 3 MB. Si el cuerpo de la solicitud supera este límite, el servidor rechaza la solicitud con HTTP 413. Para mensajes grandes, genere un resumen localmente y páselo como parámetro Message con MessageType establecido en DIGEST, o bien invoque la operación Sign o Verify para firmar y comprobar.

    Para conocer 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****

    ID ú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. Debe coincidir con el algoritmo usado al invocar la operación Sign.

    MessageType

    string

    Sí

    RAW

    Tipo de mensaje por comprobar. Valores válidos: RAW (predeterminado), DIGEST. Cuando se establece en DIGEST, Key Management Service (KMS) no procesa el resumen del mensaje de los datos sin formato; KMS usa directamente una clave privada para firmar los datos.

    Message

    bytes

    Sí

    Datos binarios

    Mensaje por comprobar. Si MessageType es RAW, Key Management Service (KMS) aplica el algoritmo de hash especificado por Algorithm para generar un resumen y luego comprueba la firma. Si MessageType es DIGEST, pase un resumen precalculado de hasta 32 bytes.

    Signature

    bytes

    Sí

    Datos binarios

    Valor de la firma por comprobar.

    Elementos de respuesta

    Parámetro

    Tipo

    Ejemplo

    Descripción

    Value

    bool

    true

    Indica si la firma es válida. Valores válidos: true, false.

    KeyId

    string

    1234abcd-12ab-34cd-56ef-12345678****

    ID único global de la clave usada para la comprobación. Si especificó un alias, este campo devuelve el ID 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

    ID de la solicitud.

    Códigos de error

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