Security
Security Essentials
12
T
ABLE
12.1
SignatureInfo Properties
Property
Description
Physical location or hostname
Modification detection and prevention setting
(
allowNone
,
allowAll
,
default
,
defaultAndComments
)
Name of the user
Number of fields altered since the previous signature
Number of fields filled in since the previous signature
Number of pages altered since the previous signature
The number of revisions in the document
Reason for signing
Signature revision
Validity status (
4
represents a completely valid
signature)
String representation of signature status
Formats used for public key signatures
Security handler used to validate signature
location
mdp
name
numFieldsAltered
numFieldsFilledIn
numPagesAltered
numRevisions
reason
revision
status
statusText
subFilter
verifyHandlerName
verifyHandlerUIName
Handler specified by
verifyHandlerName
Encrypting Files Using Certificates
When you invoke the
doc
object’s
encryptForRecipients
method, it encrypts the
document using the public key certificates of each recipient. The groups of recipients are
specified in the
oGroups
parameter, which is an array of
Group
objects, each of which
contains two properties:
permissions
and
userEntities
. The
userEntities
property is an array of
UserEntity
objects (described below in
Table 12.2),
each of which
describes a user and their associated certificates, and is returned by a call to the
dirConnection
object’s
search
method. The associated certificates are represented in
a property containing an array of
Certificate
objects (described below in
Table 12.3),
each of which contains read-only access to the properties of an X.509 public key certificate.
To obtain a group of recipients (the
oGroups
parameter mentioned above), you may
invoke the
security
object’s
chooseRecipientsDialog
method, which opens a
dialog box prompting the user to choose a list of recipients.
Acrobat JavaScript Scripting Guide
203