Signatures can be added to any form using one of the methods listed:

• Signature Control
• Signed Sections

The signature control only captures a handwritten signature image. It does not create a digital signature.  A signed section that is set to wet signature both captures a handwritten signature image and creates a digital signature over the contents of the section. See below.

Digital Signature

The user must be authenticated to the server. Here is how it works:

 uses public key cryptography. When a  server is first started, it generates a public and a private key. This is automatically generated using the RSA algorithm. There is no official certificate authority (CA); however, if you want one you can supply your own public and private keys that are certified by some authority (like Verisign). An official CA is not required, since the data is signed by and verified by using keys generated by . You must keep the private key "private" by setting up good security practices to the server's disk. The public key may be shared with anyone and, in fact, if you manage the server as the admin user, and click on Security you can see the public key displayed there.

When a section is signed, the data in the section, together with a time stamp, the signing user, and a few other things are used to generate a message digest. The message digest is digitally signed using the private key. The signatures (there can be more than one) are included with the submission – in the repository and sent in the HTTP POST so you can save it yourself if you want.

When the form is re-initialized from the submission documents, you must also supply the signatures. The initialization process will verify that the data has not changed (i.e., has not been tampered with) and the signature is still valid. If the signature is not valid, it is removed and the entire Section is displayed with a visible error (large red background). If it is valid, there is a green background and the Section cannot be edited.

Wet Signature Control

You can use the signature control to place a signature anywhere in your form. Wet signatures allow the user to enter their signature using either a track pad/mouse, stylus or a touch screen during form completion. Authentication to the server is not required. Wet signatures are supported on Signed Form Sections where the designer can choose text/image or wet signature formats.  Wet signatures will be optionally rendered on the pdf/print copy of the form. Your browser must support HTML5 canvas technology for proper signature entry functionality.  Here is a list of browsers that can be used:

• Internet Explorer 9 +

• Firefox 3.6 +

• Chrome 6+

• Safari 5.1+

• IOS: Tablet: 3.2+, Phone: 3.1+

When designing a form with an electronic wet signature control, the captured signature is attached to the form submission as a PNG image attachment. Any frevvo document actions affecting the form data includes the signature png image. For example, should you choose to post the data to your web application, then the signature png is part of that posted data. Should you choose to email the data, the signature png will be attached to the email. Finally, should you choose none of these things, then the captured signature png is available for downloading by browsing your submissions within . See Submissions Stored Inside of frevvo for the details.

Signed Sections

provides true digital signature functionality via a section control in your form. The granularity is at the section control, so that different parts of the form can be signed by different people rather than a signature being applied only to the entire form. You must be an authenticated user to sign a section whether you choose Wet Signature or Text/Signature Image on the section security tab in the designer.

A signed section containing required controls and a wet signature type show an error if the section is invalid. The signed section in the image contains a required Radio control.

If a user clicks the Sign this section button, signs when the signature lightbox appears and then clicks Done, without checking Yes or No for the Approval control, this error message comes back from the server. 

If the selected signature type is Text/Signature image, the error will be seen as soon as the Sign this section button is clicked.

Signed Section Signature Options

You can choose the signature format for a signed section in your form. Select any section control on your form and click the Security tab in the properties panel. The bottom portion of the tab is relevant to signatures. Refer to Security Properties for information on the Role dropdown. The drop down select has three options:

• None Required - no signature required, section not digitally signed.
• Text/Signature Image - This is the same as selecting the signature check box in previous versions. An uploaded signature image for the user will be used, if one is available. The user's name will be printed otherwise.
• Wet Signature -  will present the signature entry dialog to capture the user's signature.

The default value is None Required. The Must sign property makes the signature required. With Must sign, a form cannot be submitted or a workflow is not sent to the next person until the signature is added. Lock sign means that the next person in the workflow can not remove the signature and edit the signed data. A good use case is an employee performance review where the manager starts the form, and signs the review, and sends it to the employee. You would check Lock sign so the employee cannot unsign and edit the data entered by the manager.

Checking Must Sign will disable the None Required option from the Signature dropdown and automatically selects Text/Signature Image. You can change the Signature dropdown to Wet Signature.  

Sections that are hidden/not hidden via a rule or the Visible property in the designer, behave as stated below with respect to Must Sign:

• If the must sign section is visible, then you must sign to get the form valid, regardless of the section's required status.
• If the must sign section is invisible and required and contains required controls, then the form cannot become valid.
• If the must sign section is invisible and not required, then the section becomes valid and the form becomes valid.

All of the standard properties and settings apply to the signature control. For example, the required setting can be used to force the entry of a wet signature in order for the form to be valid (in use mode). You can change the width of the signature light box by changing the value of the Width property grid to another value. 

Signed Sections and Wet Signatures in Use Mode

Here is an example of a standard signed section on a Leave Approval form when the signature property is set to Text/Signature Image. Click anywhere in the signature panel or click the Sign this section button to sign.

The Edit button will show Sign this section if the signature lightbox is empty. Clicking anywhere in the signature panel or on the Edit this section clears the signature and the date. The user can sign again, if desired.

Here is an example of a standard signed section on a form when the signature property is set to Wet Signature. If the section is signed, the user can modify it by selecting the Edit this section button. The button will toggle to Sign this section and the wet signature and date in the lightbox will clear.

Clicking on the Sign this section button, displays the signature entry lightbox shown in the image below provided an external signature device is not configured. See Signature control for details on its operation. Note that the signature image is scaled appropriately.The user will have to re-sign in order to re-lock the section.

Installing the Topaz Electronic Signature Pad

Follow these steps to install the software/hardware:

1. Download the Topaz SigPlus software:
   1. Navigate to the topaz website.
   2. Choose the link for the Topaz model number you are using.
   3. Only download and install SigPlus. Other software downloads from that page are not required.
   4. Install the SigPlus software.
2. Download the Topaz SigWeb software:
   1. Navigate to the Topaz SigWeb Browser API page.
   2. Choose the link for the model number suffix found on the back of the signature pad.
   3. Download the SigWeb Browser API for that model.
   4. Install the downloaded sigweb.exe.
3. Connect the Topaz Electronic Signature Device to your computer. Windows may install an additional driver if necessary.
4. Topaz provides a test site where you can verify that the signature tablet is working correctly. Click here, click the Sign button then sign using the signature pad. Your signature should appear at the top of the screen.

Turning on the Topaz Electronic Signature Pad in Forms/Flows

It is up to the designer to specify the forms and steps in a workflow, that will be using the Topaz signature tablet. Simply click the cog icon in the forms designer to display the form property panel. You will notice the Allow Sign Pad property is not checked (default). Check this property to change the runtime behavior of the signature dialog and allow users to sign with the external signature pad.

The Allow Sign Pad property is also available at on the step property panel in the flow designer. This allows the designer to specify the steps in a flow that will be using the external signature pad. Click on the steps that you want to use the signature pad with and check the Allow Sign Pad checkbox. Leave the property unchecked on the steps that will not be using the signature pad.

Consider a three step workflow used by officers to obtain a blood warrant from a judge. Step one is performed by the arresting police officer and requires a signature. In the harsh environment of a police station or jail. the Topaz Electronic Signature Pad is a good inexpensive and sturdy option. Step two is performed by a judge who accesses the flow from a mobile device. Step 2 is not configured for the signature pad. When the judge completes Step 2 and signs, the flow is routed back to the police officer who performs the third step and signs using the signature tablet again.

frevvo and the Topaz Signature Pad at Runtime

Here's how it works:

Forms and steps of a flow that have the Allow Sign Pad property checked at design time display the signature dialog shown in the image when a Wet Signature control or a signed section that contains a Wet Signature control is encountered:

Notice the Use Signature Pad button. Until the user selects this button, the attached external signature pad is not enabled and regular signing via the mouse or touch screen is still possible. If Allow Sign Pad is not checked, the Use Signature Pad button is not visible.

When the Use Signature Pad button is selected, the signature dialog displays as shown:

The attached signature pad "takes over" the signing area and it is no longer possible to sign with the mouse or touch pad. Once the user signs with the attached pad, the on-screen Done button is selected to accept the signature. If the Use Signature Pad button is clicked in error, click the Cancel button. 

If you see the error shown below, check your software/hardware installation.