Encryption

Encryption — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss podržava AES šifriranje i dešifriranje XLSX datoteka putem funkcija na razini modula encrypt_xlsx i decrypt_xlsx. Dvije klase parametara konfiguriraju algoritam šifre, algoritam hash-a i broj ponavljanja PBKDF2. Preporučena zadana vrijednost je AgileEncryptionParameters s AES-256 i SHA-512.

: aspose.cells_foss

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

CipherAlgorithm

CipherAlgorithm je IntEnum koja specificira duljinu AES ključa. Sve varijante koriste AES u CBC načinu rada s blok veličine 16 bajtova.

	Biti ključa	`alg_id`
`AES_128`	128	—
`AES_192`	192	—
`AES_256`	256	—


`algorithm_name`	`str`	`"AES"`.
`key_bits`	`int`	Duljina AES ključa u bitovima (128, 192 ili 256).
`alg_id`	`int`	Numerički identifikator algoritma koji se koristi u OOXML zapisu šifriranja.
`key_bytes`	`int`	Duljina ključa u bajtovima (`key_bits // 8`).
`block_size`	`int`	`16` (Veličina AES bloka u bajtovima).

HashAlgorithm

HashAlgorithm je IntEnum koja specificira hash funkciju koja se koristi za PBKDF2 derivaciju ključa.

	Hash bajtovi	`alg_id`
`SHA1`	20	—
`SHA256`	32	—
`SHA384`	48	—
`SHA512`	64	—


`algorithm_name`	`str`	Naziv hash funkcije (npr., `"SHA-512"`).
`hash_bytes`	`int`	Duljina digest-a u bajtovima.
`alg_id`	`int`	Numerički identifikator algoritma koji se koristi u OOXML zapisu šifriranja.

AgileEncryptionParameters

AgileEncryptionParameters konfigurira Agile Encryption shemu (ECMA-376, dio 4), koja je zadani i preporučeni format za moderne Excel datoteke (Excel 2010+).

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


`cipher_algorithm`	`CipherAlgorithm`	`AES_256`	Dužina AES ključa koji se koristi.
`hash_algorithm`	`HashAlgorithm`	`SHA512`	Hash funkcija za PBKDF2 derivaciju ključa.
`spin_count`	`int`	`100000`	Broj PBKDF2 iteracija. Veće vrijednosti povećavaju otpor na brute‑force napade uz trošak vremena otvaranja/spremanja.


`encryption_type`	`str`	`"agile"`.
`cipher_algorithm`	`CipherAlgorithm`	Konfigurirani šifrirni algoritam.
`hash_algorithm`	`HashAlgorithm`	Konfigurirana hash funkcija.
`spin_count`	`int`	Broj PBKDF2 iteracija.
`salt_size`	`int`	Duljina soli u bajtovima (izvedena iz veličine bloka šifre).
`block_size`	`int`	Veličina bloka šifre u bajtovima (uvijek `16` za AES).
`key_bits`	`int`	Duljina ključa u bitovima.

StandardEncryptionParameters

StandardEncryptionParameters konfigurira standardni šifrirni sustav za kompatibilnost s Excelom 2007. Preporučuje se AgileEncryptionParameters za nove datoteke.

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

Svojstva odražavaju ona od AgileEncryptionParameters. The encryption_type svojstvo je "standard".

Funkcije modula

encrypt_xlsx

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

Čita XLSX datoteku na input_path, šifrira je pomoću password koristeći navedeni encryption_params, i zapisuje šifriranu datoteku u output_path.


`input_path`	`str`	Put do izvornog XLSX‑datoteke.
`output_path`	`str`	Odredišni put za šifriranu datoteku. Može biti isti kao `input_path` za šifriranje na mjestu.
`password`	`str`	Lozinka za šifriranje.
`encryption_params`	`AgileEncryptionParameters	StandardEncryptionParameters

decrypt_xlsx

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

Dešifrira XLSX datoteku na input_path koristeći password i zapisuje nešifrirani XLSX u output_path. Vraća True ako je dešifriranje uspjelo, False ako je lozinka netočna ili datoteka nije bila šifrirana.

get_default_encryption_params

get_default_encryption_params() -> AgileEncryptionParameters

Vraća AgileEncryptionParameters instancu konfiguriranu s AES_256, SHA512, i spin_count=100000. Upotrijebite ovo za pregled ili kloniranje zadavanja biblioteke prije prilagodbe.

Šifriraj radnu knjigu

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šifriraj radnu knjigu

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

Izravno otvori šifriranu datoteku

Workbook konstruktor također prihvaća password parametar za otvaranje šifriranih datoteka bez zasebnog koraka dešifriranja:

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