Encryption — Aspose.Cells FOSS for Python API Reference

az aspose-cells-foss támogatja az AES titkosítást és visszafejtést XLSX fájlok esetén a modul szintű függvényeken keresztül encrypt_xlsx és decrypt_xlsx. AgileEncryptionParameters Az ajánlott alapértelmezett «<SEG_4»> AES-256 és SHA-512 használatával.

ImageRenderOptions: aspose.cells_foss

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

CipherAlgorithm

CipherAlgorithm egy IntEnum amely meghatározza az AES kulcs hosszát.

ImageRenderOptions

HashAlgorithm

HashAlgorithm egy IntEnum amely meghatározza a PBKDF2 kulcs származtatáshoz használt hash függvényt.

ImageRenderOptions

AgileEncryptionParameters

AgileEncryptionParameters beállítja az Agile Encryption sémát (ECMA-376, 4. rész), amely az alapértelmezett és ajánlott formátum a modern Excel fájlokhoz (Excel 2010+).

ImageRenderOptions

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

ImageRenderOptions

StandardEncryptionParameters

StandardEncryptionParameters beállítja a Standard Encryption sémát az Excel 2007 kompatibilitás érdekében. Inkább AgileEncryptionParameters új fájlokhoz.

ImageRenderOptions

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

A tulajdonságok tükrözik a(z) AgileEncryptionParameters. A encryption_type tulajdonság "standard".

Modul függvények

encrypt_xlsx

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

Beolvassa az XLSX fájlt a input_path, titkosítja a következővel password a megadott használatával encryption_params, és a titkosított fájlt ide írja output_path.

decrypt_xlsx

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

Dekódolja a XLSX fájlt a input_path használva password és a tiszta szöveges XLSX-et írja ide output_path. Visszaadja True ha a dekódolás sikeres, False ha a jelszó helytelen vagy a fájl nincs titkosítva.

get_default_encryption_params

get_default_encryption_params() -> AgileEncryptionParameters

Visszaad egy AgileEncryptionParameters példányt, amely a következőkkel van konfigurálva AES_256, SHA512, és spin_count=100000. Használja ezt a könyvtár alapértelmezéseinek megtekintésére vagy klónozására testreszabás előtt.

ImageRenderOptions

Munkafüzet titkosítása

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)

Munkafüzet visszafejtése

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

Titkosított fájl közvetlen megnyitása

ImageRenderOptions Workbook a konstruktor továbbá elfogad egy password paramétert a titkosított fájlok megnyitásához külön dekódolási lépés nélkül:

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

Lásd még

• Cellák Python API Referencia kezdőlap
• Workbook osztályreferencia
• Első lépések
• Fejlesztői útmutató