字簽名深度解析：CAdES簽名、證書驗證與簽署修訂分析完整指南)
KillerPDF數(shù)字簽名深度解析CAdES簽名、證書驗證與簽署修訂分析完整指南【免費下載鏈接】KillerPDFFree and open-source PDF editor for Windows with a built-in PDF 2.0 engine. View, annotate, OCR, merge, split, crop, rotate, compare, edit text, draw, sign, fill forms, print, flatten, and open password-protected PDFs without a subscription.項目地址: https://gitcode.com/gh_mirrors/ki/KillerPDFKillerPDF 是一款免費開源的 Windows PDF 編輯器內置自研 PDF 2.0 引擎支持數(shù)字簽名CAdES 分離式簽名、證書驗證與簽署后的修訂分析無需訂閱即可為合同、表單簽署具有法律效力的電子簽名并審查簽名之后文檔被改動過的每個對象。本文帶你從界面操作到源碼實現(xiàn)完整看懂 KillerPDF 數(shù)字簽名的三層架構簽署、驗證、修訂分析。手寫簽名 ≠ 數(shù)字簽名先弄清兩者的區(qū)別KillerPDF 里有兩種容易混淆的簽名簽名印章工具Signature Stamp手繪一筆簽名或導入圖片放到頁面上本質是一張注釋圖片沒有密碼學效力數(shù)字簽名Digital Signature使用 X.509 證書 私鑰對文檔字節(jié)做 SHA-256 摘要并生成 CAdES 分離式 CMS 簽名任何字節(jié)被篡改都會導致驗簽失敗。簽署入口在 SignDocumentDialog.cs 中定義注釋里明確寫了這一點它是真正的數(shù)字簽名與只放置圖片的手繪簽名印章工具不同。一鍵簽署 PDF證書從哪來、簽名放哪里兩種證書來源.pfx 文件 或 Windows 證書存儲簽署對話框SignDocumentDialog.cs提供兩個單選項從文件加載選擇.pfx/.p12證書文件并輸入密碼由 PfxFileCertificateProvider.cs 以Exportable | PersistKeySet方式加載保證簽名器能訪問私鑰從 Windows 個人證書存儲選擇WindowsCertificateStore.cs 會枚舉當前用戶My存儲中所有帶私鑰且 Key Usage 允許數(shù)字簽名的證書供界面下拉選擇。兩個實現(xiàn)都通過統(tǒng)一接口 ICertificateProvider.cs 暴露——注釋說明這是刻意為之讓證書存儲這種 Windows 專屬的部分隔離在最外層為未來的 Linux/macOS 移植留好空間?？梢姾灻庥^與簽署元數(shù)據(jù)勾選顯示可見簽名后你可以指定簽署頁碼與位置左下 / 右下 / 左上 / 右上簽名框尺寸與字號最小 72×36 點字號 6–72 點見 TryBuildVisibleAppearance簽名文本模板支持{name}、{date}、{reason}、{location}占位符實時預覽ExpandAppearanceText。原因Reason、位置Location、聯(lián)系方式ContactInfo三項元數(shù)據(jù)會原樣寫入簽名字典收件人打開 PDF 時可直接看到。簽署完成后KillerPDF 會另存一份新的-signed.pdf副本原文檔保持不變。CAdES 分離式簽名是如何寫入 PDF 的簽署流程的核心是 PdfSigner.cs加載文檔 → 用證書構建 CMS 簽名器 → 調用引擎的 PdfDetachedSignatureWriter.Sign 輸出簽署后的完整字節(jié)流。第一步生成 CAdES 分離式 CMS 簽名KillerCmsSigner.cs 只有 30 多行卻完成了最關鍵的密碼學動作用SignedCms(content, detached: true)創(chuàng)建分離式簽名——摘要內容不在 CMS 包里而是在 PDF 字節(jié)里摘要算法固定為SHA-256OID2.16.840.1.101.3.4.2.1IncludeOption WholeChain把整條證書鏈嵌入簽名ComputeSignature(signer, silent: false)特意傳silent: false這樣硬件令牌或云 KSP 需要 PIN 時可以彈出確認提示。第二步ByteRange 占位符與增量修訂PDF 簽名有個雞生蛋問題簽名值要寫進文檔但簽名值又要基于寫簽名值之前的文檔計算。KillerPDF 的解法是兩步填充FillSignature先建增量修訂寫入簽名字典SubFilter固定為ETSI.CAdES.detachedBuildSignatureDictionaryByteRange先填四個哨兵值111111111 / 222222222 / 333333333 / 444444444Contents預留一塊定長十六進制空格再回填真實偏移用交叉引用表定位簽名對象把真實字節(jié)偏移寫回ByteRange固定 10 位十進制避免寬度變化拼接兩段字節(jié)計算摘要把 CMS 簽名以大寫十六進制寫進預留區(qū)不足部分補0。這就是為什么你看到已簽名的 PDF 尾部總是...FF /ByteRange [0 12345 6789 54321]——中間那段空隙就是被簽名的縫。還有一組嚴謹?shù)氖匦l(wèi)規(guī)則PdfDetachedSignatureWriter在寫入前會攔截大量非法場景Sign 入口場景處理方式字段已簽過名拒絕提示already signed文檔已是認證文檔存在 DocMDP只允許通過既有簽名域追加簽署認證權限為禁止一切變更P1拒絕任何后續(xù)修改密碼權限不足用戶口令打開按表單填寫/文檔修改權限分別攔截簽署域帶 /SV 種子值逐位校驗 SubFilter、摘要算法、理由、證書策略、時間戳服務器等約束EnforceSeedValue標簽化 PDF有 StructTreeRoot自動為簽名域建立結構樹關聯(lián)AddTaggedSignatureAssociation保持無障礙結構完整證書驗證完整性與信任是兩回事驗證端在引擎的 PdfSignatureVerifier.cs 提供兩個層次的 API這正是理解 PDF 驗簽的關鍵VerifyIntegrity完整性驗證只回答簽名覆蓋的字節(jié)有沒有被動過、簽名值能否通過密碼學校驗不檢查證書是否被系統(tǒng)信任VerifyTrust信任驗證在完整性之上再調用CheckSignature(verifySignatureOnly: false)走系統(tǒng)證書鏈校驗證書過期、被吊銷、自簽名不受信都會在這里暴露。注意它的容錯設計Verify 方法信任校驗失敗時不會直接判整個簽名無效而是返回結構有效 密碼學有效 信任檢查失敗的組合結果——因為證書不受信和文檔被篡改是兩種完全不同的安全結論使用者需要看到差異。結構層驗證由 PdfSignatureReader.cs 完成它會把簽名域解析成一份 PdfSignatureInfo 記錄逐項檢查ByteRange是否有序、有界、且間隙恰好等于Contents字符串GapIsExactContentsStringContents去掉填充后是否是唯一的 ASN.1 CMS 值簽名是否覆蓋整個修訂CoversWholeDocumentDocMDP / FieldMDP 轉換參數(shù)認證級別、字段鎖定動作 All/Include/Exclude、鎖定字段名單。驗證通過后GetSignedContent 按 ByteRange 精確拼接出被簽名的兩段字節(jié)交給SignedCms.CheckSignature完成最終比對。簽署修訂分析簽名之后誰動了文檔這是 KillerPDF 最有工程價值的一塊PdfSignedRevisionAnalyzer.cs。簽名后的 PDF 允許以增量修訂追加內容分析器會回答簽名之后到底發(fā)生了什么切出簽署前綴取ByteRange覆蓋的字節(jié)區(qū)間嘗試獨立打開為一個完整 PDF驗證簽署修訂本身是合法 PDF枚舉后續(xù)修訂找出所有偏移量位于簽名區(qū)間之后的交叉引用段統(tǒng)計LaterRevisionCount對象級差異對比新舊交叉引用把變更對象分成四類——新增AddedObjectNumbers、更新UpdatedObjectNumbers、釋放FreedObjectNumbers及全部變更清單認證權限評估PermissionAssessment文檔未認證 →NotCertified無后續(xù)變更 →NoLaterChanges認證級別為 P1 →Prohibited任何后續(xù)變更都違規(guī)其他級別 →RequiresSemanticReview提示需人工判斷變更是否在允許范圍內。結果封裝在 PdfSignedRevisionAnalysis.cs 中HasLaterChanges屬性只需比較文檔當前長度與簽署修訂長度即可判斷簽名后是否被追加過任何字節(jié)。配合 PDF 對比視圖你可以直觀看到每一處改動模塊路徑速查去哪里讀源碼功能位置簽署對話框證書選擇、可見簽名預覽Controls/SignDocumentDialog.cs應用層簽署編排Services/Signing/PdfSigner.csSHA-256 分離式 CMS 生成Services/Signing/KillerCmsSigner.cspfx 證書 / Windows 證書存儲Services/Signing/PfxFileCertificateProvider.cs、WindowsCertificateStore.csCAdES 簽名寫入ByteRange、增量修訂engine/KillerPdf.Engine/Signing/PdfDetachedSignatureWriter.cs簽名讀取與結構驗證engine/KillerPdf.Engine/Signing/PdfSignatureReader.cs完整性 / 信任雙級驗證engine/KillerPdf.Engine/Signing/PdfSignatureVerifier.cs簽署修訂分析與權限評估engine/KillerPdf.Engine/Signing/PdfSignedRevisionAnalyzer.cs引擎簽名模塊測試engine/KillerPdf.Engine.Tests/Signing/應用層簽署測試KillerPDF.Tests/PdfSignerTests.cs小結KillerPDF 的數(shù)字簽名實現(xiàn)可以概括為三條清晰的主線簽署走ETSI.CAdES.detached分離式簽名 ByteRange 占位回填兼容硬件令牌與嚴格種子值約束驗證把完整性與證書信任拆成兩級結論避免不受信被誤讀為被篡改修訂分析把簽名后的增量修訂還原成新增/更新/釋放三類對象清單并給出 DocMDP 認證權限下的保守評估。三者分別位于應用層Services/Signing/與引擎層engine/KillerPdf.Engine/Signing/配合 docs/engine 目錄下的編輯文檔說明足以覆蓋從入門使用到源碼研讀的完整路徑?！久赓M下載鏈接】KillerPDFFree and open-source PDF editor for Windows with a built-in PDF 2.0 engine. View, annotate, OCR, merge, split, crop, rotate, compare, edit text, draw, sign, fill forms, print, flatten, and open password-protected PDFs without a subscription.項目地址: https://gitcode.com/gh_mirrors/ki/KillerPDF創(chuàng)作聲明：本文部分內容由AI輔助生成（AIGC），僅供參考 KillerPDF數(shù)字簽名深度解析：CAdES簽名、證書驗證與簽署修訂分析完整指南
KillerPDF數(shù)字簽名深度解析CAdES簽名、證書驗證與簽署修訂分析完整指南【免費下載鏈接】KillerPDFFree and open-source PDF editor for Windows with a built-in PDF 2.0 engine. View, annotate, OCR, merge, split, crop, rotate, compare, edit text, draw, sign, fill forms, print, flatten, and open password-protected PDFs without a subscription.項目地址: https://gitcode.com/gh_mirrors/ki/KillerPDFKillerPDF 是一款免費開源的 Windows PDF 編輯器內置自研 PDF 2.0 引擎支持數(shù)字簽名CAdES 分離式簽名、證書驗證與簽署后的修訂分析無需訂閱即可為合同、表單簽署具有法律效力的電子簽名并審查簽名之后文檔被改動過的每個對象。本文帶你從界面操作到源碼實現(xiàn)完整看懂 KillerPDF 數(shù)字簽名的三層架構簽署、驗證、修訂分析。手寫簽名 ≠ 數(shù)字簽名先弄清兩者的區(qū)別KillerPDF 里有兩種容易混淆的簽名簽名印章工具Signature Stamp手繪一筆簽名或導入圖片放到頁面上本質是一張注釋圖片沒有密碼學效力數(shù)字簽名Digital Signature使用 X.509 證書 私鑰對文檔字節(jié)做 SHA-256 摘要并生成 CAdES 分離式 CMS 簽名任何字節(jié)被篡改都會導致驗簽失敗。簽署入口在 SignDocumentDialog.cs 中定義注釋里明確寫了這一點它是真正的數(shù)字簽名與只放置圖片的手繪簽名印章工具不同。一鍵簽署 PDF證書從哪來、簽名放哪里兩種證書來源.pfx 文件 或 Windows 證書存儲簽署對話框SignDocumentDialog.cs提供兩個單選項從文件加載選擇.pfx/.p12證書文件并輸入密碼由 PfxFileCertificateProvider.cs 以Exportable | PersistKeySet方式加載保證簽名器能訪問私鑰從 Windows 個人證書存儲選擇WindowsCertificateStore.cs 會枚舉當前用戶My存儲中所有帶私鑰且 Key Usage 允許數(shù)字簽名的證書供界面下拉選擇。兩個實現(xiàn)都通過統(tǒng)一接口 ICertificateProvider.cs 暴露——注釋說明這是刻意為之讓證書存儲這種 Windows 專屬的部分隔離在最外層為未來的 Linux/macOS 移植留好空間?？梢姾灻庥^與簽署元數(shù)據(jù)勾選顯示可見簽名后你可以指定簽署頁碼與位置左下 / 右下 / 左上 / 右上簽名框尺寸與字號最小 72×36 點字號 6–72 點見 TryBuildVisibleAppearance簽名文本模板支持{name}、{date}、{reason}、{location}占位符實時預覽ExpandAppearanceText。原因Reason、位置Location、聯(lián)系方式ContactInfo三項元數(shù)據(jù)會原樣寫入簽名字典收件人打開 PDF 時可直接看到。簽署完成后KillerPDF 會另存一份新的-signed.pdf副本原文檔保持不變。CAdES 分離式簽名是如何寫入 PDF 的簽署流程的核心是 PdfSigner.cs加載文檔 → 用證書構建 CMS 簽名器 → 調用引擎的 PdfDetachedSignatureWriter.Sign 輸出簽署后的完整字節(jié)流。第一步生成 CAdES 分離式 CMS 簽名KillerCmsSigner.cs 只有 30 多行卻完成了最關鍵的密碼學動作用SignedCms(content, detached: true)創(chuàng)建分離式簽名——摘要內容不在 CMS 包里而是在 PDF 字節(jié)里摘要算法固定為SHA-256OID2.16.840.1.101.3.4.2.1IncludeOption WholeChain把整條證書鏈嵌入簽名ComputeSignature(signer, silent: false)特意傳silent: false這樣硬件令牌或云 KSP 需要 PIN 時可以彈出確認提示。第二步ByteRange 占位符與增量修訂PDF 簽名有個雞生蛋問題簽名值要寫進文檔但簽名值又要基于寫簽名值之前的文檔計算。KillerPDF 的解法是兩步填充FillSignature先建增量修訂寫入簽名字典SubFilter固定為ETSI.CAdES.detachedBuildSignatureDictionaryByteRange先填四個哨兵值111111111 / 222222222 / 333333333 / 444444444Contents預留一塊定長十六進制空格再回填真實偏移用交叉引用表定位簽名對象把真實字節(jié)偏移寫回ByteRange固定 10 位十進制避免寬度變化拼接兩段字節(jié)計算摘要把 CMS 簽名以大寫十六進制寫進預留區(qū)不足部分補0。這就是為什么你看到已簽名的 PDF 尾部總是...FF /ByteRange [0 12345 6789 54321]——中間那段空隙就是被簽名的縫。還有一組嚴謹?shù)氖匦l(wèi)規(guī)則PdfDetachedSignatureWriter在寫入前會攔截大量非法場景Sign 入口場景處理方式字段已簽過名拒絕提示already signed文檔已是認證文檔存在 DocMDP只允許通過既有簽名域追加簽署認證權限為禁止一切變更P1拒絕任何后續(xù)修改密碼權限不足用戶口令打開按表單填寫/文檔修改權限分別攔截簽署域帶 /SV 種子值逐位校驗 SubFilter、摘要算法、理由、證書策略、時間戳服務器等約束EnforceSeedValue標簽化 PDF有 StructTreeRoot自動為簽名域建立結構樹關聯(lián)AddTaggedSignatureAssociation保持無障礙結構完整證書驗證完整性與信任是兩回事驗證端在引擎的 PdfSignatureVerifier.cs 提供兩個層次的 API這正是理解 PDF 驗簽的關鍵VerifyIntegrity完整性驗證只回答簽名覆蓋的字節(jié)有沒有被動過、簽名值能否通過密碼學校驗不檢查證書是否被系統(tǒng)信任VerifyTrust信任驗證在完整性之上再調用CheckSignature(verifySignatureOnly: false)走系統(tǒng)證書鏈校驗證書過期、被吊銷、自簽名不受信都會在這里暴露。注意它的容錯設計Verify 方法信任校驗失敗時不會直接判整個簽名無效而是返回結構有效 密碼學有效 信任檢查失敗的組合結果——因為證書不受信和文檔被篡改是兩種完全不同的安全結論使用者需要看到差異。結構層驗證由 PdfSignatureReader.cs 完成它會把簽名域解析成一份 PdfSignatureInfo 記錄逐項檢查ByteRange是否有序、有界、且間隙恰好等于Contents字符串GapIsExactContentsStringContents去掉填充后是否是唯一的 ASN.1 CMS 值簽名是否覆蓋整個修訂CoversWholeDocumentDocMDP / FieldMDP 轉換參數(shù)認證級別、字段鎖定動作 All/Include/Exclude、鎖定字段名單。驗證通過后GetSignedContent 按 ByteRange 精確拼接出被簽名的兩段字節(jié)交給SignedCms.CheckSignature完成最終比對。簽署修訂分析簽名之后誰動了文檔這是 KillerPDF 最有工程價值的一塊PdfSignedRevisionAnalyzer.cs。簽名后的 PDF 允許以增量修訂追加內容分析器會回答簽名之后到底發(fā)生了什么切出簽署前綴取ByteRange覆蓋的字節(jié)區(qū)間嘗試獨立打開為一個完整 PDF驗證簽署修訂本身是合法 PDF枚舉后續(xù)修訂找出所有偏移量位于簽名區(qū)間之后的交叉引用段統(tǒng)計LaterRevisionCount對象級差異對比新舊交叉引用把變更對象分成四類——新增AddedObjectNumbers、更新UpdatedObjectNumbers、釋放FreedObjectNumbers及全部變更清單認證權限評估PermissionAssessment文檔未認證 →NotCertified無后續(xù)變更 →NoLaterChanges認證級別為 P1 →Prohibited任何后續(xù)變更都違規(guī)其他級別 →RequiresSemanticReview提示需人工判斷變更是否在允許范圍內。結果封裝在 PdfSignedRevisionAnalysis.cs 中HasLaterChanges屬性只需比較文檔當前長度與簽署修訂長度即可判斷簽名后是否被追加過任何字節(jié)。配合 PDF 對比視圖你可以直觀看到每一處改動模塊路徑速查去哪里讀源碼功能位置簽署對話框證書選擇、可見簽名預覽Controls/SignDocumentDialog.cs應用層簽署編排Services/Signing/PdfSigner.csSHA-256 分離式 CMS 生成Services/Signing/KillerCmsSigner.cspfx 證書 / Windows 證書存儲Services/Signing/PfxFileCertificateProvider.cs、WindowsCertificateStore.csCAdES 簽名寫入ByteRange、增量修訂engine/KillerPdf.Engine/Signing/PdfDetachedSignatureWriter.cs簽名讀取與結構驗證engine/KillerPdf.Engine/Signing/PdfSignatureReader.cs完整性 / 信任雙級驗證engine/KillerPdf.Engine/Signing/PdfSignatureVerifier.cs簽署修訂分析與權限評估engine/KillerPdf.Engine/Signing/PdfSignedRevisionAnalyzer.cs引擎簽名模塊測試engine/KillerPdf.Engine.Tests/Signing/應用層簽署測試KillerPDF.Tests/PdfSignerTests.cs小結KillerPDF 的數(shù)字簽名實現(xiàn)可以概括為三條清晰的主線簽署走ETSI.CAdES.detached分離式簽名 ByteRange 占位回填兼容硬件令牌與嚴格種子值約束驗證把完整性與證書信任拆成兩級結論避免不受信被誤讀為被篡改修訂分析把簽名后的增量修訂還原成新增/更新/釋放三類對象清單并給出 DocMDP 認證權限下的保守評估。三者分別位于應用層Services/Signing/與引擎層engine/KillerPdf.Engine/Signing/配合 docs/engine 目錄下的編輯文檔說明足以覆蓋從入門使用到源碼研讀的完整路徑?！久赓M下載鏈接】KillerPDFFree and open-source PDF editor for Windows with a built-in PDF 2.0 engine. View, annotate, OCR, merge, split, crop, rotate, compare, edit text, draw, sign, fill forms, print, flatten, and open password-protected PDFs without a subscription.項目地址: https://gitcode.com/gh_mirrors/ki/KillerPDF創(chuàng)作聲明：本文部分內容由AI輔助生成（AIGC），僅供參考