如何使用 GroupDocs.Signature for .NET 實作 .NET 數位簽名

介紹

在數位時代，確保文件的真實性和完整性至關重要。無論是處理法律合約還是正式協議，使用數位簽名保護文件安全都能防止篡改，並在相關方之間建立信任。本指南將向您展示如何使用 GroupDocs.Signature for .NET 實作具有進階選項的數位簽名，從而為文件安全挑戰提供強大的解決方案。

您將學到什麼：

  • 如何使用數位憑證對 PDF 和其他文件進行數位簽章。
  • 配置簽名的外觀和對齊方式。
  • 檢索已簽署文件中套用的簽章的資訊。

在深入了解本綜合指南之前，讓我們確保您的環境已正確設定。

先決條件

要有效實現 GroupDocs.Signature for .NET：

所需的庫和依賴項

  • 適用於 .NET 的 GroupDocs.Signature：確保您安裝了最新版本。
  • .NET Framework 4.6.1 或更高版本。

環境設定要求

  • 啟用了 .NET 桌面開發工作負載的 Visual Studio（2017 或更高版本）。

知識前提

  • 對 C# 和 .NET 程式設計有基本的了解。
  • 熟悉用於簽署文件的數位憑證。

為 .NET 設定 GroupDocs.Signature

使用以下方法之一在您的專案中安裝 GroupDocs.Signature 庫：

.NET CLI

dotnet add package GroupDocs.Signature

套件管理器控制台

Install-Package GroupDocs.Signature

NuGet 套件管理器 UI

  • 搜尋“GroupDocs.Signature”並安裝最新版本。

許可證取得步驟

  • 免費試用：從下載免費試用版 這裡.
  • 臨時執照：取得臨時許可證，以無限制地探索全部功能 此連結.
  • 購買：如需長期使用，請購買許可證 這裡.

基本初始化和設定

要在您的應用程式中初始化 GroupDocs.Signature：

using GroupDocs.Signature;

// 使用文檔路徑初始化簽名對象
string filePath = "path/to/your/document.pdf";
using (Signature signature = new Signature(filePath))
{
    // 準備簽名！
}

實施指南

功能：具有特定選項的數位簽名

此功能可讓您使用特定的配置和視覺增強功能對文件進行數位簽章。

概述

透過套用數位簽名，您可以確保文件得到安全簽名。本節示範如何使用數位憑證對文件進行簽名，並提供各種自訂選項，例如影像表示、對齊方式和邊框樣式。

實施步驟

步驟 1：載入文件並初始化簽名對象
using GroupDocs.Signature;

string filePath = "@YOUR_DOCUMENT_DIRECTORY/SAMPLE_PDF";
using (Signature signature = new Signature(filePath))
{
    // 繼續配置簽名選項
}

為什麼： 載入文件至關重要，因為它初始化應用數位簽章的環境。

第 2 步：設定數位簽章選項
using GroupDocs.Signature.Options;

DigitalSignOptions options = new DigitalSignOptions("@YOUR_DOCUMENT_DIRECTORY/CertificatePfx")
{
    Password = "1234567890", // 證書密碼
    Reason = "Approved",
    Contact = "John Smith",
    Location = "New York",
    ImageFilePath = "@YOUR_DOCUMENT_DIRECTORY/ImageStamp", // 簽名可選圖片
    AllPages = true,
    Width = 160,
    Height = 80,
    VerticalAlignment = GroupDocs.Signature.Domain.HorizontalAlignment.Center,
    HorizontalAlignment = GroupDocs.Signature.Domain.HorizontalAlignment.Left,
    Margin = new Padding { Bottom = 10, Right = 10 },
    Border = new GroupDocs.Signature.Options.Border
    {
        Visible = true,
        Color = System.Drawing.Color.Red,
        DashStyle = System.Drawing.Drawing2D.DashStyle.DashDot,
        Weight = 2
    }
};

為什麼： 配置這些選項可以自訂簽名的外觀並確保其滿足可見性、對齊和美觀性等特定要求。

步驟 3：簽署文件並儲存
string outputFilePath = Path.Combine("@YOUR_OUTPUT_DIRECTORY", "SignWithDigitalAdvanced", Path.GetFileName(filePath));

// 執行簽名操作並儲存簽名文檔
SignResult signResult = signature.Sign(outputFilePath, options);

為什麼： 執行簽名過程將套用所有配置的設定來產生安全簽名的文件。

功能：顯示簽名結果

此功能檢索有關應用於文件的簽名的信息，提供對每個簽名的屬性的洞察。

概述

了解已套用簽署的詳細資訊有助於驗證其正確性及其是否符合要求。本節介紹如何有效地提取和顯示這些數據。

實施步驟

步驟 1：載入簽名文檔
using GroupDocs.Signature;

string filePath = "@YOUR_OUTPUT_DIRECTORY/SIGN_WITH_DIGITAL_ADVANCED/SAMPLE_PDF";
using (Signature signature = new Signature(filePath))
{
    // 從文件中檢索簽名
}

為什麼： 載入簽署的文件對於存取和檢查其簽名詳細資訊至關重要。

步驟2：提取並顯示簽名訊息
using GroupDocs.Signature.Domain;

SignResult signResult = signature.GetSignatures();

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}");
}

為什麼： 顯示簽名資訊可驗證簽名是否成功應用並提供稽核記錄。

實際應用

  1. 合約管理：安全簽署合約可確保各方同意條款，而不會有文件被竄改的風險。
  2. 法律文件：宣誓書等法律文件可以進行數位簽名，從而確保跨司法管轄區的真實性。
  3. 教育認證：學校和大學可以頒發帶有數位簽名的證書以供驗證。

性能考慮

  • 優化簽章處理：將簽名應用程式限制在文件的必要頁面或部分以提高效能。
  • 資源管理：利用 .NET 中的高效記憶體管理實踐，例如在使用後處置物件以釋放資源。
  • 批次處理：對於大量文檔，請考慮非同步批次處理簽名。

結論

使用 GroupDocs.Signature for .NET 掌握數位簽名，將提供一套強大的工具集，有效保護和驗證文件。透過本指南，您將學習如何應用高級簽名選項以及如何以程式設計方式檢索簽名詳細資訊。

後續步驟：

  • 探索其他功能 GroupDocs 文檔.
  • 針對不同的用例嘗試不同的數位憑證配置。
  • 考慮將 GroupDocs.Signature 與您現有的文件管理系統集成，以增強工作流程自動化。

常見問題部分

  1. 什麼是 GroupDocs.Signature？
    • 一個允許 .NET 應用程式以數位方式簽署文件的程式庫，提供強大的安全功能。
  2. 如何自訂數位簽章的外觀？
    • 利用以下屬性 ImageFilePath， Border以及對齊選項 DigitalSignOptions 班級。
  3. 我可以僅將簽名套用到特定頁面嗎？
    • 是的，透過設定 AllPages 財產 false 並指定頁碼。