SetSignProcessExternalDigestSigner
セキュリティと署名
説明
DER エンコード済み X.509 証明書と外部ダイジェスト署名形式を PDF 署名処理に関連付けます
ライブラリは分離 CMS オブジェクトを構築し、認証済み属性の最終ダイジェストだけを登録済みコールバックへ送信します
構文
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);
パラメータ
| SignProcessID | NewSignProcessFrom* 関数が返す値 |
|---|---|
| CertificateDER | 外部秘密鍵に対応する完全な DER エンコード済み RSA または ECDSA X.509 証明書 |
| SignatureAlgorithm | RSA PKCS#1 v1.5 は 1、DER エンコード ECDSA は 2、ECDSA P1363 は 3 で署名値は r || s |
| SignatureReserveBytes | 生の署名の予想上限、または証明書公開鍵から導出する場合は 0 |
戻り値
| 1 | 外部 ID 設定が関連付けられました |
|---|---|
| 0 | プロセス ID、証明書、アルゴリズム、または予約サイズが無効でした |
備考
署名プロセスを終了する前に、OnExternalDigestSign を割り当てるか、DLSetExternalDigestSignCallback を呼び出すか、SetExternalDigestSignCallback を使用して ActiveX コールバックオブジェクトを指定します
/Contents プレースホルダーのサイズ設定中はコールバックを呼び出さず、最終署名については正確に 1 回だけ呼び出します
PDF が受け入れられる前に、返された署名バイトが CertificateDER に照らして検証されます
処理が従来の adbe.pkcs7.sha1 既定値を引き続き使用している場合、このメソッドは adbe.pkcs7.detached を自動的に選択します
関連項目
OnExternalDigestSign、SetExternalDigestSignCallback、SetSignProcessContentsEstimate、SetSignProcessExternalDigestSignerFromFile