Laserfiche On-Premise Adapter Deployment Guide

GovOS Studio (SeamlessDocs)

Velosimo Laserfiche REST API Deployment Guide

Install Velosimo Laserfiche adapter is a required element for On-premise LF customers

Overview

This is the deployment guide for Velosimo Laserfiche Connector. The Connector is deployed to an on-premise Internet Information Server (IIS). See the diagram above for an illustration of the complete architecture.

Prerequisites

  1. .Net App Pool requires the use of .Net 4.5 (see install step 4)
  2. A publicly available IP address to your Laserfiche server
  3. Enable the Windows Feature HTTPS Activation, found under .Net Framework 4.7 > WCF Services (this might require a server restart)

Installers

Download the following files to the IIS server:

velosimofiles
Velosimo Laserfiche REST APIPlease contact Velosimo support to obtain the installers
Laserfiche SDK RuntimePlease contact Velosimo support to obtain the installers

Deployment Steps to IIS Server

Install Laserfiche SDK Runtime

  1. Download the LaserficheSDKRuntimeInstaller.exe to the Windows Server containing IIS

  2. Run LaserficheSDKRuntimeInstaller.exe on the Windows Server and follow the setup to completion.

Install Velosimo Laserfiche REST API

  1. Extract the contents of the Velosimo Laserfiche API.zip file into the C:\inteput\velosimo folder. If this folder does not exist, please created it. Please make sure to follow this folder structure:

  1. Open IIS Manager.

  2. In IIS Manager, on the left pane expand the Server node then right click Sites subnode and select Add Website option to add a new Web Application.

  1. In the configuration dialog click Select on the Application Pool button and select .NET 4.5 from the AppPool list.

  1. Type the site name “Velosimo Laserfiche API” and then select the physical path of the installation files.

  1. Add HTTPS bindings & confirm that the SSL certificate is up to date.

  1. Once the bindings are configured & certificate updated, IIS Manager can be closed.

  1. Create a publicly accessible IP address to this new Web Application. Typically configurations use either a reverse proxy in a DMZ or a firewall rule allowing Velosimo to connect to this IP:port. You can restrict access to IP addresses 54.70.20.215, 35.164.131.175, 3.222.241.24.

Note: In addition to whitelisting the IP addresses both inbound and outbound traffic must be open for communication on the secured port(s).

9.Finished.

Validation

To validate Laserfiche is ready to authorize in Velosimo Admin:

  1. Open a Web Browser and navigate to the public IP address of the server you created, also including the following path /laserfiche/api/authenticate

If you see the following XML response, you are ready to authorize Laserfiche using Velosimo Admin.

Server Requirements

Software Requirements
LaserficheLaserfiche 10.2 or higher
Operating SystemWindows Server 2019 or 2016
Web ServerInternet Information Server 10
Frameworks.NET 4.5+ Framework
Minimum Server Hardware Requirements
CPUDual Core 2Ghz or higher
Memory8 GB
Disk100 GB free disk space
Network Speed100 Mbps
Firewall Rules
Port443
Restrict to IP54.70.20.215, 35.164.131.175, 3.222.241.24, 54.71.13.61, 3.89.78.236, 34.200.119.39, 34.202.31.200, 52.0.244.9, 54.173.16.61, 54.174.42.90 (IPs of incoming Velosimo Cloud connections)
Note:In addition to whitelisting the IP addresses both inbound and outbound traffic must be open for communication on the secured port(s).