SetSignProcessExternalDigestSigner

Seguridad y firmas

Descripción

Adjunta un certificado X.509 codificado en DER y un formato externo de firma de resúmenes a un proceso de firma PDF

La biblioteca construye el objeto CMS separado y envía a la devolución de llamada registrada únicamente el resumen final de sus atributos autenticados

Sintaxis

Delphi

Function TPDFlib.SetSignProcessExternalDigestSigner(SignProcessID: Integer; Const CertificateDER: AnsiString; SignatureAlgorithm, SignatureReserveBytes: Integer): Integer;

ActiveX

Function PDFlib::SetSignProcessExternalDigestSigner(SignProcessID As Long, CertificateDER As Variant, SignatureAlgorithm As Long, SignatureReserveBytes As Long) As Long

DLL

int DLSetSignProcessExternalDigestSigner(int InstanceID, int SignProcessID, const char* CertificateDER, int CertificateLength, int SignatureAlgorithm, int SignatureReserveBytes);

Parámetros

SignProcessID	Valor devuelto por una función `NewSignProcessFrom*`
CertificateDER	Certificado X.509 RSA o ECDSA completo codificado con DER que corresponde a la clave privada externa
SignatureAlgorithm	`1` para RSA PKCS#1 v1.5, `2` para ECDSA codificado con DER o `3` para ECDSA P1363 `r \|\| s`
SignatureReserveBytes	Límite superior esperado de la firma sin procesar, o `0` para derivarlo de la clave pública del certificado

Valores devueltos

1	Se adjuntó la configuración de identidad externa
0	El identificador de proceso, el certificado, el algoritmo o el tamaño reservado no eran válidos

Observaciones

Asigne OnExternalDigestSign, llame a DLSetExternalDigestSignCallback o proporcione un objeto de devolución de llamada ActiveX con SetExternalDigestSignCallback antes de finalizar el proceso de firma

La devolución de llamada no se invoca al dimensionar el marcador de posición /Contents y se invoca exactamente una vez para la firma final

Los bytes de firma devueltos se verifican con CertificateDER antes de aceptar el PDF

Cuando el proceso aún utiliza el valor predeterminado heredado adbe.pkcs7.sha1, este método selecciona automáticamente adbe.pkcs7.detached

Véase también

OnExternalDigestSign, SetExternalDigestSignCallback, SetSignProcessContentsEstimate, SetSignProcessExternalDigestSignerFromFile