Encryption — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss supporta la crittografia e la decrittazione AES dei file XLSX tramite le funzioni a livello di modulo encrypt_xlsx e decrypt_xlsx. Due classi di parametri configurano l’algoritmo di cifratura, l’algoritmo di hash e il conteggio di spin PBKDF2. Il valore predefinito consigliato è AgileEncryptionParameters con AES-256 e SHA-512.

ImageRenderOptions: aspose.cells_foss

from aspose.cells_foss import (
    CipherAlgorithm, HashAlgorithm,
    AgileEncryptionParameters, StandardEncryptionParameters,
    encrypt_xlsx, decrypt_xlsx, get_default_encryption_params,
)

CipherAlgorithm

CipherAlgorithm è un IntEnum specificando la lunghezza della chiave AES. Tutte le varianti usano AES in modalità CBC con una dimensione del blocco di 16 byte.

ImageRenderOptions

HashAlgorithm

HashAlgorithm è un IntEnum specificare la funzione hash utilizzata per la derivazione della chiave PBKDF2.

ImageRenderOptions

AgileEncryptionParameters

AgileEncryptionParameters configura lo schema di crittografia Agile (ECMA-376, parte 4), che è il formato predefinito e consigliato per i file Excel moderni (Excel 2010+).

ImageRenderOptions

AgileEncryptionParameters(
    cipher_algorithm=CipherAlgorithm.AES_256,
    hash_algorithm=HashAlgorithm.SHA512,
    spin_count=100000
)

ImageRenderOptions

StandardEncryptionParameters

StandardEncryptionParameters configura lo schema di Crittografia Standard per la compatibilità con Excel 2007. Preferire AgileEncryptionParameters per i nuovi file.

ImageRenderOptions

StandardEncryptionParameters(
    cipher_algorithm=CipherAlgorithm.AES_128,
    hash_algorithm=HashAlgorithm.SHA1,
    spin_count=50000
)

Le proprietà rispecchiano quelle di AgileEncryptionParameters. Il encryption_type proprietà è "standard".

Funzioni del Modulo

encrypt_xlsx

encrypt_xlsx(
    input_path: str,
    output_path: str,
    password: str,
    encryption_params=None
) -> None

Legge il file XLSX in input_path, lo cripta con password usando il specificato encryption_params, e scrive il file crittografato in output_path.

decrypt_xlsx

decrypt_xlsx(
    input_path: str,
    output_path: str,
    password: str
) -> bool

Decripta il file XLSX in input_path usando password e scrive il XLSX in chiaro su output_path. Restituisce True se la decrittazione ha avuto successo, False se la password era errata o il file non era crittografato.

get_default_encryption_params

get_default_encryption_params() -> AgileEncryptionParameters

Restituisce un AgileEncryptionParameters istanza configurata con AES_256, SHA512, e spin_count=100000. Usa questo per ispezionare o clonare le impostazioni predefinite della libreria prima di personalizzarle.

ImageRenderOptions

Cifra un Workbook

from aspose.cells_foss import Workbook, encrypt_xlsx, AgileEncryptionParameters, CipherAlgorithm, HashAlgorithm

# 1. Build and save an unencrypted workbook
wb = Workbook()
ws = wb.worksheets[0]
ws.cells["A1"].put_value("Confidential data")
wb.save("report.xlsx")

# 2. Encrypt with default AES-256/SHA-512 settings
encrypt_xlsx("report.xlsx", "report_secure.xlsx", password="MyP@ssw0rd!")

# 3. Alternatively, use a lower spin count for faster open/save cycles during development
params = AgileEncryptionParameters(
    cipher_algorithm=CipherAlgorithm.AES_256,
    hash_algorithm=HashAlgorithm.SHA256,
    spin_count=10000,
)
encrypt_xlsx("report.xlsx", "report_dev.xlsx", password="dev_only", encryption_params=params)

Decifra un Workbook

from aspose.cells_foss import decrypt_xlsx, Workbook

success = decrypt_xlsx("report_secure.xlsx", "report_decrypted.xlsx", password="MyP@ssw0rd!")

if success:
    wb = Workbook("report_decrypted.xlsx")
    print(wb.worksheets[0].cells["A1"].value)
else:
    print("Incorrect password or file is not encrypted.")

Apri direttamente un file crittografato

ImageRenderOptions Workbook il costruttore accetta anche un password parametro per aprire file crittografati senza un passaggio di decrittazione separato:

from aspose.cells_foss import Workbook

wb = Workbook("report_secure.xlsx", password="MyP@ssw0rd!")
print(wb.worksheets[0].cells["A1"].value)
wb.save("report_updated_secure.xlsx", password="MyP@ssw0rd!")

Vedi anche

• Cells Python Riferimento API home
• Riferimento classe Workbook
• Guida introduttiva
• Guida per sviluppatori