Struct EncryptionHandler 

pub struct EncryptionHandler { /* private fields */ }

Main encryption handler for PDF documents.

This struct manages the encryption state and provides methods for authenticating passwords and decrypting content.

Implementations

impl EncryptionHandler

pub fn new(encrypt_obj: &Object, file_id: Vec<u8>) -> Result<Self>

Create a new encryption handler from an encryption dictionary.

Arguments

• encrypt_obj - The /Encrypt dictionary object from the PDF trailer
• file_id - The first element of the /ID array from the PDF trailer

Returns

An encryption handler ready for password authentication

pub fn authenticate(&mut self, password: &[u8]) -> Result<bool>

Authenticate with a password.

This attempts to authenticate with the given password as either a user password or owner password. If successful, the encryption key is derived and stored for future decryption operations.

Arguments

• password - The password to authenticate (empty string for no password)

Returns

Ok(true) if authentication succeeded, Ok(false) if it failed, or an error if the encryption is unsupported.

pub fn is_authenticated(&self) -> bool

Check if the handler has been authenticated.

pub fn encryption_key(&self) -> Option<&[u8]>

Get the encryption key (if authenticated).

pub fn permissions(&self) -> Permissions

Get the permissions.

pub fn algorithm(&self) -> Algorithm

Get the encryption algorithm.

pub fn decrypt_stream( &self, data: &[u8], obj_num: u32, gen_num: u32, ) -> Result<Vec<u8>>

Decrypt a stream using the encryption key.

PDF Spec: Section 7.6.2 - General Encryption Algorithm

Arguments

• data - The encrypted stream data
• obj_num - Object number
• gen_num - Generation number

Returns

The decrypted stream data, or an error if decryption fails

pub fn decrypt_string( &self, data: &[u8], obj_num: u32, gen_num: u32, ) -> Result<Vec<u8>>

Decrypt a string using the encryption key.

Arguments

• data - The encrypted string data
• obj_num - Object number
• gen_num - Generation number

Returns

The decrypted string data

Trait Implementations

impl Clone for EncryptionHandler

fn clone(&self) -> EncryptionHandler

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for EncryptionHandler

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.