如何使用 GroupDocs.Signature for .NET 實作加密元資料簽名

介紹

在當今的數位時代，確保文件的安全性和真實性至關重要。無論您處理的是合約、法律協議還是其他任何敏感訊息，加密在保護您的資料免遭未經授權的存取方面都發揮著至關重要的作用。本指南將引導您使用 GroupDocs.Signature for .NET（一個旨在簡化文件簽章流程的強大函式庫）實作加密元資料簽章。

您將學到什麼：

  • 如何建立自訂元資料簽章類
  • 加密元資料簽章以增強安全性
  • 在您的專案中設定並初始化 GroupDocs.Signature for .NET
  • 加密元資料簽章的實際範例

透過本教學課程，您將獲得將安全簽名功能整合到應用程式中所需的技能。在開始之前，讓我們先來了解先決條件。

先決條件

在開始之前，請確保您已具備以下條件：

  • 庫和版本：您需要適用於 .NET 的 GroupDocs.Signature，它可以透過 .NET CLI 或套件管理器安裝。
  • 環境設定：需要.NET環境（最好是.NET Core 3.1或更高版本）。
  • 知識前提：熟悉 C# 程式設計並對加密概念有基本的了解將會很有幫助。

為 .NET 設定 GroupDocs.Signature

首先，您需要在專案中安裝 GroupDocs.Signature 庫。以下是一些不同的安裝方法：

.NET CLI

dotnet add package GroupDocs.Signature

套件管理器

Install-Package GroupDocs.Signature

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

許可證獲取

要使用 GroupDocs.Signature，您可以：

  • 免費試用：下載免費試用版來測試該程式庫的功能。
  • 臨時執照：在評估期間取得臨時許可證以存取全部功能。
  • 購買：購買許可證以供長期使用。

基本初始化和設定

安裝完成後，請在應用程式中初始化 GroupDocs.Signature。以下是基本設定：

using GroupDocs.Signature;

// 初始化簽名實例
Signature signature = new Signature("sample.docx");

實施指南

我們將把實作分為兩個主要功能：建立自訂元資料簽章並對其進行加密。

特性1：自訂資料簽章類

概述：此功能可讓您定義自訂資料類別來儲存簽名元數據，該元資料可以序列化並包含在您的文件簽章中。

逐步實施

創建 DocumentSignatureData 班級

首先定義一個保存元資料的類別：

using System;
using GroupDocs.Signature.Domain;

public class DocumentSignatureData
{
    [Format("SignID")]
    public string ID { get; set; }

    [Format("SAuth")]
    public string Author { get; set; }

    [Format("SDate", "yyyy-MM-dd")]
    public DateTime Signed { get; set; }

    [Format("SDFact", "N2")]
    public decimal DataFactor { get; set; }

    [SkipSerialization]
    public string Comments { get; set; }
}
  • 解釋：每個屬性都帶有註釋 Format 定義它在元資料中的顯示方式。 Comments 字段被排除在序列化之外 [SkipSerialization]。

功能2：帶有加密的元資料簽名

概述：此功能演示了使用加密元資料簽署文檔，透過確保只有授權方可以解密和讀取簽名資料來增強安全性。

逐步實施

加密元資料簽名

  1. 設定密鑰和密碼

    定義您的加密金鑰和鹽：

    string key = "1234567890";
string salt = "1234567890";

  2. 建立資料加密對象

    使用對稱加密來加密您的元資料：

    IDataEncryption encryption = new SymmetricEncryption(SymmetricAlgorithmType.Rijndael, key, salt);

  3. 配置元資料簽章選項

    設定簽名選項並將其與加密物件關聯：

    MetadataSignOptions options = new MetadataSignOptions()
{
    DataEncryption = encryption
};

  4. 建立自訂簽章資料對象

    實例化您的自訂元資料類別：

    DocumentSignatureData documentSignatureData = new DocumentSignatureData()
{
    ID = Guid.NewGuid().ToString(),
    Author = Environment.UserName,
    Signed = DateTime.Now,
    DataFactor = 11.22M
};

  5. 定義元資料簽名

    建立元資料簽名並將其新增至您的選項：

    WordProcessingMetadataSignature mdSignature = new WordProcessingMetadataSignature("Signature", documentSignatureData);
WordProcessingMetadataSignature mdAuthor = new WordProcessingMetadataSignature("Author", "Mr.Scherlock Holmes");
WordProcessingMetadataSignature mdDocId = new WordProcessingMetadataSignature("DocumentId", Guid.NewGuid().ToString());

options.Add(mdSignature).Add(mdAuthor).Add(mdDocId);

  6. 簽署文件

    最後，簽署您的文件並儲存：

    SignResult signResult = signature.Sign("output.docx", options);

實際應用

以下是加密元資料簽章的一些實際用例：

  1. 法律合約：使用包含簽署者資訊和時間戳記的元資料安全地簽署合約。
  2. 財務文件：透過加密與交易相關的元資料來保護敏感的財務資料。
  3. 醫療記錄：透過使用加密元資料簽署文件來確保患者的隱私。

性能考慮

為了優化使用 GroupDocs.Signature for .NET 時的效能：

  • 資源使用情況：監控記憶體使用情況，尤其是在處理大量文件時。
  • 最佳實踐：正確處置簽章物件以釋放資源。
  • 優化技巧：盡可能使用非同步方法來提高應用程式的回應能力。

結論

在本教學中，我們探討如何使用 GroupDocs.Signature for .NET 實作加密元資料簽章。請依照以下步驟操作，您可以增強文件簽章流程的安全性和完整性。如需進一步探索，您可以考慮將 GroupDocs.Signature 與其他系統集成，或探索該庫提供的其他功能。

常見問題部分

  1. 什麼是 GroupDocs.Signature？
    • 用於在 .NET 應用程式中向文件新增簽署的綜合庫。
  2. 如何安裝 GroupDocs.Signature？
    • 使用 .NET CLI、套件管理器或 NuGet 套件管理器 UI，如上所示。
  3. 我可以使用元資料簽章加密嗎？
    • 是的，使用像 Rijndael 這樣的對稱加密可以確保元資料簽署的安全性。
  4. 加密元資料簽章有什麼好處？
    • 它們確保只有授權方才能存取簽署數據，從而提供了額外的安全層。
  5. 在哪裡可以找到有關 GroupDocs.Signature 的更多資源？
    • 存取資源部分提供的官方文件和 API 參考連結。

資源