Firma XAdES y CAdEs Detached proporcionando el Digest del documento

Los integradores pueden realizar firmas de hashes en tipos de firma XAdES y CAdES detached.

La firma en servidor de resúmenes de archivos, conocidos como hashes o digest, se utiliza cuando el documento a firmar es demasiado grande para viajar por la red. En este caso se calcula su hash o digest y es este el que se envía a firmar.

Las ventajas de la firma de hashes en tipos de firma XAdES y CAdES detached son claras, en lugar de enviar documentos que pueden llegar a pesar varios cientos de Mb, se envía el hash asociado, reduciendo drásticamente el tamaño que navega por la red.

La configuración es idéntica a la de una firma en servidor tradicional, proporcionando en el "bytesB64" del documento el digest del mismo, además se añaden parámetros para especificar que lo que se va a firmar es un hash y el algoritmo utilizado para la creación de dicho hash. Dado que se trata de firmas de archivos grandes, el tipo o envoltura de la firma debe ser obligatoriamente DETACHED, con el fin de luego poder validar que el documento original se corresponde con el hash firmado.

Este tipo de firma solamente se encuentra disponible para las firmas XAdES y CAdES.

Ejemplo de firma XAdES Detached proporcionando en digest del documento

Los parámetros que se reciben (en formato application/json) tienen la siguiente forma:

{
    "signatureConfigurations": [
        {
            "document": {
                "bytesB64": "gYbYj9w6DofPvCfwqKKwXitsErA=",
                "name": "test.xml"
            },
            "signatureType": "XADES_B",
            "signatureAlgorithm": "RSA_SHA256",
            "packaging": "DETACHED",
            "xadesConfiguration": {
                "hashSignature": true,
                "hashDigestAlgorithm": "SHA256"
            }
        }
    ]
}

Donde:

Ejemplo de firma CAdES Detached proporcionando en digest del documento

Los parámetros que se reciben (en formato application/json) tienen la siguiente forma:

{
    "redirectUri": "{{redirect_uri}}",
    "certificateCode": "{{certificate_code}}",
    "signatureConfigurations": [{
        "document": {
            "bytesB64": "duqznMIZ0P/3qE1Of7p3HPedybAVeRhXr235PgylADU=",
            "name": "original.pdf"
        },
        "signatureType": "CADES_B",
        "signatureAlgorithm": "RSA_SHA256",
        "packaging": "DETACHED",
        "cadesConfiguration": {
            "hashSignature" : true,
            "hashDigestAlgorithm" : "SHA256"
         }
  }]
}

Donde: