Documentation – PdfFileSecurity 类

Python-Net: 更改 PDF 文件的密码

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

更改用户和所有者密码

在许多情况下，您可能需要在不更改现有安全设置的前提下更新受保护 PDF 的密码。这在轮换凭证、转移所有权或增强文档安全性时非常有用。

‘change_password’ 方法属于 PdfFileSecurity class 让您：

更新用户密码（打开文档所需）
更新所有者密码（用于控制权限）
保留当前的加密和权限设置

创建一个 ‘PdfFileSecurity’ 对象。
绑定输入 PDF。
使用 ‘change_password()’ 方法更改密码。
保存更新后的 PDF。

from io import FileIO
import sys
from os import path
import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


# Change User and Owner Password
def change_user_and_owner_password(infile, outfile):
    """Change user and owner passwords while keeping existing security settings."""
    # Create PdfFileSecurity object
    file_security = pdf_facades.PdfFileSecurity()

    # Bind PDF document
    file_security.bind_pdf(infile)

    # Change passwords
    file_security.change_password(
        "owner_password", "new_user_password", "new_owner_password"
    )

    # Save updated PDF
    file_security.save(outfile)

更改密码并重置安全设置

在处理受保护的 PDF 文档时，单纯更改密码可能不足。您可能还需要调整权限，例如打印、复制或编辑权利。

了解如何在使用 Aspose.PDF for Python via .NET 重置 PDF 安全设置的同时更新用户密码和所有者密码。本示例展示了如何重新定义文档权限和加密强度以及新的访问凭证。

创建一个 ‘PdfFileSecurity’ 对象。
绑定输入 PDF。
创建一个‘DocumentPrivilege’对象并配置允许的操作。
更改密码并重置安全设置。
保存更新后的 PDF。

from io import FileIO
import sys
from os import path
import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


# Change Password and Reset Security
def change_password_and_reset_security(infile, outfile):
    """Change passwords and reset document security settings."""
    # Create PdfFileSecurity object
    file_security = pdf_facades.PdfFileSecurity()

    # Bind PDF document
    file_security.bind_pdf(infile)

    # Define new privileges
    privilege = pdf_facades.DocumentPrivilege.forbid_all
    privilege.allow_print = True

    # Change passwords and reset security
    file_security.change_password(
        "owner_password",
        "new_user_password",
        "new_owner_password",
        privilege,
        pdf_facades.KeySize.X128,
    )

    # Save updated PDF
    file_security.save(outfile)

尝试更改密码而不抛出异常

在某些工作流中，特别是批处理或自动化系统中，避免可能中断执行的异常非常重要。与其抛出错误，您可能更倾向于使用一种报告成功或失败的安全操作。

的 \u0027try_change_password\u0027 方法 PdfFileSecurity 类通过以下方式提供此功能：

创建一个 ‘PdfFileSecurity’ 对象。
使用 \u0027bind_pdf()\u0027 方法加载 PDF 文档。
尝试更改密码。
检查结果。
保存更新后的 PDF。

from io import FileIO
import sys
from os import path
import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


# Try Change Password Without Exception
def try_change_password_without_exception(infile, outfile):
    """Attempt to change passwords without throwing an exception on failure."""
    # Create PdfFileSecurity object
    file_security = pdf_facades.PdfFileSecurity()

    # Bind PDF document
    file_security.bind_pdf(infile)

    # Attempt to change passwords
    result = file_security.try_change_password(
        "owner_password", "new_user_password", "new_owner_password"
    )

    # Save only if operation succeeded
    if result:
        file_security.save(outfile)
    else:
        print("Password change failed. Check owner password or document security.")

Python-Net: 解密 PDF 文件

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

使用所有者密码解密 PDF

使用 Aspose.PDF for Python via .NET 的所有者密码解密受密码保护的 PDF 文档。此操作会移除加密并允许对文档进行无限制访问。

创建一个 ‘PdfFileSecurity’ 对象。
使用 ‘bind_pdf()’ 方法加载加密的 PDF。
解密文档。
保存已解密的 PDF。

from io import FileIO
import sys
from os import path
import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


# Decrypt PDF with Owner Password
def decrypt_pdf_with_owner_password(infile, outfile):
    """Decrypt a PDF document using the owner password."""
    # Create PdfFileSecurity object
    file_security = pdf_facades.PdfFileSecurity()

    # Bind PDF document
    file_security.bind_pdf(infile)

    # Decrypt the PDF
    file_security.decrypt_file("owner_password")

    # Save decrypted PDF
    file_security.save(outfile)

尝试解密 PDF 而不抛出异常

PDF 文档通常受到密码保护以限制访问和使用。要完全访问或修改此类文档，您可能需要移除加密。使用 Aspose.PDF for Python via .NET，利用所有者密码解密受保护的 PDF 文档，以移除加密和访问限制。

创建一个 ‘PdfFileSecurity’ 对象。
绑定输入 PDF。
解密 PDF。
保存输出 PDF。

from io import FileIO
import sys
from os import path
import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


# Try Decrypt PDF Without Exception
def try_decrypt_pdf_without_exception(infile, outfile):
    """Attempt to decrypt a PDF without throwing an exception on failure."""
    # Create PdfFileSecurity object
    file_security = pdf_facades.PdfFileSecurity()

    # Bind PDF document
    file_security.bind_pdf(infile)

    # Attempt to decrypt the PDF
    result = file_security.try_decrypt_file("owner_password")

    # Save only if decryption was successful
    if result:
        file_security.save(outfile)
    else:
        print("Decryption failed. Check password or document security.")

Python-Net: 加密 PDF 文件

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

使用用户密码和所有者密码加密 PDF

在共享敏感或受限制内容时，确保 PDF 文档的安全至关重要。加密允许您使用密码保护文档，并定义用户可以执行的操作。此代码片段展示了如何应用用户密码和所有者密码以及访问权限来保护 PDF 文件。

创建一个 PdfFileSecurity 对象。
绑定输入 PDF。
定义文档权限。
加密 PDF。
保存已加密的 PDF。

from io import FileIO
import sys
from os import path
import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


# Encrypt PDF with User and Owner Password
def encrypt_pdf_with_user_owner_password(infile, outfile):
    """Encrypt a PDF document using user and owner passwords."""
    # Create PdfFileSecurity object
    file_security = pdf_facades.PdfFileSecurity()

    # Bind PDF document
    file_security.bind_pdf(infile)

    # Define document privileges
    privilege = pdf_facades.DocumentPrivilege.forbid_all
    privilege.allow_print = True

    # Encrypt the PDF
    file_security.encrypt_file(
        "user_password", "owner_password", privilege, pdf_facades.KeySize.X128
    )

    # Save encrypted PDF
    file_security.save(outfile)

使用权限加密 PDF

下面的代码片段解释如何在允许打印和复制等选定操作的同时限制其他操作。

初始化 PdfFileSecurity 类。
绑定输入 PDF。
配置文档权限。
调用 ’encrypt_file()’ 方法。
保存已加密的 PDF。

from io import FileIO
import sys
from os import path
import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


# Encrypt PDF with Permissions
def encrypt_pdf_with_permissions(infile, outfile):
    """Encrypt a PDF document and configure specific permissions."""
    # Create PdfFileSecurity object
    file_security = pdf_facades.PdfFileSecurity()

    # Bind PDF document
    file_security.bind_pdf(infile)

    # Configure privileges
    privilege = pdf_facades.DocumentPrivilege.forbid_all
    privilege.allow_print = True
    privilege.allow_copy = True

    # Encrypt the PDF
    file_security.encrypt_file(
        "user_password", "owner_password", privilege, pdf_facades.KeySize.X128
    )

    # Save encrypted PDF
    file_security.save(outfile)

使用加密算法加密 PDF

PDF 加密不仅通过密码保护文档，还允许您选择加密算法和强度。选择适当的算法可为敏感文档提供更强的安全性。

创建一个 PdfFileSecurity 对象。
绑定输入 PDF。
定义文档权限。
使用算法加密 PDF。
保存已加密的 PDF。

from io import FileIO
import sys
from os import path
import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


# Encrypt PDF with Encryption Algorithm
def encrypt_pdf_with_encryption_algorithm(infile, outfile):
    """Encrypt a PDF document using a specific encryption algorithm."""
    # Create PdfFileSecurity object
    file_security = pdf_facades.PdfFileSecurity()

    # Bind PDF document
    file_security.bind_pdf(infile)

    # Define privileges
    privilege = pdf_facades.DocumentPrivilege.forbid_all
    privilege.allow_print = True

    # Encrypt the PDF using AES algorithm
    file_security.encrypt_file(
        "user_password",
        "owner_password",
        privilege,
        pdf_facades.KeySize.X256,
        pdf_facades.Algorithm.AES,
    )

    # Save encrypted PDF
    file_security.save(outfile)

Python-Net: 为现有 PDF 文件设置权限

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

在无密码情况下设置 PDF 权限

了解如何在不指定用户或所有者密码的情况下，使用 Aspose.PDF for Python via .NET 为 PDF 应用文档权限。此代码片段演示了在保持文档可访问的同时，如何控制允许的操作。

创建一个 ‘PdfFileSecurity’ 对象。
绑定输入 PDF。
定义文档权限。
调用 ‘set_privilege()’ 方法而不传入密码。
保存更新后的 PDF。

from io import FileIO
import sys
from os import path
import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


# Set PDF Privileges Without Passwords
def set_pdf_privileges_without_passwords(infile, outfile):
    """Set PDF privileges without specifying user and owner passwords."""
    # Create PdfFileSecurity object
    file_security = pdf_facades.PdfFileSecurity()

    # Bind PDF document
    file_security.bind_pdf(infile)

    # Define privileges
    privilege = pdf_facades.DocumentPrivilege.forbid_all
    privilege.allow_print = True

    # Apply privileges (owner password will be generated automatically)
    file_security.set_privilege(privilege)

    # Save updated PDF
    file_security.save(outfile)

使用用户和所有者密码设置 PDF 权限

为了完全保护 PDF 文档，通常需要同时具备访问控制（密码）和使用限制（权限）。通过将二者结合，您可以确保只有授权用户能够打开文档并执行特定操作。

使用带有密码参数的 set_privilege 方法，您可以：

使用用户密码保护文档
为完整控制定义所有者密码
配置允许的和受限的操作
强制执行文档级安全策略

from io import FileIO
import sys
from os import path
import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


# Set PDF Privileges with User and Owner Passwords
def set_pdf_privileges_with_passwords(infile, outfile):
    """Set PDF privileges using user and owner passwords."""
    # Create PdfFileSecurity object
    file_security = pdf_facades.PdfFileSecurity()

    # Bind PDF document
    file_security.bind_pdf(infile)

    # Define privileges
    privilege = pdf_facades.DocumentPrivilege.forbid_all
    privilege.allow_print = True
    privilege.allow_copy = False

    # Apply privileges with passwords
    file_security.set_privilege("user_password", "owner_password", privilege)

    # Save updated PDF
    file_security.save(outfile)

尝试在不抛出异常的情况下设置 PDF 权限

此代码片段说明了如何控制访问并限制诸如复制的操作，同时允许诸如打印等其他操作。

创建一个 ‘PdfFileSecurity’ 对象。
使用 \u0027bind_pdf()\u0027 方法加载源 PDF。
定义文档权限。
使用密码应用权限。
保存更新后的 PDF。

from io import FileIO
import sys
from os import path
import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


# Try Set PDF Privileges Without Exception
def try_set_pdf_privileges_without_exception(infile, outfile):
    """Attempt to set PDF privileges without throwing an exception on failure."""
    # Create PdfFileSecurity object
    file_security = pdf_facades.PdfFileSecurity()

    # Bind PDF document
    file_security.bind_pdf(infile)

    # Define privileges
    privilege = pdf_facades.DocumentPrivilege.forbid_all
    privilege.allow_print = True

    # Attempt to apply privileges
    result = file_security.try_set_privilege(
        "user_password", "owner_password", privilege
    )

    # Save only if operation succeeded
    if result:
        file_security.save(outfile)
    else:
        print("Setting privileges failed. Check passwords or document state.")