Digi-Sign, The Certificate Corporation
Published on Digi-Sign, The Certificate Corporation (http://www2.digi-sign.com)

Home > Installation Guide

By Digi-Sign
Created Sep 25 2008 - 19:25

Installation Guide

3 Simple Steps

Converting your online forms to forms that will have legal value is simple with Digi-Seal™. There are three simple steps to getting Digi-Seal&trade active on your electronic forms (and you can probably implement these in a few hours):

        • Decide on how many digital signatures you need for your user group

        • Get your web developer to add some code to your forms

        • Upload the Digi-Seal™ software to your server



The simplicity of the implementation means that you can have digital signature capability on your forms in a matter of hours. You don't need to send data outside your network and you continue to retain total control of your forms and business processes.

Order Digi-Seal™ >> [1]

Read each step in more detail below

Step 1 - Ordering the Digi-Seal™ Applet

Number of Users

Digi-Seal™ enables users to sign any online form, or file upload. In order to use the Digi-Seal™, the user must first have their own digital signature certificate [Digi-ID™ [2]].

The simplest way to get each user their digital signature is to use the Total Trust Management™ [3] service. Or you can use the Digi-CA™ [4] system and issue the certificate yourself.

Either way, when placing your order [1], you should decide on the approximate number of people you want to use your online forms.

Step 2 of 3 >> [5]


Step 2 - Edit/Create Forms

Modify/Create your Web Forms

To run the Web Forms Signer Applet you need the following files:

  • HTML page containing the applet
  • WebFormSignerApplet.jar

Embedding the Applet in a HTML Page

For the applet to work with the most popular browsers (IE, Mozilla, etc), your web developer should follow these guidelines:

Using a combination of <object> and <embed> tags. You should note the following:

  • Internet Explorer
    • Recognizes the <object> tag
    • Ignores the contents of the <comment> tag


  • Mozilla browsers
    • Ignore an <object> tag with the classid attribute
    • Interpret the contents of the <comment> tag



  • Add the <applet> tag



    The sample HTML pages [6] shows how to embed the applet in a HTML form using the tag <applet> in the first example, and a combination of <object> and <embed> tags in the second example.

    You can also 'view source' on the Digi-Seal™ online demo [7]

    Step 3 of 3 >> [8]


    Step 3 - Install the Digi-Seal™ Applet

    Upload the Applet

    Simply place the WebFormSignerApplet.jar in the same direcotry as the forms and you're done.

    Order Digi-Seal™ >> [1]


    Digi-Seal™ Sample HTML Code

    Sample HTML code using <applet> tag

    An example of a HTML page (Web form) referencing the Web Form Signing Applet is given below. In this example the applet is embedded into the Web form with the <applet> tag.
    <html>

    <head>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
    <title>Personal Data Form</title>
    </head>

    <body>
    <form name="formPersonalData">

    <strong>Personal Data Form</strong>

    First name: <input name="textBoxFirstName" type="text" />

    Last name: <input name="textBoxLastName" type="text" />

    Gender:
    <select name="dropDownListGender">
    <option value="Male">Male</option>
    <option value="Female">Female</option>
    </select>

    Marital status:
    <input type="radio" name="radioMaritalStatus" value="Single" />Single<br />
    <input type="radio" name="radioMaritalStatus" value="Married" />Married<br />
    <input type="radio" name="radioMaritalStatus" value=" Divorced" />Divorced<br />

    Comments:
    <textarea name="textAreaComments" rows="2" cols="20"></textarea>

    Upload CV (file upload):
    <input type="file" name="fileUploadCV" />

    <input type="checkbox" name="checkBoxTermsAgree" />
    <label for="checkBoxTermsAgree">I agree to the terms and conditions</label>

    <applet
    code="com.digisign.applet.WebFormSignerApplet"
    archive="WebFormSignerApplet.jar"
    width="150"
    height="30"
    mayscript="true"
    signButtonCaption="Sign form"
    inputForm="formPersonalData"
    ignoredFields="xml"
    textBoxFormFieldsXML="xml"
    outputForm="formSignature"
    textBoxPkcs7Signature="textBoxPkcs7Signature"
    maxFileSize="1"
    debugMode="false">WebFormSignerApplet
    </applet>

    XML for signing (built from the form fields):
    <textarea name="xml" style="height: 130px; width: 390px;"
    readonly="true" wrap="off"></textarea>
    </form>

    <br/>

    <form name="formSignature" method="post" action="DigitalVerifierServlet">

    <strong>Signature Form</strong>

    PKCS#7 Signed Data (the result of signing):
    <textarea name="textBoxPkcs7Signature" style="height: 130px; width: 390px;"
    readonly="true" wrap="off"></textarea>

    <input type="submit" name="buttonSubmit" value="Send Signed Data" />

    </form>

    </body>
    </html>

    Sample HTML code using <applet> tag

    An example of a HTML page (Web form) referencing the Web Form Signing Applet is given below. In this example a combination of <object> and <embed> tags is used.

    <html>

    <head>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
    <title>Personal Data Form</title>
    </head>

    <body>
    <form name="formPersonalData">

    First name: <input name="textBoxFirstName" type="text" />

    Last name: <input name="textBoxLastName" type="text" />

    Gender:
    <select name="dropDownListGender">
    <option value="Male">Male</option>
    <option value="Female">Female</option>
    </select>

    Marital status:
    <input type="radio" name="radioMaritalStatus" value="Single" />Single<br />
    <input type="radio" name="radioMaritalStatus" value="Married" />Married<br />
    <input type="radio" name="radioMaritalStatus" value=" Divorced" />Divorced<br />

    Comments:
    <textarea name="textAreaComments" rows="2" cols="20"></textarea>

    Upload CV (file upload):
    <input type="file" name="fileUploadCV" />

    <input type="checkbox" name="checkBoxTermsAgree" />
    <label for="checkBoxTermsAgree">I agree to the terms and conditions</label>

    <object
    classid="clsid:8AD9C840-044E-11D1-B3E9-00805F499D93"
    codebase="http://java.sun.com/products/plugin/autodl/jinstall-1_5-windows-
    i586.cab#Version=1,5,0,0"
    width="90" height="30" mayscript="true">
    <param name="type" value="application/x-java-applet;version=1.5">
    <param name="code" value="com.digisign.applet.WebFormSignerApplet">
    <param name="archive" value="WebFormSignerApplet.jar">
    <param name="mayscript" value="true">
    <param name="signButtonCaption" value="Sign form">
    <param name="inputForm" value="formPersonalData">
    <param name="ignoredFields" value="xml">
    <param name="textBoxPkcs7Signature" value="textBoxPkcs7Signature">
    <param name="maxFileSize" value="1">
    <param name="debugMode" value="false">
    <comment> <embed
    type="application/x-java-applet;version=1.5"
    pluginspage="http://java.sun.com/products/plugin/index.html#download"
    code="com.digisign.applet.WebFormSignerApplet"
    archive="WebFormSignerApplet.jar" width="90" height="30"
    mayscript="true" scriptable="true"
    signButtonCaption="Sign form"
    inputForm="formPersonalData"
    ignoredFields="xml"
    textBoxFormFieldsXML="xml"
    outputForm="formSignature"
    textBoxPkcs7Signature="textBoxPkcs7Signature"
    maxFileSize="1"
    debugMode="false">
    <noembed>
    Document signing applet can not be started because Java Plugin 1.5 is
    not installed. </noembed> </embed> </comment>
    </object>

    XML for signing (built from the form fields):
    <textarea name="xml" style="height: 130px; width: 390px;"
    readonly="true" wrap="off"></textarea>

    </form>

    <br/>

    <form name="formSignature" method="post" action="DigitalVerifierServlet">

    <strong>Signature Form</strong>

    PKCS#7 Signed Data (the result of signing):
    <textarea name="textBoxPkcs7Signature" style="height: 130px; width: 390px;"
    readonly="true" wrap="off"></textarea>

    <input type="submit" name="buttonSubmit" value="Send Signed Data" />
    </form>

    </body>
    </html>


    Note:- Some web browsers will allow the applet to run JavaScript and to access the HTML document, but only if this is explicitly set by the parameters or attributes of the tag by which it is embedded in the web page. Such parameters are “mayscript” and “scriptable”, and they must have value “true”.


    Source URL: http://www2.digi-sign.com/digi-seal/installation

    Links:
    [1] http://www2.digi-sign.com/order/digi-seal
    [2] http://www2.digi-sign.com/digi-id
    [3] http://www2.digi-sign.com/digi-ca/total+trust+management/index
    [4] http://www2.digi-sign.com/digi-ca
    [5] http://www2.digi-sign.com/digi-seal/installation/step+2
    [6] http://www2.digi-sign.com/digi-seal/installation/sample
    [7] http://www2.digi-sign.com/demoexec/digi-seal
    [8] http://www2.digi-sign.com/digi-seal/installation/step+3