|
|
|
|
An array containing the language-dependent names of the available user-configured appearances for the specified security handler. Appearances are used to create the on-page visual representation of a signature when signing a signature field. The name of an appearance can be specified as a signature info object property when signing a signature field using the Field object signatureSign method.
If a security handler does not support selection of appearances, this property will return null.
Array
R
The certificates that are associated with the currently selected digital IDs for this security handler.
Object
R
The return value is a generic object with the following properties:
|
Property |
Type |
Version |
Description |
|---|---|---|---|
|
oEndUserSignCert |
Certificate object |
6.0 |
The certificate that is associated with the currently selected digital IDs that is to be used by this SecurityHandler object when signing. The property is undefined if there is no current selection. |
|
oEndUserCryptCert |
Certificate object |
6.0 |
The certificate that is associated with the currently selected digital IDs that is to be used when encrypting a document with this SecurityHandler object. The property is undefined if there is no current selection. |
|
certs |
Array of Certificate |
6.0 |
An array of certificates corresponding to the list of all digital IDs that are available for this SecurityHandler object. |
|
stores |
Array of Strings |
6.0 |
An array of strings, one for every Certificate object, identifying the store where the digital ID is stored. The string values are up to the security handler. For Adobe.PPKLite the valid values are ‘PKCS12’ and ‘MSCAPI’. |
The Adobe.PPKLite security handler returns all currently available digital IDs present in Password-protected digital ID files (both PKCS#12 and APF) and, on Windows, IDs present in the Windows (MSCAPI) store.
Both oEndUserSignCert and oEndUserCryptCert properties can be set using the user-interface. oEndUserSignCert can also be set using the login method. This means that oEndUserCryptCert will only be returned when using a Security Handler object that is obtained using the getHandler method with bUIEngine set to true.
Export to a file the certificate that is associated with the currently selected digital IDs.
var sh = security.getHandler( "Adobe.PPKMS", true );
var ids = sh.digitalIDs;
var oCert = ids.oEndUserSignCert;
security.exportToFile( oCert, "/c/MySigningCert.cer" );
|
6.0 |
|
|
An array of the available Directory objects for this Security Handler. New Directory objects can be created using the newDirectory method.
Array
R
An array containing the language-independent names of the available directory handlers for the specified security handler. For example, the Adobe.PPKMS security handler has a directory handler named Adobe.PPKMS.ADSI that supports queries using the Microsoft Active Directory Script Interface (ADSI). Valid directory handler names are required when activating a new Directory object using its info property.
Array
R
Returns true, if the security handler is capable of decrypting PDF files.
Boolean
R
Returns true, if the security handler is capable of encrypting PDF files.
Boolean
R
|
5.0 |
|
|
Returns true if currently logged into this SecurityHandler object. See the login method.
Different security handlers will have their own rules for determining the value of this property. The Adobe.PPKLite handler will return true if a user is logged in to a profile file (also called credential file, implemented as a PKCS#12 file). Adobe.PPKMS will always return true.
Boolean
R
Generic script to illustrate isLoggedIn.
var ppklite = security.getHandler("Adobe.PPKLite", true);
console.println( "Is logged in = " + ppklite.isLoggedIn ); // False
ppklite.login( "dps017", "/C/signatures/DPSmith.pfx");
console.println( "Is logged in = " + ppklite.isLoggedIn ); // True
The name associated with the actively selected signing digital ID for the security handler. This may require that the login method be called to select a signing credential. The return value is null if a signing credential is not selected or if the security handler does not support this property.
String
R
The device-independent path to the user’s profile file used to log in to the security handler. The return value is null if no one is logged in, if the security handler does not support this property, or if this property is irrelevant for the currently logged in user.
String
R
The language-independent name of the security handler. Example values for the Default Certificate, Windows Certificate, and Entrust Security Handlers are Adobe.PPKLite, Adobe.PPKMS, and Entrust.PPKEF. All security handlers must support this property.
String
R
Specifies whether the security handler is capable of generating certified documents. A certified document is signed with both a byte-range signature and an object signature. Object signatures, which are generated by traversing the document’s object tree, are used to detect and prevent modifications to a document. See the mdp property of the SignatureInfo object for details regarding modification detection and prevention (MDP) settings.
Boolean
R
Indicates that the security handler is capable of signing FDF files.
Boolean
R
Specifies whether the security handler is capable of generating invisible signatures.
Boolean
R
Indicates whether the security handler is capable of validating signatures.
Boolean
R
Specifies whether the security handler is capable of generating visible signatures.
Boolean
R
The language-dependent string for the security handler. This string is suitable for user interfaces. All security handlers must support this property.
String
R
Returns true, if the security handler is capable of validating signatures over FDF files.
Boolean
R