Installation & Help Guide

SigWeb Browser SDK

Version 1.7
January 11, 2021

Copyright © 2021 Topaz Systems Inc. All rights reserved.

For Topaz Systems, Inc. trademarks and patents, visit www.topazsystems.com/legal.
 SigWeb Installation Guide

Table of Contents
Installation................................................................................................................................ 3
Requirements ..................................................................................................................................... 3
First-Time Install Steps....................................................................................................................... 3
Re-Installation Steps .......................................................................................................................... 4
SigWeb Test Utility ............................................................................................................................. 5

SigWeb Cert Checker Software Package............................................................................... 5

Background ........................................................................................................................................ 5
Overview ............................................................................................................................................ 5
Process Description ........................................................................................................................... 5
SigWebCertCheckerConfigs.xml ........................................................................................................ 6
Description...................................................................................................................................... 6
Configurations ................................................................................................................................ 6
PFXConfigs.xml ................................................................................................................................. 7
Description...................................................................................................................................... 7
Configurations ................................................................................................................................ 7

Help & Support ........................................................................................................................ 7

2 www.topazsystems.com Back to Top

 SigWeb Installation Guide

Installation

Requirements

• Microsoft .NET Framework Version 4.7.1 or later required.

First-Time Install Steps

Follow Steps 1-4 here if you have never installed SigWeb before:

1. Download the SigWeb installer at: www.topazsystems.com/software/sigweb.exe.

2. Before installing, be sure to close all open browsers (i.e. Chrome, Firefox, Internet
Explorer, etc).

3. Run the SigWeb installer (right-click and select “Run as Administrator”).

Note: Do not connect your signature pad until installation is complete.

4. Once complete, test SigWeb with the SigWeb Demo at this page:
www.sigplusweb.com/sigwebtablet_demo.htm. Click “Sign” and sign on your
signature pad; your signature will appear in the signature box.

3 www.topazsystems.com Back to Top

 SigWeb Installation Guide

Re-Installation Steps

Follow Steps 1-2 here if SigWeb has already been installed and you are performing a re-install:

1. Under “Start” → “Control Panel” → “Programs and Features”, right-click on “SigWeb”,

and choose “Uninstall”. Allow the “Uninstall” to complete.

Note: If you do not see the “Programs and Features” option under the “Control Panel”,
click “View by:” in the top right of your window, and select “Small icons”.

2. Follow the steps in the first section of this guide called “First-Time Install Steps” in
order to install SigWeb properly.

3. If you wish to keep the “Tablet Configuration” screen and use the configuration from the
previous installation, click the “Keep Current SigPlus.ini Settings” button in the lower-left
corner of the “Tablet Configuration” screen.

4 www.topazsystems.com Back to Top

 SigWeb Installation Guide

SigWeb Test Utility

You can test the SigWeb installation by running the SigWeb Test Utility
(SigWeb_Test_Utility.exe), which can be downloaded from the Topaz website at:
www.topazsystems.com/sdks/sigweb.html.

SigWeb Cert Checker Software Package

Background

SigWeb requires an SSL certificate to be installed to allow communication between Topaz

signature pads and a webpage within a secure context (https). If a valid SSL certificate is not
installed on the client machine, then SigWeb will not function within secure web contexts
(https). Topaz provides a default SSL certificate; customers can also use their own certificate.

SSL certificates expire every year for security reasons. Thus, the SSL certificate must be
checked and updated annually. Topaz developed the SigWeb Certificate Updater to automate
this process when using Topaz certificates. Other certificates will require customers to
customize their own configuration and the JavaScript used to reference the location. The
Topaz Developer Support Team is available to assist in this process at
[email protected].

Overview

The SigWeb Certificate Updater checks the SigWeb certificate’s status and notifies users
and/or updates the SigWeb certificate before it expires. The process runs every time SigWeb
starts and begins checking for the availability of an updated certificate 60 days before the
certificate expires.

The particulars can be configured by modifying the “SigWebCertCheckerConfigs.xml” file and

other files referenced within this xml file. If an automatic certificate update isn’t desired, then it
must be disabled by changing the value of utcDateUpdated to “none” in the
“SigWebCertCheckerConfigs.xml” file.

Process Description

The SigWeb Certificate Updater thread runs with system-level privileges as part of the Topaz
SigWeb Tablet Service. If there is a new version of the certificate available, it notifies the user
(if enabled) and allows them to choose to update the certificate. Otherwise, it silently attempts
to update the certificate. After a successful install, the “SigWebCertCheckerConfigs.xml” file is
updated with the new certificate data and “PFXConfigs.xml” data.

5 www.topazsystems.com Back to Top

 SigWeb Installation Guide

SigWebCertCheckerConfigs.xml

The “SigWebCertCheckerConfigs.xml” file configures the SigWeb Certificate Updater’s

operations.

Description

This file is the base configuration file that configures the information to use for checking the
SigWeb certificate, notifying users, and retrieving the updated certificate.

Configurations

certificate: Defines the thumbprint and subjectName to use for finding the SigWeb certificate.
This information is automatically updated when a new SigWeb certificate is installed. DO NOT
MODIFY.

thumbprint: The thumbprint used for finding the SigWeb certificate. If cannot find the certificate
by the thumbprint, then it will search by the subjectName.

subjectName: The subjectName used for finding the SigWeb certificate. Each element within
the subjectName must match the certificate’s subjectName’s elements exactly.

notification: Defines when to show notifications in the SigWebCertUpdater and

SigWebCertStatusNotifier applications.

showPopupNotifications: If set to true, show notifications. If set to false, then do not show
notifications.

pfx: Defines the location and update status of the PFXConfigs.xml file.

pfxConfigsURL: Address to the PFXConfigs.xml file that configures the PFX location and data.

- URI Schema must be: 'file:///', 'http://', or 'https://'.

- For local or network files, use 'file:///'.
- For HTTP, use 'http://' or 'https://'

utcDateUpdated: UTC Date that is compared with the PFXConfigs.xml file to detect whether
there is an update to the PFX file that needs to be installed. Determines if a new certificate is
available. DO NOT MODIFY unless you are trying to disable automatic certificate update. To
disable automatic certificate update, set to “none”.

6 www.topazsystems.com Back to Top

 SigWeb Installation Guide

PFXConfigs.xml

Description

This file is the base configuration file used for determining the location of the new certificate
(PFX file), decryption information, and date this file was updated.

Configurations

pfxURL: Link to the PFX file that is used to install the SigWeb certificate.

pfxDataURL: Link to data used for installing the SigWeb certificate.

iv: IV used for decrypting information.

utcDateUpdated: UTC Date that is compared with the SigWebCertCheckerConfigs.xml file to

determine whether there is an update to the PFXConfigs.xml file. Determines if a new
certificate is available.

pfxConfigsURL: Link to this PFXConfigs.xml file. Used to allow the SigWebCertUpdater

application to change the location of the PFXConfigs.xml within the
SigWebCertCheckerConfigs.xml file. If not set, then the SigWebCertCheckerConfigs.xml file
will not be modified.

Help & Support

You can test the SigWeb installation by running the SigWeb Test Utility
(SigWeb_Test_Utility.exe), which can be downloaded from the Topaz website at:
www.topazsystems.com/sdks/sigweb.html.

For troubleshooting help or assistance, view the “Software FAQ” tab on the Topaz Software
FAQ page at www.topazsystems.com/faq.html, or contact Topaz Dev Software Support at
[email protected].

Silent installers are available upon request. Visit the Topaz SigWeb page at
www.topazsystems.com/sdks/sigweb.html for details.

7 www.topazsystems.com Back to Top