Opciones de firma Linux nativa
El ABI nativo de callbacks vincula las restricciones de firma de documentos a la salida CMS real y a la apariencia generada
Digest y metadatos Unicode
La operación de firma acepta digestMethod como SHA256, SHA384 o SHA512; el valor por defecto es SHA256 y el valor seleccionado determina el digest real del signer CMS
reason, location, contactInfo, signerName y legalAttestation aceptan cadenas Unicode sin caracteres NUL embebidos
Los metadatos siguen la política de cifrado de cadenas del documento de origen, incluida la entrada AES-256 autenticada
legalAttestation se aplica a las firmas de certificación y se convierte en el valor Legal.Attestation del catálogo
Los valores de seed obligatorios gobiernan el digest real, la reason, las propiedades del certificado, el permiso de certificación, la declaración legal, el perfil de apariencia, la información de revocación y el comportamiento del timestamp
Bytes de confianza explícitos
trustedCAPEM, timestampTrustedCAPEM y timestampTrustedCRLPEM aceptan bytes PEM en cadenas JSON
Las entradas legacy de rutas correspondientes son trustedCAFile, timestampTrustedCAFile y timestampTrustedCRLFile; suministra bytes o una ruta para cada fuente de confianza
Las entradas PEM se mantienen en ficheros privados exclusivos con modo 0600 durante la operación y se eliminan después; las respuestas no exponen esas rutas generadas
La confianza en el certificado del signer solo se evalúa cuando está configurada explícitamente, mientras que la verificación de integridad CMS sigue comprobando la firma real y el binding del certificado de firma
Información de revocación firmada y validada
Suministra un objeto revocationInfo con enabled, certificatesBase64, ocspResponsesBase64, crlsBase64 y trustedCAPEM o trustedCAFile
enabled toma por defecto true; la información desactivada no puede incluir arrays de evidencia
Los arrays contienen cadenas Base64 canónicas para certificados DER completos, objetos OCSPResponse correctos y objetos CertificateList
clockSkewSeconds toma por defecto 300 y debe estar entre 0 y 86400; maxOCSPAgeSeconds toma por defecto 86400 y debe ser positivo; requireTimestamp toma por defecto false
La validación comprueba las cadenas de certificados del signer y del timestamp incluido contra la confianza explícita, la cobertura completa no raíz, la coincidencia de issuer y serial, las firmas CRL y OCSP, la autorización del responder, los intervalos de validez y el estado revocado
Una evidencia mal formada, caducada, incompleta, no confiable o revocada falla antes de la publicación del PDF
La evidencia validada se convierte en el atributo CMS firmado 1.2.840.113583.1.1.8, y el resultado informa revocationInfoEvaluated y revocationInfoValid
signatures.verify acepta el mismo objeto revocationInfo para validar el atributo firmado real embebido; las CRLs y respuestas OCSP del llamador no reemplazan ese atributo durante la verificación
Los objetos de evidencia y los bytes totales comparten los límites de la operación, y las comprobaciones criptográficas usan el token de cancelación de la operación
Presets de apariencia con nombre reales
Suministra un objeto appearance con caption, fontFamily opcional y profileName opcional
| profileName | Estilo real generado |
|---|---|
| HotPDF.StandardApproval | Texto azul centrado a 11 puntos, borde rectangular, fondo blanco y una sola línea de texto |
| HotPDF.StandardCertification | Texto negro alineado a la izquierda a 10 puntos, borde rectangular, fondo blanco y wrapping multilínea |
| HotPDF.Compact | Texto negro alineado a la derecha a 8 puntos, sin fondo ni borde pintados y una sola línea de texto |
El preset determina su estilo y tamaño de fuente; un perfil desconocido falla en lugar de etiquetar una apariencia arbitraria
Un AppearanceFilter obligatorio debe coincidir con el perfil real generado durante la operación actual; una apariencia cargada previamente debe regenerarse
Sin profileName, fontSize toma por defecto 12; el caption, fontFamily y fontSize legacy de nivel superior siguen soportados
No combines un caption de nivel superior con un objeto appearance
Procedencia del transporte de la aplicación
credentialSourceURL declara la procedencia de credenciales afirmada por la aplicación que suministra la identidad, y timestampServerURL declara la procedencia del endpoint afirmada por su callback de timestamp
Estos valores se comparan con las restricciones de seed obligatorias correspondientes; no recuperan credenciales, no acceden a un servidor remoto ni autentican independientemente la identidad del endpoint HTTPS
La aplicación controla la recuperación de la identidad y la autenticación del transporte
timestampServerURL exige un callback real en hpdf_signing_operation_v1, y la respuesta RFC 3161 devuelta debe pasar las comprobaciones de huella de firma, nonce, propósito del certificado TSA, confianza explícita y revocación solicitada
Signing workflows · Timestamp transport · Seed constraints · Appearance profiles