class HexaPDF::Encryption::StandardSecurityHandler

Parent	HexaPDF::Encryption::SecurityHandler

The password-based standard security handler of the PDF specification, identified by a /Filter value of /Standard.

Overview¶ ↑

The PDF specification defines one security handler that should be implemented by all conforming PDF libraries and applications. This standard security handler allows access permissions and a user password as well as an owner password to be set.

See StandardSecurityHandler::EncryptionOptions for all valid options that can be used with this security handler when encrypting a document. And see prepare_decryption for all allowed options when decrypting a document.

The access permissions (see StandardSecurityHandler::Permissions) can be used to restrict what a user is allowed to do with a PDF file.

When a user or owner password is specified, a PDF file can only be opened when the correct password is supplied. To open such an encrypted PDF file, the decryption_opts provided to HexaPDF::Document.new needs to contain a :password key with the password.

See: PDF2.0 s7.6.4

Constants

PASSWORD_PADDING¶

The padding used for passwords with fewer than 32 bytes. Only used for revisions <= 4.

See: PDF2.0 s7.6.4.3

Public Instance Methods

encrypt_stream(obj)¶

Calls superclass method HexaPDF::Encryption::SecurityHandler#encrypt_stream

encryption_key_valid?()¶

Additionally checks that the document trailer's ID has not changed.

See: SecurityHandler#encryption_key_valid?

Calls superclass method HexaPDF::Encryption::SecurityHandler#encryption_key_valid?

permissions()¶

Returns the permissions of the managed dictionary as array of symbol values.

See: Permissions