Install DIGIPASS Gateway using Windows Installer

You can install DIGIPASS Gateway using a Windows installation package (MSI). This installation package installs an Apache Tomcat web server to deploy the DIGIPASS Gateway web service.

If you want to just deploy the DIGIPASS Gateway web service to an existing web server, you can deploy the respective web application files instead (see Deploy DIGIPASS Gateway using web application files).

Before you begin

  • Ensure that the default port used by DIGIPASS Gateway is not used by another service or program, i.e. port 11080 (see Configure your firewall).

  • DIGIPASS Gateway cannot be installed if the fully qualified domain name (FQDN) of the server starts with a number, e.g. 001234-MYHOST. In that case, the setup will issue an error when it attempts to generate a self-signed certificate for the Apache Tomcat web server. Ensure that the FQDN meets this requirement.

Install DIGIPASS Gateway on Windows

To install DIGIPASS Gateway on Windows

  1. Run the DIGIPASS Gateway setup package, i.e. digipass-gateway_5.9.0_x64.msi.
  2. Click Next to begin.
  3. Read the OneSpan license agreement text, select I accept the terms in the license agreement and click Next.

  4. (OPTIONAL) Specify the destination folder.

    The default destination folder is %PROGRAMFILES%\OneSpan\DIGIPASS Gateway.

  5. Click Install to start the installation.

    DIGIPASS Gateway is being installed. An embedded Apache Tomcat web server is installed and the DIGIPASS Gateway web service is deployed to it.

    If OneSpan Authentication Server has already been installed on the same machine, DIGIPASS Gateway is configured to use the local OneSpan Authentication Server instance automatically. Otherwise, DIGIPASS Gateway remains unconfigured and you need to configure it later manually (see Additional tasks).

Upgrade DIGIPASS Gateway

When DIGIPASS Gateway is already installed and you run the Windows installer provided with the new version of the DIGIPASS Gateway package, the product is upgraded automatically once the installation process is completed. The existing configuration settings of the product are preserved.

Supported upgrade path

The current supported upgrade path is from version 5.7 or 5.8 to version 5.9.0 on the supported operating systems.

Additional considerations

  • The embedded Apache Tomcat web server runs on a dedicated embedded Java Runtime Environment (JRE) automatically installed by the installation package.
  • The embedded Apache Tomcat web server is automatically configured to secure connections to the DIGIPASS Gateway web service via TLS v1.2. A TLS certificate and a random password are generated for that purpose.
  • To use a different TLS certificate or to configure SSL/TLS certificates for Apache Tomcat, you need to import the certificate file manually to the keystore after you configured the certificate.

Additional tasks

If OneSpan Authentication Server has not already been installed on the same machine during the DIGIPASS Gateway setup, you will need to configure the DIGIPASS Gateway web service accordingly using the OneSpan Web Configuration Tool (see Configure DIGIPASS Gateway).

Next steps

If required, verify and perform any post-installation task necessary to complete the installation (see Post-installation tasks and considerations).