Credential Attributes
Prerequisites
Credentials for document certification and digital signatures:
You have configured the Web Service SSL Connection as described in Configuration of the Web Service SSL Connection.
Password and alias
To use a credential, you need a password and an alias for the credential.
Additional credential attributes
In addition to the required password and alias, you can also configure the following optional attributes, depending on the type of credential you have installed.
After installing a credential and registering its password, you must configure the credential so that it can be correctly and securely used by the system. Each credential record specifies the credential type and alias, and the location or filename of the credential. You must specify the information that pertains to each credential that you have installed.
A credential can be one of three types:
● P12 Record
● HSM Record
● MSCAPI Record
Each of these file types has a number of attributes that must also be set. The file types and their attributes are described in the following table:
Credential Attributes
Attribute |
Description |
P12 Record |
HSM Record |
MSCAPI Record |
Alias |
The name by which the credential is known to the PDF Manipulation Module API. The alias value must be unique. |
X |
X |
X |
P12 |
The filename of the credential file (.pfx file). |
X |
- |
- |
Sha1 |
Credential files can contain multiple keys used for various purposes. The file contains a thumbprint or sha1 value that is used to distinguish among different keys. The sha1 value can be obtained from within the credential file. If the thumbprint is not provided, and multiple appropriate keys are available, a CredentialLoginFailure exception is raised. |
X |
X |
X |
DLL Path |
The path to the library file that implements the PKCS#11 interface for that particular HSM. The DLL Path can point anywhere in the file system. (Although the attribute is called DLL Path, its value can be any type of library file, including library files used for UNIX.) |
- |
X |
- |
Slot |
The slot number that identifies where the private key is stored in the HSM. |
- |
X |
- |