security constants

Beginning with Acrobat 7.0, several convenience strings are defined within the security object. The constants are held as properties of the wrapper objects listed below.

HandlerName object

These are constants used when determining which handler to use.

Property	Type	Access	Description
StandardHandler	String	R	This value can be specified in the handler property for a SecurityPolicy object that is based on the Standard (password-based) security handler.
PPKLiteHandler	String	R	This value can be specified in the handler property for a SecurityPolicy object that is based on the PPKLite (certificate-based) security handler. This value can also be passed to security.getHandler to create a new security context.
APSHandler	String	R	This the value specified in the handler property for a SecurityPolicy object that is based on the Adobe Policy Server security handler. This value can also be passed to security.getHandler to create a new security context.

Example

The constant (string) security.StandardHandler is used to specify the handler property of the SecurityPolicy object.

security.getHandler(security.PPKLiteHandler, true);

EncryptTarget Object

These constants are used when determining what data a policy is encrypting. They can be used in the target property of the SecurityPolicy object.

Property	Type	Access	Description
EncryptTargetDocument	String	R	The Security Policy encrypts the entire document when applied.
EncryptTargetAttachments	String	R	The Security Policy encrypts only the file attachments embedded within the document. This means the document can be opened, but attachments cannot be opened without providing the correct security authentication. It is used for eEnvelope workflows.

Example

var filterOptions = { target: security.EncryptTargetAttachments };

security.chooseSecurityPolicy( { oOptions: filterOptions } );