Struct SecurityHandler 

pub struct SecurityHandler { /* private fields */ }

A security handler, authenticated and ready to decrypt.

Implementations

impl SecurityHandler

pub fn new( encrypt: &Dict, id0: &[u8], password: &[u8], ) -> Result<SecurityHandler, Error>

Authenticates against /Encrypt with password, trying it as the user password and then as the owner password. id0 is the first element of the trailer’s /ID.

pub fn permissions(&self) -> u32

The /P permission bits.

pub fn is_authenticated(&self) -> bool

Whether a password matched, so every class of data can be decrypted.

pub fn authentication(&self) -> Authentication

Which password authenticated.

pub fn revision(&self) -> i64

The security handler revision (/R).

pub fn encrypt_metadata(&self) -> bool

Whether metadata streams are encrypted.

pub fn string_method(&self) -> CryptMethod

The method for strings.

pub fn stream_method(&self) -> CryptMethod

The method for streams.

pub fn embedded_file_method(&self) -> CryptMethod

The method for embedded file streams.

pub fn decrypt(&self, id: ObjId, method: CryptMethod, data: &[u8]) -> Vec<u8>

Decrypts data belonging to object id with method.

pub fn decrypt_strings(&self, id: ObjId, object: &mut Object)

Decrypts every string inside object (recursively), for object id. Streams’ data is left alone; see SecurityHandler::decrypt.

impl SecurityHandler

pub fn new_aes256( user_password: &[u8], owner_password: &[u8], permissions: Permissions, encrypt_metadata: bool, entropy: &dyn Entropy, ) -> (SecurityHandler, Dict)

Creates a revision 6 (AES-256) handler for writing, and the /Encrypt dictionary that describes it (Algorithms 8, 9 and 10).

pub fn can_encrypt(&self) -> bool

Whether this handler can encrypt new data: only AES-256 is ever written (D4); a file using RC4 or AES-128 must be re-encrypted by a full save instead.

pub fn encrypt( &self, method: CryptMethod, data: &[u8], entropy: &dyn Entropy, ) -> Result<Vec<u8>, Error>

Encrypts data for object id with method (AES-256 or Identity).

pub fn encrypt_strings( &self, object: &mut Object, entropy: &dyn Entropy, ) -> Result<(), Error>

Encrypts every string inside object in place (streams’ data is left to SecurityHandler::encrypt).

Trait Implementations

impl Clone for SecurityHandler

fn clone(&self) -> SecurityHandler

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SecurityHandler

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

Formats the value using the given formatter.