Encryption — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss menyokong penyulitan AES dan penyahkodan fail XLSX melalui fungsi peringkat modul encrypt_xlsx dan decrypt_xlsx. Dua kelas parameter mengkonfigurasi algoritma cipher, algoritma hash, dan kiraan putaran PBKDF2. Lalai yang disyorkan ialah AgileEncryptionParameters dengan AES-256 dan 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 adalah satu IntEnum yang menentukan panjang kunci AES.

ImageRenderOptions

HashAlgorithm

HashAlgorithm adalah satu IntEnum yang menentukan fungsi hash yang digunakan untuk penurunan kunci PBKDF2.

ImageRenderOptions

AgileEncryptionParameters

AgileEncryptionParameters mengkonfigurasi skema Penyulitan Agile (ECMA-376, bahagian 4), yang merupakan format lalai dan disyorkan untuk fail Excel moden (Excel 2010+).

ImageRenderOptions

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

ImageRenderOptions

StandardEncryptionParameters

StandardEncryptionParameters mengkonfigurasi skema Penyulitan Standard untuk keserasian dengan Excel 2007. Lebih suka AgileEncryptionParameters untuk fail baru.

ImageRenderOptions

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

Ciri-ciri mencerminkan milik AgileEncryptionParameters. Itu encryption_type Ciri ialah "standard".

Fungsi Modul

encrypt_xlsx

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

Membaca fail XLSX di input_path, menyulitkannya dengan password menggunakan yang ditentukan encryption_params, dan menulis fail yang dienkripsi ke output_path.

decrypt_xlsx

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

Menyahsulit fail XLSX di input_path menggunakan password dan menulis XLSX teks jelas ke output_path. Mengembalikan True jika penyahsulitan berjaya, False jika kata laluan tidak betul atau fail tidak disulitkan.

get_default_encryption_params

get_default_encryption_params() -> AgileEncryptionParameters

Mengembalikan satu AgileEncryptionParameters instans yang dikonfigurasikan dengan AES_256, SHA512, dan spin_count=100000. Gunakan ini untuk memeriksa atau menyalin lalai perpustakaan sebelum menyesuaikan.

ImageRenderOptions

Menyulitkan Buku Kerja

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)

Menyahsulitkan Buku Kerja

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

Buka Fail Tersulit Secara Langsung

ImageRenderOptions Workbook pembina juga menerima satu password parameter untuk membuka fail yang disulitkan tanpa langkah penyahsulitan berasingan:

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

Lihat Juga

• Sel Python Rujukan API laman utama
• Rujukan kelas Workbook
• Mula Menggunakan
• Panduan Pembangun