Encryption — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss palaiko AES šifravimą ir dešifravimą XLSX failų per modulio lygio funkcijas encrypt_xlsx ir decrypt_xlsx. Du parametrų klasės konfigūruoja šifro algoritmą, maišos algoritmą ir PBKDF2 sukimosi skaičių. Rekomenduojama numatytoji reikšmė yra AgileEncryptionParameters su AES-256 ir 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 yra IntEnum nurodantis AES rakto ilgį. Visi variantai naudoja AES CBC režimu su 16 baitų bloko dydžiu.

ImageRenderOptions

HashAlgorithm

HashAlgorithm yra IntEnum nurodanti hash funkciją, naudojamą PBKDF2 rakto išvestyje.

ImageRenderOptions

AgileEncryptionParameters

AgileEncryptionParameters konfigūruoja Agile šifravimo schemą (ECMA-376, 4 dalis), kuri yra numatytasis ir rekomenduojamas formatas šiuolaikiniams Excel failams (Excel 2010+).

ImageRenderOptions

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

ImageRenderOptions

StandardEncryptionParameters

StandardEncryptionParameters konfigūruoja Standartinę šifravimo schemą, kad būtų suderinama su Excel 2007. Pirmenybė AgileEncryptionParameters naujiems failams.

ImageRenderOptions

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

Savybės atspindi tas, kurios AgileEncryptionParameters. Šis encryption_type ypatybė yra "standard".

Modulio funkcijos

encrypt_xlsx

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

Nuskaito XLSX failą adresu input_path, šifruoja jį su password naudojant nurodytą encryption_params, ir įrašo šifruotą failą į output_path.

decrypt_xlsx

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

Iššifruoja XLSX failą, esantį input_path naudojant password ir įrašo nešifruotą XLSX į output_path. Grąžina True jei dešifravimas pavyko, False jei slaptažodis buvo neteisingas arba failas nebuvo užšifruotas.

get_default_encryption_params

get_default_encryption_params() -> AgileEncryptionParameters

Grąžina AgileEncryptionParameters egzempliorių sukonfigūruotą su AES_256, SHA512, ir spin_count=100000. Naudokite tai norėdami peržiūrėti arba klonuoti bibliotekos numatytąsias reikšmes prieš pritaikant.

ImageRenderOptions

Šifruoti darbaknygę

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)

Dešifruoti darbaknygę

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

Atidaryti šifruotą failą tiesiogiai

ImageRenderOptions Workbook konstruktorius taip pat priima a password parametras atidaryti šifruotus failus be atskirų dešifravimo žingsnių:

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

Žr. taip pat

• Cells Python API nuoroda pagrindinis
• Workbook klasės nuoroda
• Pradžia
• Kūrėjo vadovas