Documentation – PdfFileSecurity Class

Python-Net: Change Password of PDF File

Wed, 18 Mar 2026 00:00:00 +0000

Change User and Owner Password

In many cases, you might need to update the passwords of a protected PDF without changing its existing security setup. This can be helpful when rotating credentials, transferring ownership, or enhancing document security.

The ‘change_password’ method of the PdfFileSecurity class lets you:

Update the user password (needed to open the document)
Update the owner password (used to control permissions)
Keep the current encryption and permission settings

Create a ‘PdfFileSecurity’ object.
Bind the input PDF.
Change passwords with ‘change_password()’ method.
Save the updated 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)

Change Password and Reset Security

When working with secured PDF documents, simply changing passwords may not be enough. You might also need to adjust permissions, such as printing, copying, or editing rights.

Learn how to update user and owner passwords while resetting PDF security settings with Aspose.PDF for Python via .NET. This example shows how to redefine document permissions and encryption strength along with new access credentials.

Create a ‘PdfFileSecurity’ object.
Bind the input PDF.
Create a ‘DocumentPrivilege’ object and configure allowed actions.
Change passwords and reset security.
Save the updated 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)

Try Change Password Without Exception

In some workflows, especially in batch processing or automated systems, it is important to avoid exceptions that may interrupt execution. Instead of throwing errors, you may prefer a safe operation that reports success or failure.

The ’try_change_password’ method of the PdfFileSecurity class provides this functionality by:

Create a ‘PdfFileSecurity’ object.
Load the PDF document using the ‘bind_pdf()’ method.
Attempt to change passwords.
Check the result.
Save the updated 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: Decrypt PDF File

Wed, 18 Mar 2026 00:00:00 +0000

Decrypt PDF with Owner Password

Decrypt a password-protected PDF document using the owner password with Aspose.PDF for Python via .NET. This operation removes encryption and allows unrestricted access to the document.

Create a ‘PdfFileSecurity’ object.
Load the encrypted PDF using the ‘bind_pdf()’ method.
Decrypt the Document.
Save the decrypted 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)

Try Decrypt PDF Without Exception

PDF documents are often protected with passwords to restrict access and usage. To fully access or modify such documents, you may need to remove encryption. Decrypt a secured PDF document using the owner password to remove encryption and access restrictions with Aspose.PDF for Python via .NET.

Create a ‘PdfFileSecurity’ object.
Bind the input PDF.
Decrypt the PDF.
Save the Output 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: Encrypt PDF File

Wed, 18 Mar 2026 00:00:00 +0000

Encrypt PDF with User and Owner Password

Securing PDF documents is essential when sharing sensitive or restricted content. Encryption allows you to protect a document with passwords and define what actions users are allowed to perform. This code snippet shows how to apply user and owner passwords along with access permissions to secure a PDF file.

Create a PdfFileSecurity object.
Bind the input PDF.
Define Document Privileges.
Encrypt the PDF.
Save the Encrypted 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)

Encrypt PDF with Permissions

Next code snippet explain how to allow selected actions like printing and copying while restricting others.

Initialize the PdfFileSecurity class.
Bind the Input PDF.
Configure Document Privileges.
Call the ’encrypt_file()’ method.
Save the Encrypted 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)

Encrypt PDF with Encryption Algorithm

PDF encryption not only protects documents with passwords but also allows you to choose the encryption algorithm and strength. Selecting the appropriate algorithm ensures stronger security for sensitive documents.

Create a PdfFileSecurity Object.
Bind the Input PDF.
Define Document Privileges.
Encrypt the PDF with Algorithm.
Save the Encrypted 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: Set Privileges on an Existing PDF File

Wed, 18 Mar 2026 00:00:00 +0000

Set PDF Privileges Without Passwords

Check how to apply document privileges to a PDF without specifying user or owner passwords using Aspose.PDF for Python via .NET. This code snippet shows how to control allowed actions while keeping the document accessible.

Create a ‘PdfFileSecurity’ Object.
Bind the input PDF.
Define Document privileges.
Call the ‘set_privilege()’ method without passing passwords.
Save the updated 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)

Set PDF Privileges with User and Owner Passwords

To fully secure a PDF document, you often need both access control (passwords) and usage restrictions (permissions). By combining these, you can ensure that only authorized users can open the document and perform specific actions.

Using the set_privilege method with password parameters, you can:

Protect the document with a user password
Define an owner password for full control
Configure allowed and restricted actions
Enforce document-level security policies

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)

Try Set PDF Privileges Without Exception

This code snippet explains how to control access and restrict actions such as copying while allowing others like printing.

Create a ‘PdfFileSecurity’ object.
Load the source PDF using the ‘bind_pdf()’ method.
Define Document privileges.
Apply Privileges with Passwords.
Save the updated 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.")