Encryption — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss mendukung enkripsi dan dekripsi AES pada file XLSX melalui fungsi tingkat modul encrypt_xlsx dan decrypt_xlsx. Dua kelas parameter mengonfigurasi algoritma cipher, algoritma hash, dan hitungan spin PBKDF2. Default yang direkomendasikan adalah 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 sebuah IntEnum yang menentukan panjang kunci AES. Semua varian menggunakan AES dalam mode CBC dengan ukuran blok 16 byte.

ImageRenderOptions

HashAlgorithm

HashAlgorithm adalah sebuah IntEnum yang menentukan fungsi hash yang digunakan untuk derivasi kunci PBKDF2.

ImageRenderOptions

AgileEncryptionParameters

AgileEncryptionParameters Mengonfigurasi skema Agile Encryption (ECMA-376, bagian 4), yang merupakan format default dan direkomendasikan untuk file Excel modern (Excel 2010+).

ImageRenderOptions

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

ImageRenderOptions

StandardEncryptionParameters

StandardEncryptionParameters mengonfigurasi skema Enkripsi Standar untuk kompatibilitas dengan Excel 2007. Lebih disarankan AgileEncryptionParameters untuk file baru.

ImageRenderOptions

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

Properti mencerminkan milik AgileEncryptionParameters. The encryption_type properti adalah "standard".

Fungsi Modul

encrypt_xlsx

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

Membaca file XLSX di input_path, mengenkripsinya dengan password menggunakan yang ditentukan encryption_params, dan menulis file terenkripsi ke output_path.

decrypt_xlsx

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

Mendekripsi file XLSX di input_path menggunakan password dan menulis XLSX plaintext ke output_path. Mengembalikan True jika dekripsi berhasil, False jika kata sandi salah atau file tidak dienkripsi.

get_default_encryption_params

get_default_encryption_params() -> AgileEncryptionParameters

Mengembalikan sebuah AgileEncryptionParameters instance yang dikonfigurasi dengan AES_256, SHA512, dan spin_count=100000. Gunakan ini untuk memeriksa atau menyalin default perpustakaan sebelum menyesuaikannya.

ImageRenderOptions

Enkripsi Workbook

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)

Dekripsi Workbook

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 File Terenkripsi Secara Langsung

ImageRenderOptions Workbook constructor juga menerima sebuah password parameter untuk membuka file terenkripsi tanpa langkah dekripsi terpisah:

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 Referensi API beranda
• Referensi kelas Workbook
• Memulai
• Panduan Pengembang