Plug-in configuration
The signotec Adobe Acrobat plug-in is highly customizable. The following sections explain how to perform the configuration via the UI or via a configuration file and what configurations and options are available.
Configuration UI
All of the plug-in’s settings can be configured easily from the graphic configuration interface.
The configuration UI can be started in Adobe Acrobat from “Files → Plug-ins → signotec Acrobat plug-in configuration,” Alternatively, the application for configuration can be started by means of “PDFPluginCfg.exe” in the installation directory (standard: %PROGRAMFILES%\signotec\Adobe PlugIn\Configuration).
When the graphic interface is called for the first time, the file “stsignpdf.ini” is copied to “%APPDATA%\signotec\Adobe Plugin”. All changes are saved in the file in the %APPDATA% directory and are therefore user-specific. If the user has administrator rights, the changes are also saved in the main file in the %PROGRAMDATA% directory.
When the plug-in is installed, it can be configured that changes to the settings are fundamentally only possible with administrator rights.
Configuring the file manually
Fully manual configuration of the signotec Adobe Acrobat plug-in is possible by means of the file “stsignpdf.ini”. The configuration file is installed in “%PROGRAMDATA%\signotec\Adobe Plug-In” and when the graphic interface is called for the first time, it is copied to %APPDATA%\signotec\Adobe Plug-In and loaded from there. This means that the settings are user-specific.
When the plug-in is installed, it can be configured that changes to the settings are fundamentally only possible with administrator rights.
Settings
Option | Description |
---|---|
ShowUserName / Name | Specifies whether the text entered in the input field “Name” during the signing process will also be displayed in the signature field.
Default value: 1 | Fallback: 0 |
DefaultUsername / default name | Specifies the text displayed as the default entry in the “Name” input field during the signing process. The plug-in saves the last 20 entries and makes them available in a drop-down list. The values are saved in the registry under the following key: HKCU\SOFTWARE\signotec\PDFPlugin\Usernames\stsignpdf\NameItems. This information is displayed in the signature field if “ShowUserName=1” or the setting “Name” has been set to “Display name in the signature field”. The name is only added to the certificate and the signature overview if a temporary certificate is used under “SigningMode”. Otherwise the name (“cn” entry) of the certificate is used. This is intended by the PDF standard and cannot be changed. Default value: empty |
UsernameRequired / mandatory field | Specifies whether a entering a name during the signing process should be mandatory.
Default value: 0 | Fallback: 0 |
ShowReason / reason | Specifies whether the text entered in the input field “Reason” during the signing process will also be displayed in the signature field.
Default value: 0 | Fallback: 0 |
DefaultReason / default reason | Specifies the text displayed as the default entry in the “Reason” input field during the signing process. The parameters “ReasonItem0” to “ReasonItem4” (or the “+” button in the UI) can be used to add up to five different additional reasons which can be selected during the signing process. Default value: empty |
ShowTimestamp / timestamp | Specifies whether a timestamp is displayed in the signature field.
Default value: 1 | Fallback: 0 |
LockFormfieldsAfterSigning / lock form fields | Specifies which form fields are locked after a signature has been captured.
Default value: 2 | Fallback: 2 |
SigningMode / signature mode | Specifies which certificate is used for the digital signature.
You can create your own certificate by selecting “Create new digital ID” from the UI. The certificate is created in the Windows certificate store (certmgr.msc) under “Own certificates” and saved automatically under “DefaultDigitalID” in the plug-in. Default value: 2 | Fallback: 0 |
DefaultDigitalID / digital ID | Specifies which digital ID is used for signing if SigningMode=3 or signature mode “Certificate as digital ID” is configured. |
BioEncryptionMode / biometrics mode | Specifies which certificate is used for encrypting the biometric date of the signature.
You can create your own certificate by selecting “Create new digital ID” from the UI. The certificate is created in the Windows certificate store (certmgr.msc) under “Own certificates” and saved automatically under “BiometricEncryptionKeystoreID” in the plug-in. As standard, the plug-in contains a public key certificate for the encryption of the biometric data with the private key stored at a notary’s office. Even signotec, as the vendor, does not have access to this private key, so that only the notary is able to decrypt signatures. Default value: 3 | Fallback: 1 |
BiometricEncryptionKeystoreID / digital ID | Specifies which digital ID is used for encryption if BioEncryptionMode=4 or biometric data mode “Encryption with digital ID” is configured. |
ShowAGB / mode | Specifies whether a confirmation text is displayed on the signature pad before signing. 0 = do not display a confirmation text on the signature pad 1 = display a confirmation text on the signature pad If a signotec Sigma Lite is used with firmware older than 2.4, the confirmation text must be deactivated. Default value: 1 | Fallback: 1 |
AGBTextHead / header (optional) | Defines the header of the confirmation text. Default value: “Note” |
XFADataFieldX / X.XFA field (optional) | The parameters XFADataField1-4 are used to specify whether content from the XFA form fields within the document are displayed in the confirmation text. The assignment is made via the name of the form field. If “ShowAGB=0” or the selection “Do not display confirmation text on the signature pad” is defined, this option is ignored. Default value: empty |
AGBTextTail / text (optional) | Specifies whether confirmation text should be displayed. If “ShowAGB=0” or the selection “Do not display confirmation text on the signature pad” is defined, this option is ignored. Default value: “As part of the signature capture process, dynamic characteristics such as pressure and writing speed are processed. The secure storage of these biometric data in the document is done in order to later prove that the document has been signed by you.” |
TabletPCPenForced / tablet PC: Signature with pen input only | Specifies whether the signature can be captured exclusively with an electronic pen (digitizer) when Windows tablet PCs or pen displays are used. 0 = disabled: On Windows tablet PCs and pen displayed, the signature can be provided by pen or by touch or mouse input. 1 = enabled: On Windows tablet PCs and pen displays, the signature can be provided exclusively with the electronic pen. Default value: 0 | Fallback: 0 |
TextSpaceInPercent / size of text in signature field in percent | Defines the size of the additional information (name, reason and timestamp) within the signature field. The value entered defines in percent (1–100) the height within the signature field that is used for the additional information. Default value: 30 |
Logging / create error log file | Specifies whether an error log file should be created. The log files are stored with the file name “STSignPDF-{Datum}.txt” in the %USERPROFILE% directory. 0 = disabled: No error log is created. 1 = enabled: An error log is created. Default value: 0 | Fallback: 0 |
PenSignatureColor / signature color | Determines the color of the signature. 0 = blue 1 = black 2 = red 3 = green Default value: 0 | Fallback: 0 |
USERNAME_FROM_SIGNATUREFIELDS | This parameter can be used to specify a value for each signature field that is automatically used in the “Name” input field during the signing process. This setting can only be configured via the technical configuration file. The assignment is made via the technical name of the signature field. (“TU” entry), not the display name (“QuickInfo”). Default value: Inactive |
Reset settings
To reset the settings to default, the following steps must be taken:
Delete “stsignpdf.ini” under “%PROGRAMDATA%\signotec\Adobe Plug-In”
Delete “stsignpdf.ini” under “%APPDATA%\signotec\Adobe Plug-In”
Copy backup of “stsignpdf.ini” from the installation directory (standard: %PROGRAMFILES%\signotec\Adobe PlugIn\Documentation) to “%PROGRAMDATA%\signotec\Adobe Plug-In”