Documentation – Clase PdfFileSecurity

Python-Net: Cambiar la contraseña del archivo PDF

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

Cambiar contraseña de usuario y propietario

En muchos casos, es posible que necesite actualizar las contraseñas de un PDF protegido sin cambiar su configuración de seguridad actual. Esto puede ser útil al rotar credenciales, transferir la propiedad o mejorar la seguridad del documento.

El método \u0027change_password\u0027 de PdfFileSecurity la clase le permite:

Actualizar la contraseña del usuario (necesaria para abrir el documento)
Actualizar la contraseña del propietario (utilizada para controlar los permisos)
Mantener la configuración actual de cifrado y permisos

Cree un objeto ‘PdfFileSecurity’.
Vincular el PDF de entrada.
Cambie contraseñas con el método ‘change_password()’.
Guarde el PDF actualizado.

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)

Cambiar la contraseña y restablecer la seguridad

Al trabajar con documentos PDF seguros, simplemente cambiar las contraseñas puede no ser suficiente. También puede ser necesario ajustar los permisos, como los de impresión, copia o edición.

Aprenda cómo actualizar las contraseñas de usuario y propietario mientras restablece la configuración de seguridad PDF con Aspose.PDF for Python via .NET. Este ejemplo muestra cómo redefinir los permisos del documento y la fuerza de cifrado junto con nuevas credenciales de acceso.

Cree un objeto ‘PdfFileSecurity’.
Vincular el PDF de entrada.
Cree un objeto ‘DocumentPrivilege’ y configure las acciones permitidas.
Cambie las contraseñas y restablezca la seguridad.
Guarde el PDF actualizado.

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)

Intentar cambiar la contraseña sin excepción

En algunos flujos de trabajo, especialmente en procesamiento por lotes o sistemas automatizados, es importante evitar excepciones que puedan interrumpir la ejecución. En lugar de lanzar errores, puede preferir una operación segura que informe el éxito o el fracaso.

El método ’try_change_password’ de PdfFileSecurity clase proporciona esta funcionalidad mediante:

Cree un objeto ‘PdfFileSecurity’.
Cargue el documento PDF usando el método ‘bind_pdf()’.
Intentar cambiar contraseñas.
Verificar el resultado.
Guarde el PDF actualizado.

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: Descifrar archivo PDF

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

Descifrar PDF con contraseña de propietario

Descifre un documento PDF protegido con contraseña usando la contraseña de propietario con Aspose.PDF for Python via .NET. Esta operación elimina el cifrado y permite el acceso sin restricciones al documento.

Cree un objeto ‘PdfFileSecurity’.
Cargue el PDF cifrado usando el método ‘bind_pdf()’.
Desencripte el documento.
Guarde el PDF desencriptado.

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)

Intentar descifrar PDF sin excepción

Los documentos PDF a menudo están protegidos con contraseñas para restringir el acceso y el uso. Para acceder o modificar completamente dichos documentos, puede ser necesario eliminar el cifrado. Desencripte un documento PDF asegurado usando la contraseña del propietario para eliminar el cifrado y las restricciones de acceso con Aspose.PDF for Python via .NET.

Cree un objeto ‘PdfFileSecurity’.
Vincular el PDF de entrada.
Desencripte el PDF.
Guarde el PDF de salida.

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: Cifrar archivo PDF

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

Cifrar PDF con contraseña de usuario y de propietario

Proteger los documentos PDF es esencial al compartir contenido sensible o restringido. El cifrado le permite proteger un documento con contraseñas y definir qué acciones pueden realizar los usuarios. Este fragmento de código muestra cómo aplicar contraseñas de usuario y propietario, junto con permisos de acceso, para asegurar un archivo PDF.

Crear un objeto PdfFileSecurity.
Vincular el PDF de entrada.
Definir privilegios de documento.
Cifrar el PDF.
Guardar el PDF cifrado.

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)

Encriptar PDF con permisos

El siguiente fragmento de código explica cómo permitir acciones seleccionadas como imprimir y copiar mientras se restringen otras.

Inicializar el PdfFileSecurity clase.
Vincular el PDF de entrada.
Configurar privilegios del documento.
Llamar al método ’encrypt_file()'.
Guardar el PDF cifrado.

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)

Cifrar PDF con algoritmo de encriptación

El cifrado de PDF no solo protege los documentos con contraseñas, sino que también permite elegir el algoritmo de cifrado y su robustez. Seleccionar el algoritmo apropiado garantiza una seguridad más fuerte para documentos sensibles.

Cree un objeto PdfFileSecurity.
Vincular el PDF de entrada.
Definir privilegios de documento.
Cifre el PDF con el algoritmo.
Guardar el PDF cifrado.

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: Establecer privilegios en un archivo PDF existente

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

Establecer privilegios de PDF sin contraseñas

Verifique cómo aplicar privilegios de documento a un PDF sin especificar contraseñas de usuario o propietario utilizando Aspose.PDF for Python via .NET. Este fragmento de código muestra cómo controlar las acciones permitidas mientras se mantiene el documento accesible.

Crear un objeto ‘PdfFileSecurity’.
Vincular el PDF de entrada.
Definir privilegios del documento.
Llame al método ‘set_privilege()’ sin pasar contraseñas.
Guarde el PDF actualizado.

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)

Establecer privilegios de PDF con contraseñas de usuario y propietario

Para asegurar completamente un documento PDF, a menudo se necesita tanto control de acceso (contraseñas) como restricciones de uso (permisos). Al combinar estos, puedes garantizar que solo los usuarios autorizados puedan abrir el documento y realizar acciones específicas.

Usando el método set_privilege con parámetros de contraseña, puedes:

Proteger el documento con una contraseña de usuario
Definir una contraseña de propietario para control total
Configurar acciones permitidas y restringidas
Aplicar políticas de seguridad a nivel de documento

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)

Intenta establecer privilegios de PDF sin excepción

Este fragmento de código explica cómo controlar el acceso y restringir acciones como copiar, mientras se permiten otras como imprimir.

Cree un objeto ‘PdfFileSecurity’.
Carga el PDF de origen usando el método ‘bind_pdf()’.
Definir privilegios del documento.
Aplicar privilegios con contraseñas.
Guarde el PDF actualizado.

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.")