SecurityHandler Methods

The method is called when a user tries to set security for an encrypted document and when a user tries to open a file. It must decide, based on the contents of the authorization data structure, whether or not the user is permitted to open the file, and what permissions the user has for this file.

A callback method indicating repeated failed authorization. Override this callback in order to provide a UI feedback for failed authorization. Default implementation returns immediately.

Changes the master/owner password.

Changes master password

Changes revision number

Changes the user password.

Changes user password

Called when the security handler should activate a dialog box with the current security settings that may be modified.

Determines whether the specified Object is equal to the current Object.

Fills the document's Encryption dictionary with whatever information the security handler wants to store in the document. The sequence of events during creation of the encrypt_dict is as follows:

• encrypt_dict is created(if it does not exist)
• Filter attribute is added to the dictionary
• call this method to allow the security handler to add its own attributes
• call the GetCryptKey to get the algorithm version, key, and key length
• checks if the V attribute has been added to the dictionary and, if not, then sets V to the algorithm version
• set the Length attribute if V is 2 or greater
• add the encrypt_dict to the document

This method is invoked in case Authorize() failed.The callback must determine the user’s authorization properties for the document by obtaining authorization data(e.g. a password through a GUI dialog).The authorization data is subsequently used by the security handler’s Authorize() to determine whether or not the user is authorized to open the file.

Gets the encryption algorithm id.

Gets the handler doc name.

Serves as a hash function for a particular type.

Gets the key length.

Gets master password

Gets permission

Gets revision number

Gets the Type of the current instance.

Gets user password

Occurs when authorization fails

Initializes the password.

Clones instance of SecurityHandler.

Checks if AES encryption algorithm is used

The following function can be used to verify whether a given stream is encrypted using AES.

Checks if master password required

If the user changes SecurityHandler's settings(e.g. by changing a password), IsModified() should return true.

Checks if RC4 encryption algorithm is used

Checks if user password required

Sets whether to encrypt metadata

The method allows derived classes to set SecurityHandler is modified flag. This method should be called whenever there are changes(e.g. a password change) to the SecurityHandler

The method allows derived classes to set SecurityHandler is modified flag. This method should be called whenever there are changes(e.g. a password change) to the SecurityHandler

Set the permission setting of the StdSecurityHandler.

Returns a string that represents the current object.