Documentation – PdfFileSignature 类

Python-Net: 签署 PDF 文档

Mon, 08 Jun 2026 00:00:00 +0000

Aspose.PDF for Python via .NET 提供了 PdfFileSignature 用于对现有 PDF 文档应用数字签名的门面。使用证书文件，您可以以编程方式签署文档，将签名放置在页面上，分配签名元数据，并自定义签名的显示方式。

本文演示了几种常见的签名工作流：

创建并绑定一个 PdfFileSignature 对象到输入的 PDF。
配置签名证书。
在目标页面上应用数字签名。
可选地分配签名名称和可见外观。
保存已签名的 PDF。

准备可重用的签名助手

在对 PDF 应用数字签名之前，设置一小组可重用的帮助函数是有益的。这些帮助函数会初始化签名处理器，定义可见签名区域，配置证书，并构建可重用的 PKCS#7 签名对象，从而使下面的签名示例保持自包含且更易于理解。

import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as apd


DEFAULT_CERTIFICATE_PASSWORD = "Aspose2021"
DEFAULT_SIGNATURE_NAME = "Signature1"


def create_pdf_file_signature(infile):
    pdf_signature = pdf_facades.PdfFileSignature()
    pdf_signature.bind_pdf(infile)
    return pdf_signature


def create_signature_rectangle():
    return apd.Rectangle(10, 10, 200, 60)


def configure_signature_certificate(
    pdf_signature, certificate_path, certificate_password=DEFAULT_CERTIFICATE_PASSWORD
):
    pdf_signature.set_certificate(certificate_path, certificate_password)


def create_pkcs7_signature(
    certificate_path, certificate_password=DEFAULT_CERTIFICATE_PASSWORD
):
    signature = ap.forms.PKCS7(certificate_path, certificate_password)
    signature.reason = "Document approval"
    signature.contact_info = "qa@example.com"
    signature.location = "New York, USA"
    signature.authority = "Aspose.PDF Example"
    return signature


def create_custom_signature_appearance():
    appearance = ap.forms.SignatureCustomAppearance()
    appearance.font_family_name = "Arial"
    appearance.font_size = 10
    appearance.show_contact_info = True
    appearance.show_location = True
    appearance.show_reason = True
    return appearance

使用基本证书参数签署 PDF

此方法将证书直接配置在 PdfFileSignature 对象。当您希望使用标准签名元数据的直接签名流程且不需要单独的签名对象管理时，这非常有用。

import aspose.pdf.facades as pdf_facades
import sys
from os import path


def sign_pdf_with_basic_parameters(infile, outfile, certificate_path):
    pdf_signature = create_pdf_file_signature(infile)
    try:
        configure_signature_certificate(pdf_signature, certificate_path)
        pdf_signature.sign(
            1,
            "Document approval",
            "qa@example.com",
            "New York, USA",
            False,
            create_signature_rectangle(),
        )
        pdf_signature.save(outfile)
    finally:
        pdf_signature.close()

使用 PKCS7 对象签署 PDF

使用一个 PKCS7 对象当你需要先准备签名然后将其传入签名调用时使用。这种模式让你对签名设置有更多控制，并且是更高级工作流的良好基础。

import aspose.pdf.facades as pdf_facades
import sys
from os import path


def sign_pdf_with_certificate_object(infile, outfile, certificate_path):
    pdf_signature = create_pdf_file_signature(infile)
    try:
        signature = create_pkcs7_signature(certificate_path)
        pdf_signature.sign(1, False, create_signature_rectangle(), signature)
        pdf_signature.save(outfile)
    finally:
        pdf_signature.close()

使用具名签名对 PDF 进行签署

如果您的文档工作流依赖于预定义的签名字段名称，请将该名称传递给 sign(). 这使得随后在验证、处理或与批准工作流集成时更容易引用该签名。

import aspose.pdf.facades as pdf_facades
import sys
from os import path


def sign_pdf_with_named_signature(infile, outfile, certificate_path):
    pdf_signature = create_pdf_file_signature(infile)
    try:
        signature = create_pkcs7_signature(certificate_path)
        signature.reason = "Approved by signing workflow"
        pdf_signature.sign(
            1,
            DEFAULT_SIGNATURE_NAME,
            "Approved by signing workflow",
            "qa@example.com",
            "New York, USA",
            True,
            create_signature_rectangle(),
            signature,
        )
        pdf_signature.save(outfile)
    finally:
        pdf_signature.close()

应用可见签名

您可以通过为其分配自定义外观，使签名在 PDF 页面上可见 PKCS7 对象。当输出文档需要向最终用户显示批准详情（例如原因、位置和联系信息）时，这非常有用。

import aspose.pdf.facades as pdf_facades
import sys
from os import path


def apply_visible_signature(infile, outfile, certificate_path):
    pdf_signature = create_pdf_file_signature(infile)
    try:
        signature = create_pkcs7_signature(certificate_path)
        signature.reason = "Visible approval signature"
        signature.custom_appearance = create_custom_signature_appearance()
        pdf_signature.sign(
            1,
            "Visible approval signature",
            "qa@example.com",
            "New York, USA",
            True,
            create_signature_rectangle(),
            signature,
        )
        pdf_signature.save(outfile)
    finally:
        pdf_signature.close()

Python-Net: PDF 认证

Mon, 08 Jun 2026 00:00:00 +0000

Aspose.PDF for Python via .NET 允许您通过应用文档级签名来认证 PDF 文档， PdfFileSignature。认证不同于标准批准签名，因为它定义了在文档已被认证后，是否允许进行哪些更改。

本文演示了两种常见的认证工作流：

对 PDF 进行认证，并在认证后允许填写表单。
对 PDF 进行认证，并阻止任何进一步的更改。

对 PDF 进行表单填写认证

当文档应保持已认证状态，但用户仍需完成交互式表单或继续对文件进行签名时，请使用此方法。该 FILLING_IN_FORMS 权限级别允许这些受控更改，同时保持认证有效。

import aspose.pdf.facades as pdf_facades
import sys
from os import path


def certify_pdf_with_mdp_signature(infile, outfile, certificate_path):
    pdf_signature = create_pdf_file_signature(infile)
    try:
        doc_mdp_signature = create_doc_mdp_signature(
            certificate_path,
            ap.forms.DocMDPAccessPermissions.FILLING_IN_FORMS,
            reason="Certified for form filling and signing",
        )
        pdf_signature.certify(
            1,
            "Certified for form filling and signing",
            "security@example.com",
            "New York, USA",
            True,
            create_signature_rectangle(),
            doc_mdp_signature,
        )
        pdf_signature.save(outfile)
    finally:
        pdf_signature.close()

应用文档级别的认证，且不允许更改

使用此模式，当经认证的文档在认证后必须保持不变时。The NO_CHANGES 权限级别适用于已完成的 PDF，在以后进行任何修改时应使认证状态失效。

import aspose.pdf.facades as pdf_facades
import sys
from os import path


def apply_document_level_certification(infile, outfile, certificate_path):
    pdf_signature = create_pdf_file_signature(infile)
    try:
        doc_mdp_signature = create_doc_mdp_signature(
            certificate_path,
            ap.forms.DocMDPAccessPermissions.NO_CHANGES,
            reason="Certified with no further changes allowed",
        )
        pdf_signature.certify(
            1,
            "Certified with no further changes allowed",
            "security@example.com",
            "New York, USA",
            True,
            create_signature_rectangle(),
            doc_mdp_signature,
        )
        pdf_signature.save(outfile)
    finally:
        pdf_signature.close()

Python-Net: 修订和权限

Mon, 08 Jun 2026 00:00:00 +0000

Aspose.PDF for Python via .NET 提供了 PdfFileSignature 用于处理已签名和已认证 PDF 文档的外观层。除了添加签名外，您还可以检查签名元数据，以了解文档包含多少次修订以及认证后允许进行哪些更改。

此示例演示了三项常见的检查任务：

获取现有签名的修订号。
获取已签名文档中的修订总数。
读取已认证 PDF 的访问权限。

获取签名的修订号

当 PDF 已经包含一个或多个签名且您需要识别与特定签名关联的修订时，请使用此方法。示例解析第一个可用的签名名称，然后调用 get_revision().

import aspose.pdf.facades as pdf_facades
import sys
from os import path


def get_signature_revision(infile):
    pdf_signature = create_pdf_file_signature(infile)
    try:
        sign_name = require_signature_name(pdf_signature)
        signature_revision = pdf_signature.get_revision(sign_name)
        print(f"Signature Revision for '{sign_name}': {signature_revision}")
    finally:
        pdf_signature.close()

获取文档修订的总数

使用 get_total_revision() 当您需要了解已签名的 PDF 中存储了多少修订时。这对于检查文档在原始签名应用后是否经过了多次更新非常有用。

import aspose.pdf.facades as pdf_facades
import sys
from os import path


def get_total_document_revisions(infile):
    pdf_signature = create_pdf_file_signature(infile)
    try:
        total_revisions = pdf_signature.get_total_revision()
        print(f"Total Document Revisions: {total_revisions}")
    finally:
        pdf_signature.close()

获取已认证 PDF 的访问权限

已认证的文档可以定义在认证后允许进行的更改。使用 get_access_permissions() 检查该权限级别并确定文档是否不允许任何更改、仅允许填写表单或其他受控修改。

import aspose.pdf.facades as pdf_facades
import sys
from os import path


def get_access_permissions(infile):
    pdf_signature = create_pdf_file_signature(infile)
    try:
        access_permissions = pdf_signature.get_access_permissions()
        print(f"Access Permissions: {access_permissions}")
    finally:
        pdf_signature.close()

Python-Net: 签名提取

Mon, 08 Jun 2026 00:00:00 +0000

Aspose.PDF for Python via .NET 提供了 PdfFileSignature 用于检查和提取已签名 PDF 文档数据的外观接口。PDF 签名后，您可以使用它导出签名资源，例如可视签名图像和与签名关联的证书。

本示例演示了两项常见的提取任务：

提取与签名关联的可视图像。
从已签名的 PDF 中提取签名证书。

提取签名图像

当 PDF 包含可见签名且您想导出其图像数据时使用此方法。示例打开已签名的文档，获取第一个可用的签名名称，提取图像流，并将其写入文件。

import aspose.pdf.facades as pdf_facades
import sys
from os import path


def extract_signature_image(infile, outfile):
    pdf_signature = create_pdf_file_signature(infile)
    try:
        sign_name = require_signature_name(pdf_signature)
        signature_image = pdf_signature.extract_image(sign_name)
        write_stream_data(signature_image, outfile)
    finally:
        pdf_signature.close()

提取签名证书

使用 extract_certificate() 当您需要将证书数据附加到签名时。这对于检查、验证工作流或将签名者证书与 PDF 文档分开存储非常有用。

import aspose.pdf.facades as pdf_facades
import sys
from os import path


def extract_signature_certificate(infile, outfile):
    pdf_signature = create_pdf_file_signature(infile)
    try:
        sign_name = require_signature_name(pdf_signature)
        signature_certificate = pdf_signature.extract_certificate(sign_name)
        write_stream_data(signature_certificate, outfile)
    finally:
        pdf_signature.close()

Python-Net: 签名信息

Mon, 08 Jun 2026 00:00:00 +0000

Aspose.PDF for Python via .NET 提供了 PdfFileSignature 用于检查 PDF 文档中数字签名的外观层。文档签署后，您可以使用它读取签名名称并检索元数据，如签署人姓名、联系信息、签署时间、原因和位置。

本示例演示了四个常见的签名信息任务：

列出已签名 PDF 中的所有签名名称。
读取所选签名的签署人详细信息。
获取签署日期和时间。
读取签名原因和位置。

获取签名名称

当 PDF 可能包含一个或多个签名且您想检查哪些签名条目可用时，请使用此方法。示例打开文档并打印返回的列表。 get_sign_names().

import aspose.pdf.facades as pdf_facades
import sys
from os import path


def get_signature_names(infile):
    pdf_signature = create_pdf_file_signature(infile)
    try:
        signature_names = list_signature_names(pdf_signature)
        print(f"Signature Names: {signature_names}")
    finally:
        pdf_signature.close()

获取签署者详细信息

一旦您知道签名名称，就可以检索特定签名者的元数据。本示例读取文档中第一个可用签名的签名者姓名和联系信息。

import aspose.pdf.facades as pdf_facades
import sys
from os import path


def get_signer_details(infile):
    pdf_signature = create_pdf_file_signature(infile)
    try:
        sign_name = require_signature_name(pdf_signature)
        signer_name = pdf_signature.get_signer_name(sign_name)
        contact_info = pdf_signature.get_contact_info(sign_name)
        print(
            f"Signer Details for '{sign_name}': "
            f"signer_name={signer_name}, contact_info={contact_info}"
        )
    finally:
        pdf_signature.close()

获取签名日期和时间

使用 get_date_time() 用于确定特定签名何时被应用。这对于审计以及在文档工作流中显示签名历史非常有用。

import aspose.pdf.facades as pdf_facades
import sys
from os import path


def get_signature_date_and_time(infile):
    pdf_signature = create_pdf_file_signature(infile)
    try:
        sign_name = require_signature_name(pdf_signature)
        signature_date = pdf_signature.get_date_time(sign_name)
        print(f"Signature Date and Time for '{sign_name}': {signature_date}")
    finally:
        pdf_signature.close()

获取签名原因和位置

数字签名还可以存储描述性元数据，例如签名原因和位置。本例检索所选签名的这两个值并将它们一起打印。

import aspose.pdf.facades as pdf_facades
import sys
from os import path


def get_signature_reason_and_location(infile):
    pdf_signature = create_pdf_file_signature(infile)
    try:
        sign_name = require_signature_name(pdf_signature)
        signature_reason = pdf_signature.get_reason(sign_name)
        signature_location = pdf_signature.get_location(sign_name)
        print(
            f"Signature Reason and Location for '{sign_name}': "
            f"reason={signature_reason}, location={signature_location}"
        )
    finally:
        pdf_signature.close()

Python-Net: 签名完整性检查

Mon, 08 Jun 2026 00:00:00 +0000

Aspose.PDF for Python via .NET 提供了 PdfFileSignature 用于验证已签署 PDF 文档的外观层。文件签署后，你可以使用它检查签名是否适用于完整文档以及已签署内容是否仍然有效。

此示例演示了两种常见的完整性检查：

检查签名是否覆盖整个文档。
验证已签名 PDF 内容的完整性。

检查签名是否覆盖整个文档

使用 covers_whole_document() 当您需要确认签名适用于完整的 PDF，而不仅仅是其内容的一部分时。示例读取第一个可用的签名名称并检查其覆盖范围。

import aspose.pdf.facades as pdf_facades
import sys
from os import path


def check_signature_coverage(infile):
    pdf_signature = create_pdf_file_signature(infile)
    try:
        sign_name = require_signature_name(pdf_signature)
        covers_document = pdf_signature.covers_whole_document(sign_name)
        print(f"Signature '{sign_name}' covers the whole document: {covers_document}")
    finally:
        pdf_signature.close()

验证文档完整性

使用 verify_signed() 以确认签名后文档内容未被更改。此方法有助于验证文档在所选签名下是否仍然有效。

import aspose.pdf.facades as pdf_facades
import sys
from os import path


def validate_document_integrity(infile):
    pdf_signature = create_pdf_file_signature(infile)
    try:
        sign_name = require_signature_name(pdf_signature)
        is_valid = pdf_signature.verify_signed(sign_name)
        print(f"Document integrity for '{sign_name}' is valid: {is_valid}")
    finally:
        pdf_signature.close()

Python-Net: 签名管理

Mon, 08 Jun 2026 00:00:00 +0000

Aspose.PDF for Python via .NET 提供了 PdfFileSignature 用于处理 PDF 文档中现有数字签名的外观层。除了读取和验证签名外，当工作流需要更新已签署的内容或清除签名字段时，您也可以删除签名。

此示例演示了两个常见的签名管理任务：

从 PDF 文档中移除签名。
移除签名并清理相关的签名字段。

从 PDF 中移除签名

使用 remove_signature() 当您想要从文档中删除选定的签名，同时保留底层签名字段结构时。示例打开已签名的 PDF，解析签名名称，将其移除，并保存更新后的输出文件。

import aspose.pdf.facades as pdf_facades
import sys
from os import path


def remove_signature_from_pdf(infile, outfile):
    pdf_signature = create_pdf_file_signature(infile)
    try:
        sign_name = require_signature_name(pdf_signature)
        pdf_signature.remove_signature(sign_name)
        pdf_signature.save(outfile)
    finally:
        pdf_signature.close()

删除签名并清理字段

使用带有附加的 True 当您想要删除签名并清理相关签名字段时使用此标记。此功能在签名删除后不希望该字段保留在文档中时非常有用。

import aspose.pdf.facades as pdf_facades
import sys
from os import path


def remove_signature_with_field_cleanup(infile, outfile):
    pdf_signature = create_pdf_file_signature(infile)
    try:
        sign_name = require_signature_name(pdf_signature)
        pdf_signature.remove_signature(sign_name, True)
        pdf_signature.save(outfile)
    finally:
        pdf_signature.close()

Python-Net: 签名验证

Mon, 08 Jun 2026 00:00:00 +0000

Aspose.PDF for Python via .NET 提供了 PdfFileSignature 用于验证已签名 PDF 文档的外观层。PDF 签名后，您可以使用它确认签名有效并检测文档是否包含任何签名条目。

本示例演示了两项常见的验证任务：

验证已有的 PDF 签名是否有效。
检查 PDF 是否包含任何签名。

验证 PDF 签名

使用 verify_signature() 当您需要在文档中验证特定签名时。该示例解析第一个可用的签名名称，并验证该签名是否有效。

import aspose.pdf.facades as pdf_facades
import sys
from os import path


def verify_pdf_signature(infile):
    pdf_signature = create_pdf_file_signature(infile)
    try:
        sign_name = require_signature_name(pdf_signature)
        is_valid = pdf_signature.verify_signature(sign_name)
        print(f"Signature '{sign_name}' is valid: {is_valid}")
    finally:
        pdf_signature.close()

检查 PDF 是否包含签名

使用 contains_signature() 当您只需要了解 PDF 是否包含任何签名时。这在进行更详细的验证或提取逻辑之前，作为快速检查非常有用。

import aspose.pdf.facades as pdf_facades
import sys
from os import path


def check_if_pdf_contains_signatures(infile):
    pdf_signature = create_pdf_file_signature(infile)
    try:
        contains_signatures = pdf_signature.contains_signature()
        print(f"PDF contains signatures: {contains_signatures}")
    finally:
        pdf_signature.close()

Python-Net: 使用权限管理

Mon, 08 Jun 2026 00:00:00 +0000

Aspose.PDF for Python via .NET 提供了 PdfFileSignature 用于处理已签名 PDF 及相关使用权限设置的外观层。在某些工作流中，您可能需要检查文档是否包含使用权限，并在保存文件的更新版本之前将其移除。

此示例演示了一项常见的使用权限管理任务：

检查 PDF 是否包含使用权限。
从文档中移除使用权限。
保存更新后的 PDF 文件。

检查 PDF 是否包含使用权限

在删除使用权限之前，示例通过调用检查文档的当前状态 contains_usage_rights(). 这可让您在进行更改之前确认是否存在使用权。

import aspose.pdf.facades as pdf_facades
import sys
from os import path


def check_usage_rights(infile):
    pdf_signature = create_pdf_file_signature(infile)
    try:
        had_usage_rights = pdf_signature.contains_usage_rights()
        print(f"PDF contains usage rights: {had_usage_rights}")
    finally:
        pdf_signature.close()

从 PDF 中移除使用权限

使用 remove_usage_rights() 当文档不再需要保留其现有的使用权设置时。示例检查初始状态，移除权限，并将更新后的 PDF 保存到新文件中。

import aspose.pdf.facades as pdf_facades
import sys
from os import path


def remove_usage_rights(infile, outfile):
    pdf_signature = create_pdf_file_signature(infile)
    try:
        had_usage_rights = pdf_signature.contains_usage_rights()
        print(f"PDF contains usage rights before removal: {had_usage_rights}")
        pdf_signature.remove_usage_rights()
        pdf_signature.save(outfile)
    finally:
        pdf_signature.close()