Encryption — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss suportă criptarea și decriptarea AES a fișierelor XLSX prin funcțiile la nivel de modul encrypt_xlsx și decrypt_xlsx. Două clase de parametri configurează algoritmul de cifrare, algoritmul de hash și numărul de rotații PBKDF2. Valoarea implicită recomandată este AgileEncryptionParameters cu AES-256 și 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 este un IntEnum care specifică lungimea cheii AES.

ImageRenderOptions

HashAlgorithm

HashAlgorithm este un IntEnum specifică funcția hash utilizată pentru derivarea cheii PBKDF2.

ImageRenderOptions

AgileEncryptionParameters

AgileEncryptionParameters configurează schema de criptare Agile (ECMA-376, partea 4), care este formatul implicit și recomandat pentru fișierele Excel moderne (Excel 2010+).

ImageRenderOptions

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

ImageRenderOptions

StandardEncryptionParameters

StandardEncryptionParameters configurează schema de criptare standard pentru compatibilitate cu Excel 2007. Preferă AgileEncryptionParameters pentru fișiere noi.

ImageRenderOptions

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

Proprietățile reflectă pe cele ale AgileEncryptionParameters. Aceasta encryption_type proprietatea este "standard".

Funcții ale modulului

encrypt_xlsx

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

Citește fișierul XLSX de la input_path, îl criptează cu password folosind specificat encryption_params, și scrie fișierul criptat în output_path.

decrypt_xlsx

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

Decriptează fișierul XLSX de la input_path folosind password și scrie fișierul XLSX în clar la output_path. Returnează True dacă decriptarea a reușit, False dacă parola a fost incorectă sau fișierul nu a fost criptat.

get_default_encryption_params

get_default_encryption_params() -> AgileEncryptionParameters

Returnează o AgileEncryptionParameters instanță configurată cu AES_256, SHA512, și spin_count=100000. Folosește aceasta pentru a inspecta sau clona valorile implicite ale bibliotecii înainte de personalizare.

ImageRenderOptions

Criptează 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)

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

Deschide un fișier criptat direct

ImageRenderOptions Workbook constructor acceptă, de asemenea, un password parametru pentru a deschide fișiere criptate fără un pas separat de decriptare:

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

Vezi și

• Cells Python API Reference acasă
• Referință clasă Workbook
• Începeți
• Ghid pentru dezvoltatori