Configuring VidSigner
VidSigner is a third-party product which can be integrated into OpenKM to allow the digital signature of a document.
Some configuration properties are needed:
| Field / Property | Type | Description |
|---|---|---|
| vidsigner.user | String |
Name of the user provided for the subscription to VidSigner. |
| vidsigner.password | Password |
Password of the user. |
| vidsigner.device.name | String |
Name of the device given by VidSigner where we want to send the document to be signed. Don't set it if you want to sign the document on any device associated with the subscription. In this case, you can find the document on the device by enabling search mode in the configuration and searching by OpenKM user. |
| vidsigner.notification.url | String |
The URL to which the notification will be sent: http://openkm.your-domain.com/openkm/rest/vidSigner |
| vidsigner.preproduction.mode | Boolean |
Set to true to test VidSigner in pre-production mode. |
| vidsigner.sign.page | String | The page where the signature image will be shown. If it is set to zero, the signature will be invisible. |
| vidsigner.sign.posX | String | The X position in millimeters where the signature image should be placed. |
| vidsigner.sign.posY | String | The Y position in millimeters where the signature image should be placed. |
| vidsigner.sign.sizeX | String | The X size in millimeters of the signature image. |
| vidsigner.sign.sizeY | String | The Y size in millimeters of the signature image. |
| vidsigner.generate.log | Boolean | Set to true to generate a detailed log with all the information about the call to the VidSigner service. |
In addition, you have to create a user in OpenKM with the name and password provided by VidSigner for your subscription.
Also, you have to create two new Automations on the event Set metadata group (on post) and associate the action VidSigner Document To Sign with the first and the action VidSigner Document Signed with the second.
Finally, you have to register this group of metadata:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE property-groups PUBLIC "-//OpenKM//DTD Property Groups 3.10//EN"
"http://www.openkm.com/dtd/property-groups-3.10.dtd">
<property-groups>
<property-group label="ViDSigner" name="okg:vidsigner">
<checkbox label="Pending to sign" name="okp:vidsigner.pending" value="true" />
<input label="Document GUI" name="okp:vidsigner.docgui" readonly="true" />
</property-group>
</property-groups>
