如何使用 GroupDocs.Signature for .NET 对 PDF 进行元数据和加密签名

介绍

您是否正在寻找一个强大的解决方案，以便在 .NET 中使用元数据和加密技术安全地签署 PDF 文档？在本指南中，我们将探讨如何使用 GroupDocs.Signature for .NET 来实现这一目标。从设置环境到执行签名流程，我们将逐步讲解每个步骤，确保您的数据安全且可验证。

您将学到什么：

如何在 C# 中使用自定义数据类定义元数据
使用加密创建元数据签名
使用 GroupDocs.Signature for .NET 签署 PDF 文档
设置环境并集成库

让我们深入了解如何利用这款强大的工具进行安全文档签名。但首先，请阅读下方的先决条件部分，确保您已做好准备。

先决条件

在开始为 .NET 实现 GroupDocs.Signature 之前，请确保您具备以下条件：

所需的库和版本

GroupDocs.签名：确保您安装的版本与您的项目设置兼容。

环境设置要求

您的系统上安装了 .NET Framework 或 .NET Core。

知识前提

熟悉C#编程语言。
对以编程方式处理 PDF 文档有基本的了解。

为 .NET 设置 GroupDocs.Signature

要开始使用 GroupDocs.Signature，您需要将其安装到您的项目中。以下是可用的不同方法：

使用 .NET CLI：

dotnet add package GroupDocs.Signature

使用包管理器：

Install-Package GroupDocs.Signature

NuGet 包管理器 UI：

打开 NuGet 包管理器。
搜索“GroupDocs.Signature”并安装最新版本。

许可证获取

您可以获取免费试用版或临时许可证，以探索 GroupDocs.Signature 的所有功能。如需长期使用，请考虑购买许可证：

免费试用：免费下载
临时执照：在此请求
购买许可证：立即购买

获取许可证后，在项目中初始化 GroupDocs.Signature 以开始使用其功能。

实施指南

元数据签名数据类

概述： 定义一个数据类，用于保存签名所需的元数据信息。该类将用于保存各种属性，例如 ID、作者、签名日期以及特定格式的数据因子 (DataFactor)。

步骤 1：定义数据类

using System;

namespace 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; }
    }
}

解释：

ID， Author， Signed，和 DataFactor 是使用以下方式定义的具有特定格式的属性 [Format]。
此设置可确保元数据的签名格式一致。

元数据签名创建和加密

概述： 了解如何使用 Rijndael 对称加密算法创建和加密元数据签名。

第 2 步：设置对称加密

using System;
using GroupDocs.Signature;

namespace MetadataSignatureCreation
{
    public class CreateMetadataSignatures
    {
        string key = "1234567890"; // 在生产中使用安全密钥
        string salt = "1234567890"; // 在生产中使用安全的盐

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

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

        PdfMetadataSignature mdDocument = new PdfMetadataSignature("DocumentSignature", documentSignature);
        mdDocument.DataEncryption = encryption;

        PdfMetadataSignature mdAuthor = new PdfMetadataSignature("Author", "Mr.Sherlock Holmes");
        mdAuthor.DataEncryption = encryption;

        PdfMetadataSignature mdDocId = new PdfMetadataSignature("DocumentId", Guid.NewGuid().ToString());
        mdDocId.DataEncryption = encryption;
    }
}

解释：

SymmetricEncryption 设置了密钥和盐，确保元数据的安全加密。
为文档详细信息和作者信息创建元数据签名。

使用元数据签名对 PDF 进行签名

概述： 使用 GroupDocs.Signature 库实现签名过程，以使用准备好的元数据签名对您的 PDF 文档进行签名。

步骤 3：签署 PDF

using System.IO;
using GroupDocs.Signature;
using GroupDocs.Signature.Options;

namespace SignPdfWithMetadata
{
    public class SignPdf
    {
        string filePath = Path.Combine("YOUR_DOCUMENT_DIRECTORY", "sample.pdf");
        string fileName = Path.GetFileName(filePath);
        string outputFilePath = Path.Combine("YOUR_OUTPUT_DIRECTORY", "SignPdfWithCustomMetadata", fileName);

        public void Execute()
        {
            using (Signature signature = new Signature(filePath))
            {
                MetadataSignOptions options = new MetadataSignOptions();

                CreateMetadataSignatures signer = new CreateMetadataSignatures();
                options.Add(signer.mdDocument);
                options.Add(signer.mdAuthor);
                options.Add(signer.mdDocId);

                SignResult signResult = signature.Sign(outputFilePath, options);
            }
        }
    }
}

解释：

这 Signature 该类使用 PDF 文件路径进行初始化。
MetadataSignOptions 用于添加元数据签名以进行签名。
签名后的文档保存在指定的输出路径。

实际应用

真实用例

法律文件签署：使用加密元数据自动签署合同和协议，以增强安全性。
发票管理：对发票进行数字签名，安全地嵌入客户和交易详细信息。
颁发认证证书：颁发包含颁发日期和收件人信息等加密元数据的证书。

集成可能性

与 CRM 系统集成以自动化签名工作流程。
与文档管理解决方案相结合，实现签名文档的安全存档。

性能考虑

使用 GroupDocs.Signature 时，请考虑以下性能提示：

通过在使用后及时处置资源来优化内存使用。
在高负载环境中利用异步签名操作。
定期更新库以受益于性能改进和新功能。

结论

在本指南中，我们探讨了如何使用 GroupDocs.Signature for .NET 对带有元数据和加密的 PDF 文档进行签名。按照以下步骤操作，您可以确保您的数字签名安全且合规。

后续步骤：

尝试不同的元数据配置。
通过查看文档来探索 GroupDocs.Signature 的其他功能。

准备好尝试了吗？在您的下一个项目中实施此解决方案，以增强文档安全性！

常见问题解答部分

问题 1：我可以将 GroupDocs.Signature 用于大型 PDF 文件吗？ A1：是的，它旨在高效处理大文件。请确保您拥有足够的系统资源。

问题 2：如何解决签名错误？ A2：请检查您的文件路径，并确保所有依赖项均已正确安装。具体错误代码请参考文档。

Q3：我可以自定义加密算法吗？ A3：虽然推荐使用 Rijndael，但您可以参考 GroupDocs.Signature 文档来探索其他支持的算法。