Documentation – 在 Python 中保护和签署 PDF 文件

Python-Net: 在 Python 中添加数字签名或对 PDF 进行数字签名

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

使用数字签名签署 PDF

import sys
from os import path
import aspose.pdf as ap
import aspose.pydrawing as drawing

def sign_document(infile: str, outfile: str, pfxfile: str) -> None:
    """Sign a PDF document with a PKCS#7 certificate."""
    with ap.Document(infile) as document:
        with ap.facades.PdfFileSignature(document) as signature:
            pkcs = ap.forms.PKCS7(pfxfile, "12345")
            signature.sign(1, True, drawing.Rectangle(300, 100, 400, 200), pkcs)
            signature.save(outfile)

一个 PKCS#7 分离签名 为文档添加数字签名，而不将内容嵌入签名块中。

当您需要对 PDF 文件使用基于证书的签名、验证签名有效性或向已签名文档添加可信时间戳时，请使用这些示例。

下面的示例使用 PKCS#7 分离数字签名对 PDF 文档进行签署，将签名应用于首页的指定矩形区域。

import sys
from os import path
import aspose.pdf as ap
import aspose.pydrawing as drawing

def sign_document_PKCS7_detached(
    infile: str,
    outfile: str,
    pfxfile: str,
    password: str,
) -> None:
    """Sign a PDF document with a detached PKCS#7 certificate."""
    with ap.Document(infile) as document:
        with ap.facades.PdfFileSignature(document) as signature:
            pkcs = ap.forms.PKCS7Detached(
                pfxfile,
                password,
                ap.DigestHashAlgorithm.SHA256,
            )
            signature.sign(1, True, drawing.Rectangle(300, 100, 400, 200), pkcs)
            signature.save(outfile)

验证 PDF 文档中的所有数字签名

创建一个 PdfFileSignature 实例，使您能够在 PDF 中处理签名。
获取签名名称列表 get_signature_names(True).
检查列表中的第一个签名 verify_signature 以符合指定的证书。

import sys
from os import path
import aspose.pdf as ap
import aspose.pydrawing as drawing

def verify(infile: str) -> None:
    """Verify all digital signatures in a PDF document."""
    with ap.Document(infile) as document:
        with ap.facades.PdfFileSignature(document) as signature:
            for signature_name in signature.get_signature_names(True):
                if not signature.verify_signature(signature_name):
                    raise Exception("Not verified")

使用公钥证书文件验证签名

import sys
from os import path
import aspose.pdf as ap
import aspose.pydrawing as drawing

def verify_with_public_key_certificate1(certificate: str, infile: str) -> None:
    """Verify a signature with a public key certificate file."""
    with ap.facades.PdfFileSignature(infile) as file_sign:
        signature_names = file_sign.get_signature_names(True)
        with open(certificate, "rb") as file_stream:
            certificate_bytes = file_stream.read()
        print(file_sign.verify_signature(signature_names[0], certificate_bytes))

使用从文件中提取的证书验证签名

import sys
from os import path
import aspose.pdf as ap
import aspose.pydrawing as drawing

def verify_with_public_key_certificate_from_signature(infile: str) -> None:
    """Verify a signature with the certificate extracted from the file."""
    with ap.facades.PdfFileSignature(infile) as file_sign:
        signature_names = file_sign.get_signature_names(True)
        certificate = []
        if file_sign.try_extract_certificate(signature_names[0], certificate):
            print(file_sign.verify_signature(signature_names[0], certificate[0]))
        else:
            print(False)

验证已启用证书链验证的签名

import sys
from os import path
import aspose.pdf as ap
import aspose.pydrawing as drawing

def verify_signature_with_certificate_check(infile: str) -> None:
    """Verify signatures with certificate-chain validation enabled."""
    with ap.Document(infile) as document:
        with ap.facades.PdfFileSignature(document) as signature:
            for signature_name in signature.get_signature_names(True):
                options = ap.security.ValidationOptions()
                options.validation_mode = ap.security.ValidationMode.STRICT
                options.validation_method = ap.security.ValidationMethod.AUTO
                options.check_certificate_chain = True
                options.request_timeout = 20000
                validation_result = []
                verified = signature.verify_signature(
                    signature_name,
                    options,
                    validation_result,
                )
                print(f"Certificate validation result: {validation_result[0].status}")
                print(f"Is verified: {verified}")

为数字签名添加时间戳

如何为 PDF 添加带时间戳的数字签名

Aspose.PDF for Python 支持使用时间戳服务器或 Web 服务对 PDF 进行数字签名。

为了完成此要求，时间戳设置类已添加到 Aspose.PDF 命名空间。请查看以下获取时间戳并将其添加到 PDF 文档的代码片段：

import sys
from os import path
import aspose.pdf as ap
import aspose.pydrawing as drawing

def sign_with_time_stamp_server(
    infile: str,
    outfile: str,
    pfxfile: str,
    password: str,
) -> None:
    """Sign a PDF document and apply a timestamp from an external server."""
    with ap.Document(infile) as document:
        with ap.facades.PdfFileSignature(document) as signature:
            pkcs = ap.forms.PKCS7(pfxfile, password)
            pkcs.timestamp_settings = ap.TimestampSettings(
                "https://freetsa.org/tsr",
                "",
                ap.DigestHashAlgorithm.SHA256,
            )
            rect = drawing.Rectangle(100, 100, 200, 100)
            signature.sign(
                1, "Signature Reason", "Contact", "Location", True, rect, pkcs
            )
            signature.save(outfile)

使用 ECDSA 对 PDF 文档进行签名

使用 ECDSA（椭圆曲线数字签名算法）对 PDF 文档进行签名涉及利用椭圆曲线密码学生成数字签名。

上面的代码片段演示了如何使用 Aspose.PDF for Python 对 PDF 文档应用 PKCS#7 分离数字签名。通过加载文档、配置签名外观和安全设置并保存结果，此示例展示了一个完整且可靠的 PDF 文件数字签署工作流。

此方法通过在首页嵌入安全且可验证的签名，确保文档的真实性和完整性。使用 SHA-256 作为摘要算法符合现代密码学标准，而能够控制签名位置则为可见的批准标记提供了灵活性。

import sys
from os import path
import aspose.pdf as ap
import aspose.pydrawing as drawing

def sign_ecdsa(infile: str, outfile: str, pfxfile: str, password: str) -> None:
    """Sign a PDF document with an ECDSA signature."""
    with ap.Document(infile) as document:
        with ap.facades.PdfFileSignature(document) as signature:
            pkcs = ap.forms.PKCS7Detached(
                pfxfile,
                password,
                ap.DigestHashAlgorithm.SHA256,
            )
            signature.sign(1, True, drawing.Rectangle(300, 100, 400, 200), pkcs)
            signature.save(outfile)

在 PDF 文档中验证 ECDSA 签名

def verify_ecdsa(infile: str) -> None:
    """Verify ECDSA signatures in a PDF document."""
    with ap.Document(infile) as document:
        with ap.facades.PdfFileSignature(document) as signature:
            if not signature.contains_signature():
                raise Exception("Not contains signature")

            for signature_name in signature.get_signature_names(True):
                if not signature.verify_signature(signature_name):
                    raise Exception("Not verified")

Python-Net: 在 Python 中从 PDF 提取签名信息

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

从签名字段提取图像

Aspose.PDF for Python via .NET 让您检索嵌入在 a 中的可视图像签名字段. 当您需要显示或归档签名外观而无需渲染完整 PDF 时，这很有用。

下面的示例遍历所有表单字段，查找每一个 SignatureField, 并将其图像保存为 JPEG 文件：

import sys
from os import path
import aspose.pdf as ap
import aspose.pydrawing as drawing

def extract_images_from_signature_field(infile: str, outfile: str) -> None:
    """Extract the image stored in a signature field."""
    with ap.Document(infile) as document:
        for field in document.form:
            if not isinstance(field, ap.forms.SignatureField):
                continue

            image_stream = field.extract_image()
            if image_stream is None:
                continue

            image = drawing.Bitmap.from_stream(image_stream)
            image.save(outfile, drawing.imaging.ImageFormat.jpeg)

读取签名算法详情

使用 PdfFileSignature.get_signatures_info() 读取文档中每个签名的加密元数据——包括摘要算法、算法类型、加密标准和签名名称：

import sys
from os import path
import aspose.pdf as ap
import aspose.pydrawing as drawing

def get_signatures_info(infile: str) -> None:
    """Print information about all signatures in a PDF document."""
    with ap.Document(infile) as document:
        with ap.facades.PdfFileSignature(document) as signature:
            for signature_info in signature.get_signatures_info():
                print(signature_info.DIGEST_HASH_ALGORITHM)
                print(signature_info.ALGORITHM_TYPE)
                print(signature_info.CRYPTOGRAPHIC_STANDARD)
                print(signature_info.signature_name)

从签名字段中提取数字证书

使用提取证书方法在 a SignatureField 检索嵌入的证书为字节流并将其保存到磁盘以进行外部验证：

import sys
from os import path
import aspose.pdf as ap
import aspose.pydrawing as drawing

def extract_certificate(infile: str, outfile: str) -> None:
    """Extract a certificate from a signature field and save it to disk."""
    with ap.Document(infile, password="owner") as document:
        for field in document.form:
            if not isinstance(field, ap.forms.SignatureField):
                continue

            certificate_stream = field.extract_certificate()
            if certificate_stream is None:
                continue

            with certificate_stream:
                bytes_data = bytearray(certificate_stream.length)
                certificate_stream.read(bytes_data, 0, len(bytes_data))
                with open(outfile, "wb") as file_stream:
                    file_stream.write(bytes_data)
                return

使用 PdfFileSignature 外观提取证书

PdfFileSignature.try_extract_certificate() 提供了一种通过签名名称检索证书的替代方法。以下示例遍历所有签名名称，并尝试对每个进行提取：

import sys
from os import path
import aspose.pdf as ap
import aspose.pydrawing as drawing

def extract_certificate_try_extract_certificate_method(infile: str) -> None:
    """Extract certificates with the try_extract_certificate facade method."""
    with ap.Document(infile, password="owner") as document:
        with ap.facades.PdfFileSignature(document) as signature:
            for signature_name in signature.get_signature_names(True):
                certificate = []
                if signature.try_extract_certificate(signature_name, certificate):
                    print("The certificate extraction succeeded")

验证外部数字签名

要确认文档在签名后未被修改，请使用以下方式验证每个外部签名 PdfFileSignature.verify_signature(). 下面的示例会在任何验证失败的签名时抛出异常：

import sys
from os import path
import aspose.pdf as ap
import aspose.pydrawing as drawing

def verify_external_signature(infile: str) -> None:
    """Verify an external signature in a PDF document."""
    with ap.Document(infile) as document:
        with ap.facades.PdfFileSignature(document) as pdf_signature:
            for signature_name in pdf_signature.get_signature_names(True):
                if not pdf_signature.verify_signature(signature_name):
                    raise Exception("Not verified")

检测受损的签名

SignaturesCompromiseDetector 检查文档中的任何数字签名是否因后续更改而失效。在法律、金融或合规工作流中使用此功能，以确保文档完整性得到保证。

下面的示例检查受损的签名，并报告它们的名称以及文档的整体签名覆盖率：

import sys
from os import path
import aspose.pdf as ap
import aspose.pydrawing as drawing

def check(infile: str) -> None:
    """Check whether a PDF contains compromised signatures."""
    with ap.Document(infile) as document:
        detector = ap.SignaturesCompromiseDetector(document)
        result = []

        if detector.check(result):
            print("No signature compromise detected")
            return

        if result[0].has_compromised_signatures:
            print(
                f"Count of compromised signatures: {len(result[0].COMPROMISED_SIGNATURES)}"
            )
            for signature_name in result[0].COMPROMISED_SIGNATURES:
                print(f"Signature name: {signature_name.FULL_NAME}")

        print(result[0].signatures_coverage)

Python-Net: 在 Python 中使用智能卡签署 PDF 文档

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

Aspose.PDF 提供强大的功能，用于集成可视化和加密签名组件，确保数字签名 PDF 文档的真实性和专业呈现。

当您的签名过程依赖于存储在硬件支持设备（如智能卡、USB 令牌或受管理的证书存储）中的证书时，请使用此工作流。

使用签名字段进行智能卡签名

本示例演示如何使用 Aspose.PDF for Python 通过外部证书对 PDF 文档进行数字签名，并应用自定义签名外观图像：

打开 PDF 文档。
创建 PdfFileSignature 对象并将其绑定到文档。
使用自定义方法检索本地数字证书 get_local_certificate().
基于所选证书设置 ExternalSignature。
应用自定义签名外观图像（例如，公司徽标或手写签名）。
在文档的首页进行数字签名，并附加指定的元数据（原因、联系方式、位置）。
将已签名的文档保存到新的输出文件。

此方法非常适用于需要通过外部证书以编程方式进行签名的情况——例如硬件令牌、证书存储或受信任的提供者——并以个性化的视觉布局呈现。

以下是使用智能卡签署 PDF 文档的代码片段：

import sys
from os import path
import aspose.pdf as ap
import aspose.pydrawing as drawing

def sign_with_smart_card(infile: str, outfile: str, pngfile: str) -> None:
    """Sign a PDF document using a smart-card certificate."""
    with ap.Document(infile) as document:
        with ap.facades.PdfFileSignature() as pdf_signature:
            pdf_signature.bind_pdf(document)
            external_signature = ap.forms.ExternalSignature(get_local_certificate())
            pdf_signature.signature_appearance = pngfile
            pdf_signature.sign(
                1,
                "Reason",
                "Contact",
                "Location",
                True,
                drawing.Rectangle(100, 100, 200, 200),
                external_signature,
            )
            pdf_signature.save(outfile)

验证数字签名

此代码片段演示了如何使用 Aspose.PDF for Python 验证 PDF 文档中的数字签名：

打开 PDF 文件。
创建一个 ‘PdfFileSignature object’ 并将其绑定到文档。
使用 ‘get_signature_names()’ 检索所有签名字段名称的列表。
通过 ‘verify_signature()’ 遍历每个签名并验证其有效性。
如果任何签名验证失败，则抛出异常。

import sys
from os import path
import aspose.pdf as ap
import aspose.pydrawing as drawing

def verify_external_signature(infile: str) -> None:
    """Verify an external signature in a PDF document."""
    with ap.Document(infile) as document:
        with ap.facades.PdfFileSignature(document) as pdf_signature:
            for signature_name in pdf_signature.get_signature_names(True):
                if not pdf_signature.verify_signature(signature_name):
                    raise Exception("Not verified")

使用外部证书签名

此代码片段演示了如何使用 Aspose.PDF for Python 并结合外部证书，在 PDF 文档中添加并签署数字签名字段：

以二进制流打开 PDF 文件。
创建 SignatureField 并将其放置在文档的第一页的指定位置。
使用自定义方法检索本地数字证书 get_local_certificate().
设置 ExternalSignature，并提供权限、原因和联系信息等元数据。
为签名字段分配唯一的字段名称 (partial_name = “sig1”).
在 PDF 的表单字段中添加签名字段。
使用外部证书对字段进行签名。
将已签名的文档保存到输出文件。

import sys
from os import path
import aspose.pdf as ap
import aspose.pydrawing as drawing

def get_signature_info_using_signature_field(infile: str, outfile: str) -> None:
    """Create a signature field and sign it with an external certificate."""
    with open(infile, "rb+") as file_stream:
        document = ap.Document(file_stream)
        signature_field = ap.forms.SignatureField(
            document.pages[1],
            ap.Rectangle(100, 400, 10, 10, True),
        )
        selected_certificate = get_local_certificate()
        external_signature = ap.forms.ExternalSignature(selected_certificate)
        external_signature.authority = "Me"
        external_signature.reason = "Reason"
        external_signature.contact_info = "Contact"
        signature_field.partial_name = "sig1"
        document.form.add(signature_field, 1)
        signature_field.sign(external_signature)
        document.save(outfile)

Python-Net: 在 Python 中加密和解密 PDF 文件

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

管理文档安全在处理敏感或业务关键内容时至关重要。Aspose.PDF for Python via .NET 提供了一个强大的 API，用于以编程方式应用加密、通过权限控制访问以及解密受保护的 PDF 文件。

本文向 Python 开发者展示如何在 PDF 工作流中通过实际示例设置权限、应用和移除加密、更改密码以及检测保护状态。

Aspose.PDF for Python via .NET 为开发者提供了对 PDF 安全性的完全控制：

设置特权 - 使用权限进行细粒度访问控制。 Encrypt File - 使用自定义密码应用 AES 或 RC4 加密。 解密文件 - 使用所有者密码移除安全保护。 更改密码 - 在不更改内容的情况下轮换或更新凭据。 检查安全性 - 检测加密状态或所需的密码类型。

当您需要使用密码保护 PDF 文档、限制打印或复制、旋转凭据，或检查文档是否已加密时，请使用此页面。

为现有 PDF 文件设置权限

您可以通过分配用户密码和所有者密码以及访问权限，限制或允许特定操作（例如，打印、复制、填写表单）。

import sys
from os import path

import aspose.pdf as ap
import aspose.pydrawing as drawing

def set_privileges_on_existing_pdf_file(infile: str, outfile: str) -> None:
    """Set restricted privileges on an existing PDF document."""
    with ap.Document(infile) as document:
        document_privilege = ap.facades.DocumentPrivilege.forbid_all
        document_privilege.allow_screen_readers = True
        document.encrypt(
            "user",
            "owner",
            document_privilege,
            ap.CryptoAlgorithm.AESx128,
            False,
        )
        document.save(outfile)

使用不同的加密类型和算法加密 PDF 文件

对 PDF 加密可确保只有具有有效凭据的用户才能打开或修改文件。

关键术语：

用户密码。打开文档时需要。
所有者密码。更改权限或移除加密时需要。
密钥大小。在现代工作流中使用 AE_SX128 以获得最大安全性。

下面的代码片段向您展示如何加密 PDF 文件。

import sys
from os import path

import aspose.pdf as ap
import aspose.pydrawing as drawing

def encrypt_pdf_file(infile: str, outfile: str) -> None:
    """Encrypt a PDF document with user and owner passwords."""
    with ap.Document(infile) as document:
        document.encrypt(
            "user",
            "owner",
            ap.Permissions.EXTRACT_CONTENT,
            ap.CryptoAlgorithm.AESx128,
        )
        document.save(outfile)

使用所有者密码解密 PDF 文件

要移除密码保护并恢复完全访问权限：

使用正确的密码加载加密的 PDF（‘password’ 是用户密码或所有者密码）。
删除文档中的所有密码保护和加密设置。
将现在未受保护的 PDF 保存到指定的输出文件。

import sys
from os import path

import aspose.pdf as ap
import aspose.pydrawing as drawing

def decrypt_pdf_file(infile: str, outfile: str) -> None:
    """Decrypt a password-protected PDF document."""
    with ap.Document(infile, "password") as document:
        document.decrypt()
        document.save(outfile)

使用公钥证书对 PDF 进行加密和解密

import sys
from os import path

import aspose.pdf as ap
import aspose.pydrawing as drawing

def pub_sec_encryption(
    crypto_algorithm,
    pub_cert: str,
    in_pfx: str,
    outfile: str,
) -> None:
    """Demonstrate public-key encryption and decryption."""
    pfx_password = "12345"

    with ap.Document() as document:
        document.info.title = "TestTitle"
        document.info.author = "TestAuthor"
        page = document.pages.add()
        page.paragraphs.add(ap.text.TextFragment("Hello World!"))

        with open(pub_cert, "rb") as file_stream:
            byte_content = file_stream.read()

        document.encrypt(
            ap.Permissions.PRINT_DOCUMENT,
            crypto_algorithm,
            [byte_content],
        )
        document.save(outfile)

    with ap.Document(
        outfile,
        ap.security.CertificateEncryptionOptions(pub_cert, in_pfx, pfx_password),
    ) as document:
        print(document.info.title)
        print(document.info.author)

        text_absorber = ap.text.TextAbsorber()
        document.pages[1].accept(text_absorber)
        print(text_absorber.text)

        document.decrypt()
        document.save(path.join(path.dirname(outfile), "pubsec_decrypted_out.pdf"))

更改 PDF 文件的密码

更新 PDF 文档的安全凭证（用户密码和所有者密码），同时保持其内容和结构不变。

使用现有的所有者密码（‘owner’）打开 PDF，这提供了完全访问权限，包括更改安全设置的权限。
用新的用户密码（’newuser’）和新的所有者密码（’newowner’）替换旧密码。
使用更新的密码设置保存 PDF。

import sys
from os import path

import aspose.pdf as ap
import aspose.pydrawing as drawing

def change_password(infile: str, outfile: str) -> None:
    """Change the passwords of a password-protected PDF document."""
    with ap.Document(infile, "owner") as document:
        document.change_passwords("owner", "newuser", "newowner")
        document.save(outfile)

如何 - 确定源 PDF 是否受密码保护

从数组中确定正确的密码

在某些场景中，您可能需要从潜在候选密码列表中识别正确的密码，以访问受保护的 PDF。下面的代码片段演示了如何检查 PDF 文件是否受密码保护，然后使用 Aspose.PDF for Python via .NET 通过遍历预定义的密码列表尝试解锁它。

该过程包括：

使用 PdfFileInfo 检测 PDF 是否被加密。
尝试使用 ap.Document() 用每个密码打开 PDF。
如果成功，它会打印页数。
如果不是，它会捕获异常并报告密码错误。

import sys
from os import path

import aspose.pdf as ap
import aspose.pydrawing as drawing

def determine_correct_password_from_array(infile: str) -> None:
    """Try a list of passwords until the document opens successfully."""
    with ap.facades.PdfFileInfo() as pdf_file_info:
        pdf_file_info.bind_pdf(infile)
        print(f"File is password protected {pdf_file_info.is_encrypted}")

    passwords = ["test", "test1", "test2", "test3", "sample"]

    for password in passwords:
        try:
            with ap.Document(infile, password) as document:
                if len(document.pages) > 0:
                    print(f"Password = {password} is correct")
                    print(f"Number of pages in document = {len(document.pages)}")
                    break
        except Exception:
            print(f"Password = {password} is not correct")

Documentation – 在 Python 中保护和签署 PDF 文件

Python-Net: 在 Python 中添加数字签名或对 PDF 进行数字签名

使用数字签名签署 PDF

为数字签名添加时间戳

如何为 PDF 添加带时间戳的数字签名

使用 ECDSA 对 PDF 文档进行签名

相关安全主题

Python-Net: 在 Python 中从 PDF 提取签名信息

从签名字段提取图像

读取签名算法详情

从签名字段中提取数字证书

使用 PdfFileSignature 外观提取证书

验证外部数字签名

检测受损的签名

相关安全主题

Python-Net: 在 Python 中使用智能卡签署 PDF 文档

使用签名字段进行智能卡签名

验证数字签名

使用外部证书签名

相关安全主题

Python-Net: 在 Python 中加密和解密 PDF 文件

为现有 PDF 文件设置权限

使用不同的加密类型和算法加密 PDF 文件

使用所有者密码解密 PDF 文件

使用公钥证书对 PDF 进行加密和解密

更改 PDF 文件的密码

如何 - 确定源 PDF 是否受密码保护

从数组中确定正确的密码

相关安全主题