Documentation – Classe PdfFileSecurity

Python-Net: Alterar senha do arquivo PDF

Mon, 18 May 2026 00:00:00 +0000

Alterar senha de usuário e do proprietário

Em muitos casos, pode ser necessário atualizar as senhas de um PDF protegido sem alterar sua configuração de segurança existente. Isso pode ser útil ao rotacionar credenciais, transferir a propriedade ou aprimorar a segurança do documento.

O método ‘change_password’ de PdfFileSecurity a classe permite:

Atualize a senha do usuário (necessária para abrir o documento)
Atualize a senha do proprietário (usada para controlar permissões)
Mantenha as configurações atuais de criptografia e permissões

Crie um objeto ‘PdfFileSecurity’.
Vincule o PDF de entrada.
Altere as senhas com o método ‘change_password()’.
Salve o PDF atualizado.

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)

Alterar senha e redefinir segurança

Ao trabalhar com documentos PDF seguros, simplesmente alterar as senhas pode não ser suficiente. Você também pode precisar ajustar permissões, como impressão, cópia ou direitos de edição.

Aprenda como atualizar as senhas de usuário e de proprietário ao redefinir as configurações de segurança do PDF com Aspose.PDF for Python via .NET. Este exemplo mostra como redefinir as permissões do documento e a força da criptografia juntamente com novas credenciais de acesso.

Crie um objeto ‘PdfFileSecurity’.
Vincule o PDF de entrada.
Crie um objeto ‘DocumentPrivilege’ e configure as ações permitidas.
Altere as senhas e redefina a segurança.
Salve o PDF atualizado.

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)

Tente Alterar Senha Sem Exceção

Em alguns fluxos de trabalho, especialmente em processamento em lote ou sistemas automatizados, é importante evitar exceções que possam interromper a execução. Em vez de lançar erros, você pode preferir uma operação segura que reporte sucesso ou falha.

O método ’try_change_password’ da PdfFileSecurity classe fornece esta funcionalidade por:

Crie um objeto ‘PdfFileSecurity’.
Carregue o documento PDF usando o método ‘bind_pdf()’.
Tentativa de alterar senhas.
Verifique o resultado.
Salve o PDF atualizado.

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: Descriptografar arquivo PDF

Mon, 18 May 2026 00:00:00 +0000

Descriptografar PDF com senha de proprietário

Descriptografar um documento PDF protegido por senha usando a senha de proprietário com Aspose.PDF for Python via .NET. Esta operação remove a criptografia e permite acesso irrestrito ao documento.

Crie um objeto ‘PdfFileSecurity’.
Carregue o PDF criptografado usando o método ‘bind_pdf()’.
Descriptografe o Document.
Salve o PDF descriptografado.

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)

Tente descriptografar PDF sem exceção

Documentos PDF costumam ser protegidos com senhas para restringir o acesso e o uso. Para acessar ou modificar totalmente esses documentos, pode ser necessário remover a criptografia. Descriptografe um documento PDF protegido usando a senha do proprietário para remover a criptografia e restrições de acesso com Aspose.PDF for Python via .NET.

Crie um objeto ‘PdfFileSecurity’.
Vincule o PDF de entrada.
Descriptografar o PDF.
Salvar o PDF de saída.

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: Criptografar arquivo PDF

Mon, 18 May 2026 00:00:00 +0000

Criptografar PDF com senha de usuário e senha de proprietário

Proteger documentos PDF é essencial ao compartilhar conteúdo sensível ou restrito. A criptografia permite proteger um documento com senhas e definir quais ações os usuários podem executar. Este trecho de código mostra como aplicar senhas de usuário e de proprietário juntamente com permissões de acesso para proteger um arquivo PDF.

Criar um objeto PdfFileSecurity.
Vincule o PDF de entrada.
Definir privilégios do Document.
Criptografar o PDF.
Salvar o PDF criptografado.

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)

Criptografar PDF com Permissões

O próximo trecho de código explica como permitir ações selecionadas, como impressão e cópia, enquanto restringe outras.

Inicializar o PdfFileSecurity classe.
Vincular o PDF de entrada.
Configurar privilégios do Document.
Chamar o método ’encrypt_file()'.
Salvar o PDF criptografado.

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)

Criptografar PDF com Algoritmo de Criptografia

A criptografia de PDF não apenas protege documentos com senhas, mas também permite escolher o algoritmo de criptografia e a força. Selecionar o algoritmo apropriado garante segurança mais forte para documentos confidenciais.

Criar um objeto PdfFileSecurity.
Vincular o PDF de entrada.
Definir privilégios do Document.
Criptografar o PDF com Algoritmo.
Salvar o PDF criptografado.

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: Definir privilégios em um arquivo PDF existente

Mon, 18 May 2026 00:00:00 +0000

Definir privilégios de PDF sem senhas

Verifique como aplicar privilégios de documento a um PDF sem especificar senhas de usuário ou proprietário usando Aspose.PDF for Python via .NET. Este trecho de código mostra como controlar as ações permitidas mantendo o documento acessível.

Criar um ‘PdfFileSecurity’ Objeto.
Vincule o PDF de entrada.
Definir privilégios de Document.
Chame o método ‘set_privilege()’ sem passar senhas.
Salve o PDF atualizado.

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)

Definir privilégios de PDF com senhas de usuário e proprietário

Para proteger totalmente um documento PDF, muitas vezes você precisa tanto de controle de acesso (senhas) quanto de restrições de uso (permissões). Ao combinar esses recursos, você pode garantir que apenas usuários autorizados abram o documento e realizem ações específicas.

Usando o método set_privilege com parâmetros de senha, você pode:

Proteja o documento com uma senha de usuário
Defina uma senha de proprietário para controle total
Configure ações permitidas e restritas
Aplique políticas de segurança ao nível do 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)

Tente definir privilégios de PDF sem exceção

Este trecho de código explica como controlar o acesso e restringir ações como copiar, permitindo outras como imprimir.

Crie um objeto ‘PdfFileSecurity’.
Carregue o PDF de origem usando o método ‘bind_pdf()’.
Definir privilégios de Document.
Aplicar privilégios com senhas.
Salve o PDF atualizado.

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