Configuring VidSigner
VidSigner is a third-party product which can be integrated into OpenKM to allow digital signature of a document.
Some configuration properties are needed:
| Field / Property | Type | Description |
|---|---|---|
| vidsigner.user | String |
Name of the user given 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 if want to sign the document in any device associated with the subscription. In this case, you can find the document in the device, enabling search mode in configuration and finding by OpenKM user. |
| vidsigner.notification.url | String |
The URL where the notification will be sent: http://openkm.your-domain.com/OpenKM/services/rest/signed |
| vidsigner.preproduction.mode | Boolean |
Set to true to test vidsigner in pre production mode. |
| vidsigner.sign.page | String | The page where to show the signature image. If it is set to zero then the signature will be invisible. |
| vidsigner.sign.posX | String | The X position in millimeters where to place the signature image. |
| vidsigner.sign.posY | String | The Y position in millimeters where to place the signature image. |
| 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 detail log with all the information of the call to VidSigner service |
In addition, you have to create a user in OpenKM with the name and password given by VidSigner to your subscription.
Also, you have to create two new Automations on event Set metadata group (at post) and associate to the first one the action VidSigner Document To Sign and to the second the action VidSigner Document Signed.
Finally, you have to register this group of metadata:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE property-groups PUBLIC "-//OpenKM//DTD Property Groups 2.8//EN"
"http://www.openkm.com/dtd/property-groups-2.8.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>
