Encryption — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss atbalsta AES šifrēšanu un atšifrēšanu XLSX failiem, izmantojot moduļa līmeņa funkcijas encrypt_xlsx un decrypt_xlsx. Divas parametru klases konfigurē šifra algoritmu, hešu algoritmu un PBKDF2 grieziena skaitu. Ieteicamā noklusējuma vērtība ir AgileEncryptionParameters ar AES-256 un 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 ir IntEnum norādot AES atslēgas garumu. Visas variācijas izmanto AES CBC režīmā ar 16 baitu bloka izmēru.

ImageRenderOptions

HashAlgorithm

HashAlgorithm ir IntEnum norādot haša funkciju, kas tiek izmantota PBKDF2 atslēgas izveidei.

ImageRenderOptions

AgileEncryptionParameters

AgileEncryptionParameters konfigurē Agile Encryption shēmu (ECMA-376, part 4), kas ir noklusējuma un ieteicamais formāts modernām Excel failiem (Excel 2010+).

ImageRenderOptions

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

ImageRenderOptions

StandardEncryptionParameters

StandardEncryptionParameters konfigurē Standarta šifrēšanas shēmu, lai nodrošinātu saderību ar Excel 2007. Ieteicams AgileEncryptionParameters jauniem failiem.

ImageRenderOptions

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

Īpašības atspoguļo AgileEncryptionParameters. Īpašība encryption_type īpašība ir "standard".

Moduļa funkcijas

encrypt_xlsx

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

Nolasīt XLSX failu no input_path, šifrē to ar password izmantojot norādīto encryption_params, un raksta šifrēto failu uz output_path.

decrypt_xlsx

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

Atšifrē XLSX failu vietā input_path izmantojot password un raksta nešifrēto XLSX uz output_path. Atgriež True ja atšifrēšana izdevās, False ja parole bija nepareiza vai fails nebija šifrēts.

get_default_encryption_params

get_default_encryption_params() -> AgileEncryptionParameters

Atgriež AgileEncryptionParameters instanci, kas konfigurēta ar AES_256, SHA512, un spin_count=100000. Izmantojiet to, lai pārbaudītu vai klonētu bibliotēkas noklusējuma iestatījumus pirms pielāgošanas.

ImageRenderOptions

Šifrēt darba grāmatu

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)

Atšifrēt darba grāmatu

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

Atvērt šifrētu failu tieši

ImageRenderOptions Workbook konstruktors arī pieņem password parametru, lai atvērtu šifrētus failus bez atsevišķa atšifrēšanas soļa:

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

Skatīt arī

• Cells Python API atsauce sākums
• Workbook klases atsauce
• Iepazīšanās
• Izstrādātāju ceļvedis