如何使用 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}");
}

为什么： 显示签名信息可验证签名是否成功应用并提供审计记录。

实际应用

合同管理：安全签署合同可确保各方同意条款，而不会存在文件被篡改的风险。
法律文件：宣誓书等法律文件可以进行数字签名，从而确保跨司法管辖区的真实性。
教育认证：学校和大学可以颁发带有数字签名的证书以供验证。

性能考虑

优化签名处理：将签名应用限制在文档的必要页面或部分以提高性能。
资源管理：利用 .NET 中的高效内存管理实践，例如在使用后处置对象以释放资源。
批处理：对于大量文档，请考虑异步批量处理签名。

结论

使用 GroupDocs.Signature for .NET 掌握数字签名，将提供一套强大的工具集，有效保护和验证文档。通过本指南，您将学习如何应用高级签名选项以及如何以编程方式检索签名详细信息。

后续步骤：

探索其他功能 GroupDocs 文档.
针对不同的用例尝试不同的数字证书配置。
考虑将 GroupDocs.Signature 与您现有的文档管理系统集成，以增强工作流程自动化。

常见问题解答部分

什么是 GroupDocs.Signature？
- 一个允许 .NET 应用程序以数字方式签署文档的库，提供强大的安全功能。
如何自定义数字签名的外观？
- 利用以下属性 ImageFilePath， Border以及对齐选项 DigitalSignOptions 班级。
我可以仅将签名应用于特定页面吗？
- 是的，通过设置 AllPages 财产 false 并指定页码。