簡介

將 timestamped digital signature 添加到 PDF 不僅能證明作者身份,還能保證簽名在特定時間點存在。這對於必須證明文件長期有效性的法律、金融和合規情境至關重要。在本教程中,我們將展示如何在 C# 中使用 Aspose.PDF for .NET 實現時間戳簽名。關鍵詞 timestamped digital signatures 早期出現,以向搜索引擎和開發者表明本文的相關性。

為什麼帶時間戳的數位簽名很重要

一般的數位簽章將文件與憑證綁定,但憑證的有效性可能會變化——憑證會過期、被撤銷,或簽署機構可能遭到入侵。時間戳記授權機構 (Timestamp Authority, TSA) 會將受信任的時間戳記注入簽章,產生不可變更的證明,證明文件在任何潛在憑證問題發生之前已簽署。此機制可防止未來的爭議,並符合 eIDAS 與美國 ESIGN Act 等法規。透過嵌入 TSA 提供的時間戳記,您可以讓 PDF 未來安全,無需在憑證變更時重新簽署。

為何使用 Aspose.PDF for .NET

Aspose.PDF for .NET 是一個功能強大的庫,可在不需要 Adobe Acrobat 的情況下創建、操作和簽署 PDF 檔案。要開始使用,請通過 NuGet 安裝該庫:

Install-Package Aspose.PDF

安裝完成後,您可以參考 Aspose.PDF product page 上的 API 文件,以獲得詳細的類說明。我們將使用的關鍵類別如下:

  • Aspose.Pdf.Document – 表示 PDF 文件。
  • Aspose.Pdf.Facades.PdfFileSignature – 提供簽署功能。
  • Aspose.Pdf.Forms.PKCS7 – 封裝基於憑證的簽名。
  • Aspose.Pdf.TimestampSettings – 保存 TSA URL 和憑證。
  • System.Drawing.Rectangle – 定義簽名在頁面上的可視區域。

逐步教學:新增帶時間戳記的數位簽章

1. 準備環境並載入 PDF

  1. 建立一個新的 C# 主控台或 Windows 專案。
  2. 確保已參考 NuGet 套件。
  3. 將要簽署的 PDF 放置於已知資料夾中(例如,Data 目錄)。
  4. 安全地儲存您的簽署憑證(.pfx)和密碼。

以下範例示範如何使用 C# 和 Aspose.PDF 為 PDF 添加帶時間戳記的數位簽章。

// Load a PDF document from the file system
string dataDir = "./Data/"; // Adjust the path to your data folder
string pdfPath = Path.Combine(dataDir, "SimpleResume.pdf");

using (var document = new Aspose.Pdf.Document(pdfPath))
{
    // PDF is now loaded and ready for signing
    // Further steps will be performed inside this using block
}

說明:

  • dataDir 指向包含輸入檔案的資料夾。
  • Aspose.Pdf.Document 以可釋放的上下文開啟 PDF,確保資源被釋放。

2. 建立 PKCS#7 簽名物件並配置時間戳記

  1. 載入您的 .pfx 檔案和密碼。
  2. 使用這些憑證實例化 PKCS7。
  3. 建立指向可公開存取的 TSA 端點(例如 https://freetsa.org/tsr)的 TimestampSettings 物件。如果不需要驗證,您可以將第二個參數留空。
  4. 將 TimestampSettings 指派給 PKCS7 實例。

以下範例示範如何使用 C# 配置帶有 TSA 伺服器的 PKCS#7 簽章。

string pfxPath = Path.Combine(dataDir, "myCertificate.pfx");
string pfxPassword = "myPassword"; // Keep this secure!

// Create the PKCS#7 signature object using the certificate
var pkcs = new Aspose.Pdf.Forms.PKCS7(pfxPath, pfxPassword);

// Configure timestamp settings – replace URL with your TSA if needed
var timestampSettings = new Aspose.Pdf.TimestampSettings("https://freetsa.org/tsr", string.Empty);
pkcs.TimestampSettings = timestampSettings;

說明:

  • PKCS7 封裝了加密簽名所需的憑證和私鑰。
  • TimestampSettings 告訴 Aspose.PDF 在簽署過程中向指定的 TSA URL 請求時間戳記。
  • 將 TimestampSettings 指派給 PKCS7 實例後,使用此物件建立的每個簽名都會包含 TSA 提供的時間。

3. 定義簽名的視覺外觀

PDF 簽章可以具有可見的表示(簽章欄位)或是隱形的。此處我們將在第 1 頁上建立一個可見的矩形:

以下範例示範如何在第一頁上定義簽名矩形。

// Define a rectangle where the signature will appear (in points)
var rect = new System.Drawing.Rectangle(100, 100, 200, 100); // x, y, width, height

說明:

  • 矩形的座標使用 PDF 點系統(1 點 = 1/72 英吋)。
  • 調整 x 和 y 以將簽名欄位放置在頁面上您想要的位置。

4. 將簽名套用到文件

  1. 使用已載入的 Document 實例化 PdfFileSignature。
  2. 呼叫 Sign,傳入頁碼、原因、聯絡資訊、位置、一個指示簽章是否可見的布林值、矩形以及 PKCS7 物件。
  3. 最後,使用 PdfFileSignature.Save 儲存已簽署的文件。

以下範例示範如何套用時間戳記簽章並使用 C# 儲存 PDF。

using (var signature = new Aspose.Pdf.Facades.PdfFileSignature(document))
{
    // Sign page 1 with the configured PKCS7 (which includes timestamp settings)
    signature.Sign(
        pageNumber: 1,
        reason: "Approved by HR",
        contact: "hr@example.com",
        location: "New York, USA",
        visible: true,
        rect: rect,
        pkcs: pkcs);

    // Save the signed PDF to the output path
    string outputPath = Path.Combine(dataDir, "DigitallySignWithTimeStamp_out.pdf");
    signature.Save(outputPath);
}

說明:

  • PdfFileSignature.Sign 會在所選頁面上建立基於憑證的簽章。
  • reason、contact 和 location 為可選的中繼資料欄位,會顯示在簽章屬性中。
  • 將 visible 設為 true 會使簽章顯示在先前定義的矩形區域內。
  • 由於已設定 pkcs.TimestampSettings,Aspose.PDF 會在簽署過程中聯繫 TSA(https://freetsa.org/tsr),並將返回的時間戳記令牌嵌入簽章中。
  • 簽署後的檔案會寫入 DigitallySignWithTimeStamp_out.pdf。

5. 驗證簽名和時間戳 (可選)

簽署完成後,您可以在 Adobe Acrobat Reader 或任何支援簽章驗證的 PDF 檢視器中開啟產生的 PDF。前往簽章面板;您應該會看到時間戳記來源(例如 “freetsa.org”)以及簽章套用的確切時間。此步驟可確認 TSA 互動成功,且簽章在加密上是可靠且已加上時間戳記。

取得免費授權

Aspose 提供一個臨時評估許可證,可移除評估水印,讓您探索所有功能,包括帶時間戳記的簽署。立即在 臨時許可證頁面 獲取。

免費的額外資源

  • 文件說明 – 完整的指南與 API 使用範例可在此取得 Aspose.PDF for .NET docs。
  • API 參考 – 可在此探索詳細的方法簽名與類別階層 API reference。
  • 免費線上應用程式 – 使用免費的線上應用程式,無需編寫程式碼即可嘗試 PDF 簽署 Aspose Apps。

結論

時間戳記的數位簽章提供可靠的簽署時間證明,能在憑證過期與撤銷後仍然有效。使用 Aspose.PDF for .NET,您可以快速整合具備 TSA 支援的憑證簽署、定義可視化簽章區域,並產生符合標準的 PDF,以供長期保存。上述逐步指南從安裝到程式碼執行皆有說明,讓您能以程式方式保護 PDF 文件的安全。

常見問題

  1. 什麼是時間戳授權機構(TSA),以及為什麼需要它? TSA 提供可信的時間標記,證明簽名在特定時刻已存在,這對於在簽名證書過期或被撤銷時的長期驗證至關重要。

  2. 我可以使用任何 .pfx 證書進行簽署嗎? 是的,只要該證書受到驗證 PDF 的各方信任,任何包含私鑰和相應證書的有效 PKCS#12 (.pfx) 檔案皆可使用。

  3. 時間戳記會影響簽章的視覺外觀嗎? 不會。時間戳記嵌入在簽章的加密資料中,而視覺外觀(您定義的矩形)保持不變。

  4. 如何驗證時間戳記已成功套用? 在支援簽章驗證的 PDF 檢視器中開啟已簽署的 PDF(例如 Adobe Acrobat)。簽章屬性將顯示時間戳記的來源和時間。

  5. 是否可以使用相同的時間戳簽名對多個頁面進行簽署? 是的。您可以對每個需要簽署的頁面調用 PdfFileSignature.Sign,並重用帶有 TimestampSettings 的相同 PKCS#7 對象。

  6. 使用 TimestampSettings 是否需要付费许可证? TimestampSettings 可在 Aspose.PDF 的完整功能集中使用。您可以通过从 Aspose 网站获取的临时许可证进行评估。

Read More