SetSignProcessExternalDigestSigner

Zabezpieczenia i podpisy

Opis

Dołącza certyfikat X.509 zakodowany w DER i format zewnętrznego podpisywania skrótu do procesu podpisywania PDF

Biblioteka tworzy odłączony obiekt CMS i wysyła do zarejestrowanej funkcji wywołania zwrotnego wyłącznie końcowy skrót jego uwierzytelnionych atrybutów

Składnia

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);

Parametry

SignProcessID	Wartość zwrócona przez funkcję `NewSignProcessFrom*`
CertificateDER	Kompletny certyfikat X.509 RSA lub ECDSA zakodowany w DER, odpowiadający zewnętrznemu kluczowi prywatnemu
SignatureAlgorithm	`1` dla RSA PKCS#1 v1.5, `2` dla ECDSA zakodowanego w DER albo `3` dla ECDSA P1363 `r \|\| s`
SignatureReserveBytes	Oczekiwana górna granica rozmiaru surowego podpisu albo `0`, aby wyznaczyć ją z klucza publicznego certyfikatu

Wartości zwracane

1	Konfiguracja zewnętrznej tożsamości została dołączona
0	Identyfikator procesu, certyfikat, algorytm lub rozmiar rezerwy były nieprawidłowe

Uwagi

Przed zakończeniem procesu podpisywania przypisz OnExternalDigestSign, wywołaj DLSetExternalDigestSignCallback albo przekaż obiekt wywołania zwrotnego ActiveX przez SetExternalDigestSignCallback

Funkcja wywołania zwrotnego nie jest wywoływana podczas ustalania rozmiaru symbolu zastępczego /Contents i zostaje wywołana dokładnie raz dla końcowego podpisu

Zwrócone bajty podpisu są weryfikowane przy użyciu CertificateDER przed zaakceptowaniem pliku PDF

Gdy proces nadal używa starszej wartości domyślnej adbe.pkcs7.sha1, ta metoda automatycznie wybiera adbe.pkcs7.detached

Zobacz również

OnExternalDigestSign, SetExternalDigestSignCallback, SetSignProcessContentsEstimate, SetSignProcessExternalDigestSignerFromFile