技術文章

在 Delphi 中使用 HotPDF 驗證 PDF 數位簽章

手刻的 PDF 簽章驗證器,可能把送進來的每一份正確簽署的檔案都拒收,而它對每個位元組的讀取都是正確的。它從 /Contents 拉出 CMS 區塊、定位已簽署屬性、按屬性的存放形式精確計算雜湊——然後 RSA 比對失敗。文件沒有問題。麻煩在一個位元組:SignerInfo 內的屬性標記為 [0] IMPLICIT,第一個位元組是 0xA0,而 RFC 5652 §5.4 說簽署者是對以 DER SET OF 編碼的同一內容計算簽章,其第一個位元組是 0x31。雜湊前把那個位元組換掉,「偽造」的簽章就轉為有效

這個標記錯位只是 PDF 簽章檢查可能出錯的第一處,其他幾處更不顯眼。簽章可以在一份簽署後又被編輯過的檔案上數學完美;也可以在一份被攻擊者用自制憑證重新簽署的文件上數學完美。交易對手寄回簽好的合約,你的工作流要歸檔,有人問:這是不是你寄出的那份文件、逐位元組一致、確實由它聲稱的憑證簽署?怎麼產出這些簽章,在 Delphi 中建立 PAdES 數位簽章的姊妹篇已經講過;這一篇走反方向,從一份已經簽好、送上門的檔案開始

被簽署的位元組住在 PDF 檔案的哪裡

PDF 簽章保護的是磁碟上檔案的位元組範圍,HotPDF 對著的正是那些位元組。ISO 32000-1 §12.8.1 把 CMS SignedData 容器(RFC 5652)放進簽章字典的 /Contents 條目,旁邊的 /ByteRange 陣列指名簽章涵蓋的區域。實務上陣列裡是兩組偏移量與長度配對:從偏移量 0 到 /Contents 十六進位字串之前的一切,以及它之後的一切。簽章無法涵蓋自己的值,所以檔案是繞著那個洞做雜湊的

對任何驗證器,這個後果很直白:你必須雜湊序列化的原始檔。解析過的物件模型在這裡幫不上忙,因為就連未動過的文件,重新寫出也會產生不同的位元組。HotPDF 因此讀取文件當初載入的來源檔案,或你提供的 TStream 原始位元組,從不對自己的記憶體表示做雜湊

HotPDF 在 Delphi 中驗證已簽署 PDF 的示意圖:對來源檔案 Contents 洞周圍的兩段 ByteRange 區段重新計算雜湊,解析後的記憶體模型絕不做雜湊,因為重新序列化會改變位元組
驗證按序列化原樣對來源位元組的兩段 ByteRange 區段計算雜湊;解析過的記憶體模型毫無用處,因為重新序列化連未變動的文件都會產生不同的位元組

那個洞本身就值得懷疑。簽署範圍之外的位元組,閱讀器仍可能解析;洞裡除了簽章值還裝別的東西,就是簽章包裹攻擊的開口。HotPDF 檢查 /ByteRange 從偏移量 0 起步、第二段在第一段結束之後才開始、兩段都不越出檔案邊界,以及洞裡除了本簽章自己的 /Contents 十六進位數字(可含其 < 和 > 分隔符)之外空無一物。任何一項不過,回傳 svInvalidByteRange——哪怕 CMS 數學本來會通過

在檢查任何東西之前,先讀出是誰簽的

GetLoadedSignatureInfo 解析簽章字典和它的 CMS 容器,不對任何文件位元組做雜湊,所以 UI 只需要顯示誰在何時簽署時,該呼叫它。簽章欄位按表單欄位順序從 0 起索引,GetLoadedSignatureFieldCount 回傳數量。越界的索引拋出例外而不是回傳空記錄,所以照計數跑迴圈

回傳的 THPDFSignatureInfo 記錄帶著欄位名稱、/SubFilter、簽署者憑證的一般名稱、主體與簽發者辨別名稱、十六進位的序號、憑證有效期,以及簽署時間——優先取自已簽署屬性,沒有時取字典的 /M 條目。它也回報摘要與公鑰演算法名稱、/Reason、/Location、/ContactInfo 字串,以及 CertificateTimeValidity——簽署時間落在憑證有效期之外時亮旗。Status 保持 svNotVerified:已解析,未檢查。簽章 API 位於 Delphi 2009 與後續版本的編譯器守衛之後

var
  Pdf: THotPDF;
  Info: THPDFSignatureInfo;
  I: Integer;
begin
  Pdf := THotPDF.Create(nil);
  try
    Pdf.LoadFromFile('signed-contract.pdf');
    for I := 0 to Pdf.GetLoadedSignatureFieldCount - 1 do
    begin
      Info := Pdf.GetLoadedSignatureInfo(I);
      Writeln('Field:     ', Info.FieldName);
      Writeln('Signer:    ', Info.SignerName);
      Writeln('Issuer:    ', Info.IssuerDN);
      Writeln('Key/hash:  ', Info.PublicKeyAlgorithm, ' / ', Info.HashAlgorithm);
      Writeln('SubFilter: ', Info.SubFilter);
      if Info.CertificateTimeValidity = stvSigningTimeOutsideCertificate then
        Writeln('Signing time is outside the certificate validity period');
    end;
  finally
    Pdf.Free;
  end;
end;

用 VerifyLoadedSignatureEx 跑密碼學檢查

VerifyLoadedSignatureEx 對檔案載入的文件跑完整檢查,並在同一個呼叫裡回傳填好的資訊記錄。它重開來源檔、驗證 /ByteRange、用 SignerInfo 的摘要演算法對兩個區段做雜湊、與 messageDigest 已簽署屬性比對,然後用內嵌簽署者憑證的公鑰,對已簽署屬性的 DER SET OF 形式驗證簽章值。簽章不帶已簽署屬性時,改為直接對文件雜湊跑 RSA 或 ECDSA 檢查

演算法涵蓋範圍跟著簽署工具實際產出的東西走。摘要包括 SHA-1、SHA-256、SHA-384、SHA-512、SHA-3 家族與 SHAKE256;簽章可以是 PKCS#1 v1.5 或 PSS 填補的 RSA、具名曲線上的 ECDSA,以及 Ed25519 與 Ed448。ECDSA 驗證用 Windows CNG 提供者,Ed25519 與 Ed448 走由 Windows CNG 或 OpenSSL 函式庫支撐的平台提供者,所以在所需提供者載入不起來的機器上,結果是 svUnsupportedAlgorithm 或 svCryptoProviderError,而不是對檔案的判決。需要指向特定的 OpenSSL 函式庫、或插入自己的 THPDFSignatureProvider 時,VerifyLoadedSignatureWithOptions 接受一份 THPDFCMSVerifyOptions 記錄

HotPDF for Delphi 的 VerifyLoadedSignatureEx 管線示意圖:重開來源檔、對 ByteRange 區段計算雜湊、與 CMS messageDigest 已簽署屬性比對,再用簽署者憑證公鑰驗證簽章,產出 svValid、svDigestMismatch 或 svSignatureInvalid
VerifyLoadedSignatureEx 對 ByteRange 區段重新雜湊、與 messageDigest 已簽署屬性比對、對已簽署屬性的 DER SET 驗證簽章,然後回報 svValid 或具體的失敗狀態
var
  Status: THPDFSignatureVerifyStatus;
  Info: THPDFSignatureInfo;
begin
  Status := Pdf.VerifyLoadedSignatureEx(0, Info);
  case Status of
    svValid:
      if Info.CoversWholeDocument then
        Writeln('Valid; signature covers the whole file')
      else
        Writeln('Valid; ', Info.UnsignedTrailingBytes,
          ' bytes were appended after signing');
    svDigestMismatch:
      Writeln('Document bytes changed after signing');
    svSignatureInvalid:
      Writeln('Hash matches, signature value does not verify');
    svInvalidByteRange:
      Writeln('ByteRange is malformed or the gap holds extra bytes');
    svDigestAlgorithmMismatch:
      Writeln('CMS digest algorithm identifiers disagree');
    svUnsupportedAlgorithm, svCryptoProviderError:
      Writeln('Cannot evaluate this key or digest here');
    svMalformed:
      Writeln('CMS container could not be parsed');
    svSourceUnavailable:
      Writeln('No source bytes; use the TStream overload');
  else
    Writeln('Status ', Ord(Status));
  end;
end;

兩個解析細節解釋了從外部看起來很玄的失敗。第一個是開頭段落那次重新標記:HotPDF 對已簽署屬性做雜湊時,把前導位元組改寫成 0x31,正是 RFC 5652 §5.4 規定的做法。第二個是填充。簽署工具在簽章誕生前就為 /Contents 保留固定的位元組預算、把沒用到的尾巴填零,所以驗證器在走訪前,先把解碼後的區塊裁到其外層 DER SEQUENCE 的真實長度。/Contents 裡一串結尾零是正常的。同一族 ASN.1 解析風險從憑證匯入那側看的版本,是Delphi 中的 PKCS#12 與 ASN.1 安全強化一文的主題

沿途還有幾項更嚴格的檢查。SignerInfo 裡的摘要演算法必須與 SignedData 摘要清單、簽章演算法識別碼以及任何 CMS 演算法保護屬性一致,否則狀態為 svDigestAlgorithmMismatch。已簽署屬性必須恰好含一個與被簽內容相符的 content-type 屬性,否則 svMalformed。CMS 帶內嵌的 RFC 3161 簽章時間戳時,該權杖對著簽章值驗證並回報在 Info.Timestamp;ETSI.RFC3161 文件時間戳以同樣方式對被雜湊的位元組範圍驗證

svValid 到底證明了什麼?

svValid 意味兩件事:/ByteRange 指名的位元組雜湊出簽署者簽下的那個值,且該簽章在 CMS 容器內嵌憑證的公鑰下驗證通過。位元組完整性,加上金鑰綁定。它對「那把金鑰屬於誰」隻字未提。改了合約再拿自制憑證重新簽署的攻擊者,同樣拿到 svValid——數學內部自洽——而 SignerName 欄位顯示的,是攻擊者填進憑證的任何名字

CoversWholeDocument 補上第二個缺口。PDF 增量更新允許寫入端在簽章之後附加內容而不破壞它,這是設計使然,也是多重簽章工作流的運作方式。該旗標在驗證時計算,只有兩段加 /Contents 洞涵蓋整個檔案時才為真。SignedRevisionLength 給出被簽署前綴的大小,UnsignedTrailingBytes 給出其後附加的位元組數。一份在 52,300 位元組檔案裡宣告 48,000 位元組已簽修訂版的檔案,UnsignedTrailingBytes 是 4,300,CoversWholeDocument 是 false

HotPDF 簽章驗證中 svValid 保證範圍的示意圖:ByteRange 位元組完整性與金鑰綁定;鏈的走訪、撤銷與信任存放區屬於獨立的信任檢查,CoversWholeDocument 標記簽署後附加的增量更新
svValid 意味位元組完整性加金鑰綁定,僅此而已;鏈的走訪、撤銷與信任錨屬於另一場信任檢查,CoversWholeDocument=false 則代表簽署後有位元組被附加進來

檔案庫入庫管線不該單憑 svValid 加 CoversWholeDocument 為 false 就照單全收。先跑 AnalyzeLoadedSignatureRevisions:它對所選簽章之後附加的每個修訂版分類、在 ChangedFieldNames 列出被改動的欄位名稱,並經 DocMDPCompliant 和 FieldMDPCompliant 回報那些變更是否尊重簽署者設下的 DocMDP 與 FieldMDP 權限。在空簽章欄位裡補一個後續簽章是常規操作;改寫頁面物件的修訂版不是,分析裡的 ChangeKinds 正是區分這兩種情況的依據

拿你自己的信任錨檢驗簽署者

在 HotPDF 裡,信任是另一個呼叫,而這個切分是正確的預設。VerifyLoadedSignatureWithTrust 先跑同一套位元組範圍驗證,失敗則回傳 cvsSignatureInvalid,然後從簽署者向你傳入 THPDFCertificateValidationOptions.TrustAnchors 的錨建立憑證路徑。沿途評估撤銷證據:文件 DSS 和 /VRI 字典裡存放的 OCSP 回應與 CRL 自動收集,你在 OCSPResponses 或 CRLs 裡提供的則併入同一池

uses
  System.IOUtils;

var
  Options: THPDFCertificateValidationOptions;
  Info: THPDFSignatureInfo;
  Trust: THPDFCertificateValidationStatus;
begin
  Options := THPDFCertificateValidationOptions.Default;
  SetLength(Options.TrustAnchors, 1);
  // DER 編碼的根憑證;載入前先把 PEM 檔轉換格式
  Options.TrustAnchors[0] := TFile.ReadAllBytes('company-root.cer');
  Options.RevocationMode := rvmBestEffort;

  Trust := Pdf.VerifyLoadedSignatureWithTrust(0, Options, Info);
  if Trust = cvsTrusted then
    Writeln('Signed by a certificate chaining to our root')
  else
    Writeln('Not trusted: ', Info.CertificateValidation.Issue);
end;

撤銷模式是政策選擇。rvmBestEffort 有什麼證據用什麼、找不到就繼續走;rvmRequire 把缺證據變成 cvsRevocationUnknown。要經得起多年後稽核的合約,rvmRequire 是更穩的設定——前提是你的簽署者在簽署當下嵌入了 OCSP 或 CRL 資料;檔案裡沒有那個證據,每份文件都會回報 cvsRevocationUnknown

串流載入的文件為什麼回報 svSourceUnavailable?

檔案後盾的呼叫——單引數的 VerifyLoadedSignature、VerifyLoadedSignatureEx,以及檔案後盾的 VerifyLoadedSignatureWithTrust——需要元件記得文件來自哪個檔案。以 LoadFromStream 載入的文件沒有可重開的檔名。加密文件的密碼重載之後也一樣——Delphi 中的 AES-256 PDF 加密一文描述過——因為元件解密完文件就丟掉了對來源檔的引用。兩種情況下,檔案後盾的多載都回傳 svSourceUnavailable,不瞎猜

TStream 多載則從你保存原始位元組的任何地方取用:檔案、記憶體緩衝、資料庫 blob。雜湊之後串流位置會復原,同一條串流可以依次傳給多個簽章索引。VerifyAllLoadedSignatures 只在至少存在一個簽章欄位、且每個欄位都驗證為 svValid 時回傳 true,它走檔案後盾路徑,所以在串流載入的文件上無論簽章內容如何都回傳 false。請改為對串流多載跑迴圈

function AllSignaturesValid(Pdf: THotPDF; Src: TStream): Boolean;
// 給讀者自己加的輔助函式:LoadFromStream 載入文件的
// VerifyAllLoadedSignatures 串流版等價物
var
  I, Count: Integer;
  Info: THPDFSignatureInfo;
begin
  Count := Pdf.GetLoadedSignatureFieldCount;
  Result := Count > 0;
  for I := 0 to Count - 1 do
    if Pdf.VerifyLoadedSignature(I, Src, Info) <> svValid then
    begin
      Writeln(Info.FieldName, ': status ', Ord(Info.Status));
      Exit(False);
    end;
end;

位元組範圍驗證、信任錨路徑建立、PAdES 簽署與 AES-256 加密都住在同一個供 Delphi 與 C++Builder 使用的原生 VCL 函式庫裡,RSA 雜湊與填補檢查以 Pascal 程式碼完成;版本編制、支援的 IDE 版本與更完整的功能清單,見 HotPDF Delphi Component 產品頁