Encryption

Encryption — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss understøtter AES-kryptering og -dekryptering af XLSX-filer via modulniveau-funktionerne encrypt_xlsx og decrypt_xlsx. To parametertklasser konfigurerer krypteringsalgoritmen, hash-algoritmen og PBKDF2 spin-tællingen. Den anbefalede standard er AgileEncryptionParameters med AES-256 og SHA-512.

Example: aspose.cells_foss

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

CipherAlgorithm

CipherAlgorithm er en IntEnum der angiver AES-nøglelængden. Alle varianter bruger AES i CBC-tilstand med en blokstørrelse på 16 byte.

Example	Nøglebits	`alg_id`
`AES_128`	128	—
`AES_192`	192	—
`AES_256`	256	—

Example

Example	Example	Example
`algorithm_name`	`str`	Example `"AES"`.
`key_bits`	`int`	AES-nøglelængde i bits (128, 192 eller 256).
`alg_id`	`int`	Numerisk algoritmeidentifikator brugt i OOXML-krypteringsposten.
`key_bytes`	`int`	Nøglelængde i byte (`key_bits // 8`).
`block_size`	`int`	Example `16` (AES-blokstørrelse i byte).

HashAlgorithm

HashAlgorithm er en IntEnum der angiver hash-funktionen, der bruges til PBKDF2-nøgleafledning.

Example	Hash-bytes	`alg_id`
`SHA1`	20	—
`SHA256`	32	—
`SHA384`	48	—
`SHA512`	64	—

Example

Example	Example	Example
`algorithm_name`	`str`	Navn på hash-funktion (f.eks., `"SHA-512"`).
`hash_bytes`	`int`	Digest-længde i byte.
`alg_id`	`int`	Numerisk algoritmeidentifikator brugt i OOXML‑krypteringsposten.

AgileEncryptionParameters

AgileEncryptionParameters konfigurerer Agile Encryption‑skemaet (ECMA-376, del 4), som er standard‑ og anbefalet format for moderne Excel‑filer (Excel 2010+).

Example

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

Example	Example	Example	Example
`cipher_algorithm`	`CipherAlgorithm`	`AES_256`	AES‑nøglelængde der skal bruges.
`hash_algorithm`	`HashAlgorithm`	`SHA512`	Hash‑funktion til PBKDF2‑nøgleafledning.
`spin_count`	`int`	`100000`	Antal PBKDF2-iterationer. Højere værdier øger modstand mod brute‑force på bekostning af åbning-/gemningstid.

Example

Example	Example	Example
`encryption_type`	`str`	Example `"agile"`.
`cipher_algorithm`	`CipherAlgorithm`	Konfigureret cipher.
`hash_algorithm`	`HashAlgorithm`	Konfigureret hash-funktion.
`spin_count`	`int`	PBKDF2-iterationsantal.
`salt_size`	`int`	Saltlængde i bytes (afledt af cipher-blokstørrelse).
`block_size`	`int`	Cipher-blokstørrelse i bytes (altid `16` for AES).
`key_bits`	`int`	Nøglelængde i bits.

StandardEncryptionParameters

StandardEncryptionParameters konfigurerer Standard Encryption‑skemaet for kompatibilitet med Excel 2007. Foretræk AgileEncryptionParameters for nye filer.

Example

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

Egenskaberne spejler dem fra AgileEncryptionParameters. Den encryption_type egenskab er "standard".

remove_at

encrypt_xlsx

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

Læser XLSX-filen på input_path, krypterer den med password ved brug af den angivne encryption_params, og skriver den krypterede fil til output_path.

Example	Example	Example
`input_path`	`str`	Sti til kilde‑XLSX‑filen.
`output_path`	`str`	Destinationssti for den krypterede fil. Kan være den samme som `input_path` for kryptering på stedet.
`password`	`str`	Krypteringsadgangskode.
`encryption_params`	`AgileEncryptionParameters	StandardEncryptionParameters

decrypt_xlsx

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

Dekrypterer XLSX-filen på input_path ved hjælp af password og skriver den ukrypterede XLSX til output_path. Returnerer True hvis dekryptering lykkedes, False hvis adgangskoden var forkert, eller filen ikke var krypteret.

get_default_encryption_params

get_default_encryption_params() -> AgileEncryptionParameters

Returnerer en AgileEncryptionParameters instans konfigureret med AES_256, SHA512, og spin_count=100000. Brug dette til at inspicere eller klone bibliotekets standardindstillinger før tilpasning.

Example

Krypter en projektmappe

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)

Dekrypter en projektmappe

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

Åbn en krypteret fil direkte

Example Workbook konstruktøren accepterer også en password parameter til at åbne krypterede filer uden et separat dekrypterings trin:

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

Encryption — Aspose.Cells FOSS for Python API Reference

CipherAlgorithm

Example

HashAlgorithm

Example

AgileEncryptionParameters

Example

Example

StandardEncryptionParameters

Example

remove_at

encrypt_xlsx

decrypt_xlsx

get_default_encryption_params

Example

Krypter en projektmappe

Dekrypter en projektmappe

Åbn en krypteret fil direkte

Se også