Firma digital

/digitalSign

El servicio de Firma digital permite agregar firmas digitales y marcas de tiempo de confianza global a sus documentos sin la necesidad de hardware especializado como tokens USB o HSMs. Los certificados y las claves de firma se almacenan de forma segura en dispositivos de hardware compatibles con FIPS basados en la nube.

Solicitud:

bash

curl --location '{IDENTITY_API_BASE_URL}/services/digitalSign' \
--header 'x-api-key: {API_KEY}' \
--header 'Content-Type: application/json' \
--data '{
    "endUserContactInfo": "{CONTACT_EMAIL}",
    "file": "{BASE64_ENCODED_PDF}",
    "signingData": {
        "facialAuthenticationHash": "{FACIAL_HASH}",
        "serviceTransactionId": "{TRANSACTION_ID}"
    },
    "signingLocation": {
        "city": "{CITY}",
        "country": "{COUNTRY_ISO_ALPHA_3}",
        "geoLocationPosition": "null",
        "ipAddress": "null"
    },
    "signingType": "1",
    "signatureData": {
        "handSignature": "{BASE64_ENCODED_IMAGE}",
        "pageNumber": 0,
        "signatureFieldPosition": "100,160,50,50"
    }
}'

Parámetros de la solicitud:

Parámetro	Tipo	Requerido	Descripción
endUserContactInfo	String	Sí	Dirección de correo electrónico para contactar al usuario final.
file	String	Sí	Archivo PDF codificado en Base64 que se va a firmar.
signingData	Object	Sí	Información sobre la firma, incluyendo hash de autenticación facial e ID de transacción.
signingLocation	Object	Sí	Datos de ubicación incluyendo ciudad, país (ISO Alpha-3), geolocalización (opcional) y dirección IP (opcional).
signingType	String	Sí	Tipo de firma que se está realizando. 1 para firma por defecto.
signatureData	Object	No	Objeto opcional para incluir una imagen de firma manuscrita, número de página y posición del campo.

Ejemplo de solicitud:

json

{
    "endUserContactInfo": "[email protected]",
    "file": "JVBERi0xLjUKJbXtrvsKNCAwIG9iag...",
    "signingData": {
        "facialAuthenticationHash": "facialAuthenticationHash",
        "serviceTransactionId": "serviceTransactionId"
    },
    "signingLocation": {
        "city": "City",
        "country": "ISO Alfa-3",
        "geoLocationPosition": "null",
        "ipAddress": "null"
    },
    "signingType": "1",
    "signatureData": {
        "handSignature": "iVBORw0KGgoAAAANSUhEUgAAAEoAAABKCAYAA...",  
        "pageNumber": 0,  
        "signatureFieldPosition": "100,160,50,50" 
    }
}

Campos de la respuesta:

Identificador	Tipo	Descripción
serviceTransactionId	String	ID de transacción único para rastrear la operación de firma.
serviceResultCode	Integer	Código de resultado que indica el estado de la operación. 0 significa éxito.
serviceResultLog	String	Mensaje de registro relacionado con el resultado de la operación.
timestamp	String	Fecha y hora en que se completó la operación de firma.
serviceDocument	String	Documento PDF firmado codificado en Base64.

Ejemplo de respuesta:

json

{
    "serviceTransactionId": "19624424-018c-4e48-b0d6-498c3a497792",
    "serviceResultCode": 0,
    "serviceResultLog": "Executed OK",
    "timestamp": "2025-02-11T11:46:32.190Z",
    "serviceDocument": "JVBERi0xLjUKJbXtrvsK...."
}

Precaución PDF Sign es totalmente compatible con productos de Adobe (incluyendo Acrobat) y productos de Microsoft Office (incluyendo Word) en plataformas como Windows y Linux. Las firmas digitales utilizan certificados basados en PKI, garantizando:

• Autenticación: La identidad del firmante es validada por una autoridad certificadora (CA) pública de confianza.

• Integridad: El documento no ha sido alterado después de ser firmado.

• No repudio: El firmante no puede negar plausiblemente haber firmado el documento.

• Validación a Largo Plazo (LTV): Las firmas incluyen validación a largo plazo, asegurando que permanezcan válidas incluso después de que el certificado expire o sea revocado.