如何使用 GroupDocs.Signature for .NET 實作帶有時間戳記的 PDF 數位簽名

介紹

在當今的數位環境中，確保文件的真實性和完整性至關重要。無論您管理的是合約、法律文件還是敏感訊息，在 PDF 中添加數位簽名都能提供強大的安全性，並且易於驗證。透過整合來自可信任第三方服務的時間戳，可以進一步增強安全性。本教學將引導您使用 GroupDocs.Signature for .NET 在 PDF 文件中實作帶有時間戳記的數位簽章。

您將學到什麼

如何使用 GroupDocs.Signature for .NET 對 PDF 文件進行數位簽名
應用來自 SafeStamper 等外部服務的時間戳
設定環境和依賴項
解決實施過程中的常見問題

準備好使用數位簽章增強您的文件管理了嗎？讓我們先回顧一下先決條件。

先決條件

在開始之前，請確保您已準備好以下內容：

所需的函式庫、版本和相依性

適用於 .NET 的 GroupDocs.Signature：此程式庫對於處理 PDF 簽章操作至關重要。請驗證其與您的開發環境的兼容性。
PDF文檔：準備一份樣本文件（SamplePdf.pdf) 將被簽署。
數位憑證：獲得 .pfx 文件（例如， CertificatePfx.pfx）包含您的數位憑證及其密碼。

環境設定要求

確保您已準備好 .NET 開發環境。為了方便使用，建議使用 Visual Studio 或任何相容的 IDE。

知識前提

雖然對 C# 有基本的了解並熟悉數位憑證是有益的，但這並非強制性的，因為本指南將引導您完成每個步驟。

為 .NET 設定 GroupDocs.Signature

若要將 GroupDocs.Signature 納入您的項目，請依照以下安裝步驟操作：

.NET CLI

dotnet add package GroupDocs.Signature

套件管理器

Install-Package GroupDocs.Signature

NuGet 套件管理器 UI

開啟 NuGet 套件管理器。
搜尋“GroupDocs.Signature”。
安裝最新版本。

許可證獲取

免費試用：註冊 GroupDocs 網站下載免費試用許可證。
臨時執照：如果您需要的時間比試用期提供的時間更長，請申請臨時許可證。
購買：考慮購買長期專案的完整許可證。

基本初始化和設定

透過建立以下實例，在應用程式中初始化 GroupDocs.Signature Signature 類，並將其指向您的文件路徑。在這裡，我們將開始使用數位簽章和時間戳記對 PDF 進行簽名。

實施指南

讓我們將實作分解為可管理的部分：

1.建立數位簽章對象

首先為 PDF 文件設定數位簽章物件：

PdfDigitalSignature pdfDigitalSignature = new PdfDigitalSignature()
{
    ContactInfo = "Contact",
    Location = "Location",
    Reason = "Reason",
    TimeStamp = new TimeStamp("https://www.safestamper.com/tsa", "", "")
};

參數：
- ContactInfo， Location，和 Reason 為簽章提供元資料。
- TimeStamp 設定第三方時間戳機構 (TSA) URL，確保您的文件的簽署時間可驗證。

2. 配置數位看板選項

使用必要的參數設定您的數位憑證選項：

digitalSignOptions = new DigitalSignOptions(certificatePath)
{
    Password = "1234567890",
    Signature = pdfDigitalSignature,
    VerticalAlignment = VerticalAlignment.Bottom,
    HorizontalAlignment = HorizontalAlignment.Right
};

關鍵配置：
- Password 需要存取您的數位憑證中的私鑰。
- 調整 VerticalAlignment 和 HorizontalAlignment 將簽名定位在文件上。

3. 簽署文件

執行簽章流程，處理潛在異常：

try
{
    SignResult signResult = signature.Sign(outputFilePath, options);
    if (signResult != null)
    {
        Console.WriteLine($"Document signed successfully with {signResult.Succeeded.Count} signature(s).\nFile saved at {outputFilePath}. ");
        int number = 1;
        foreach (BaseSignature temp in signResult.Succeeded)
        {
            Console.WriteLine($"Signature #{number++}: Type: {temp.SignatureType} Id:{temp.SignatureId}, Location: {temp.Left}x{temp.Top}. Size: {temp.Width}x{temp.Height}");
        }
    }
}
catch (Exception ex)
{
    Console.WriteLine($"Unexpected error signing with TimeStamp {pdfDigitalSignature.TimeStamp.Url} : {ex.Message}");
}

處理例外：此區塊可擷取並記錄簽名過程中的任何錯誤。

實際應用

以下是一些現實世界場景，其中帶有時間戳的 PDF 數位簽名可能非常有價值：

合約管理：確保協議以數位方式簽署並驗證其真實性。
法律文件：安全地驗證法庭提交的文件和其他法律文件。
財務記錄：使用可驗證的時間戳記來保護發票或報稅表等財務文件。
與 CRM 系統集成：在客戶關係管理工具中自動化簽章流程，以提高工作流程效率。
教育認證：頒發具有數位簽名的文憑或證書，這些文憑或證書具有防篡改和時間戳，以確保真實性。

性能考慮

使用 GroupDocs.Signature 時最佳化應用程式的效能：

記憶體管理：確保利用資源進行妥善處置 using 語句，如程式碼片段所示。
批次處理：對於大量文檔，請考慮實施批次以有效地管理資源使用。
高效率的異常處理：策略性地使用 try-catch 區塊來處理異常，而不會顯著影響效能。

結論

帶有時間戳記的數位簽名徹底改變了文件安全性。使用 GroupDocs.Signature for .NET，您只需幾行程式碼即可自信地為 PDF 文件簽名並添加時間戳。本教學將幫助您掌握有效實現此功能的知識。

後續步驟

探索 GroupDocs.Signature 的其他功能，如二維碼或圖像簽名。
考慮將數位簽章工作流程整合到更大的業務應用程式中，以簡化操作。

準備好了嗎？立即實施您的解決方案，提昇文件安全性！

常見問題部分

使用數位簽名的時間戳有什麼好處？
- 時間戳可驗證文件的簽署時間，從而增加額外的真實性和法律地位。
如何解決簽名過程中的常見問題？
- 確保您的憑證有效且可訪問，驗證時間戳服務的網路連接，並檢查控制台輸出中是否有任何錯誤。
GroupDocs.Signature 能有效處理大型文件嗎？
- 是的，它旨在透過優化的記憶體管理實踐來處理大檔案。
使用 GroupDocs.Signature 是否需要付費？
- 雖然可以免費試用，但持續使用可能需要購買許可證才能獲得完整功能。
如何將 GroupDocs.Signature 整合到現有的 .NET 應用程式中？
- 按照本教學中提供的安裝和設定說明將其無縫地合併到您的專案中。

資源

文件： GroupDocs 簽署文檔
API 參考： GroupDocs API 參考