SetSignProcessExternalDigestSigner
Segurança e assinaturas
Descrição
Anexa um certificado X.509 codificado em DER e um formato de assinatura de digest externo a um processo de assinatura PDF
A biblioteca constrói o objeto CMS detached e envia ao callback registrado apenas o digest final de seus atributos autenticados
Sintaxe
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 retornado por uma função NewSignProcessFrom* |
|---|---|
| CertificateDER | Certificado X.509 RSA ou ECDSA completo, codificado em DER, correspondente à chave privada externa |
| SignatureAlgorithm | 1 for RSA PKCS#1 v1.5, 2 for DER-encoded ECDSA, or 3 for ECDSA P1363 r || s |
| SignatureReserveBytes | Limite superior esperado para a assinatura bruta, ou 0 para derivá-lo da chave pública do certificado |
Valores retornados
| 1 | A configuração de identidade externa foi anexada |
|---|---|
| 0 | O id do processo, o certificado, o algoritmo ou o tamanho de reserva era inválido |
Observações
Atribua OnExternalDigestSign, chame DLSetExternalDigestSignCallback, ou forneça um objeto de callback ActiveX com SetExternalDigestSignCallback antes de encerrar o sign process. O callback não é invocado durante o dimensionamento do
/Contents
CertificateDER
placeholder adbe.pkcs7.sha1 e é invocado exatamente uma vez para a assinatura final. Os bytes da assinatura retornada são verificados contra adbe.pkcs7.detached antes de o PDF ser aceito. Quando o processo ainda usa o legado
Veja também
OnExternalDigestSign, SetExternalDigestSignCallback, SetSignProcessContentsEstimate, SetSignProcessExternalDigestSignerFromFile