Encryption — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss støtter AES-kryptering og -dekryptering av XLSX-filer via modulnivå-funksjonene encrypt_xlsx og decrypt_xlsx. To parametereklasser konfigurerer krypteringsalgoritmen, hash-algoritmen og PBKDF2 spinntelling. Den anbefalte standarden er AgileEncryptionParameters med AES-256 og 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 er en IntEnum som angir AES-nøkkellengden. Alle varianter bruker AES i CBC-modus med en blokkstørrelse på 16 byte.

ImageRenderOptions

HashAlgorithm

HashAlgorithm er en IntEnum som angir hash-funksjonen som brukes for PBKDF2-nøkkelavledning.

ImageRenderOptions

AgileEncryptionParameters

AgileEncryptionParameters konfigurerer Agile Encryption‑skjemaet (ECMA-376, del 4), som er standard‑ og anbefalt format for moderne Excel‑filer (Excel 2010+).

ImageRenderOptions

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

ImageRenderOptions

StandardEncryptionParameters

StandardEncryptionParameters konfigurerer Standard Encryption‑skjemaet for kompatibilitet med Excel 2007. Foretrekk AgileEncryptionParameters for nye filer.

ImageRenderOptions

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

Egenskapene speiler de av AgileEncryptionParameters. Den encryption_type egenskap er "standard".

Modulfunksjoner

encrypt_xlsx

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

Leser XLSX-filen på input_path, krypterer den med password ved å bruke den angitte encryption_params, og skriver den krypterte filen til output_path.

decrypt_xlsx

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

Dekrypterer XLSX-filen på input_path ved bruk av password og skriver den ukrypterte XLSX-en til output_path. Returnerer True hvis dekryptering lyktes, False hvis passordet var feil eller filen ikke var kryptert.

get_default_encryption_params

get_default_encryption_params() -> AgileEncryptionParameters

Returnerer en AgileEncryptionParameters instans konfigurert med AES_256, SHA512, og spin_count=100000. Bruk dette for å inspisere eller klone bibliotekets standardinnstillinger før tilpasning.

ImageRenderOptions

Krypter en arbeidsbok

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)

Dekrypter en arbeidsbok

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

Åpne en kryptert fil direkte

ImageRenderOptions Workbook konstruktøren godtar også en password parameter for å åpne krypterte filer uten et separat dekrypteringssteg:

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

Se også

• Cells Python API-referanse hjem
• Workbook-klasse referanse
• Kom i gang
• Utviklerguide