To install Velocity Web Services Client (VWSC) after Velocity is installed:
Search for the vwc2install.exe file in the Velocity folder. Typically, the file is installed in C:\Program Files (x86)\Identiv\Velocity\ path.
Right-click the vwc2install.exe file to Run as administrator.
The EULA screen appears. Read the License Agreement and scroll down to the bottom to click the Accept button.
Select the Install Velocity Web Service and IIS Client Website (Recommended) option in the Application Install Options window.
Enter the user account (by default in the VelocityServices group) that the underlying service for the Velocity Web Services Client will use to log on to Velocity. Enter the password that the specified Service Account will use to log on to Velocity. Click Next.
The Velocity Web Services Client Installer will check for system prerequisites to install the Velocity Web Services.
Starting with Velocity 3.8.5, the .NET Framework 4.8 runtime is bundled with Velocity, eliminating the need for downloading online. Except for Windows Server 2022, older OS Server versions, such as Windows Server 2019/2016, do not come with the .NET Framework 4.8 pre-installed.
After checking the System Prerequisites, the Service and Website Settings window for the service configuration appears.
In the Service and Website Settings window, you will need to select a communication mode of “HTTP (Deprecated)” (non-secure) or “HTTPS (Recommended)” (secure).
Select the default port number 2026, or specify a different value. Finally, you will need to choose an IIS Configuration of “Forms Authentication (Recommended)” or “Windows Authentication.” Click Next.
Wait until the installer completes the Velocity Web Services Client installation.
In the Application Installation of the Velocity Web Services Client installer, Click Next.
After the installation is complete, a completion screen like the one below appears. Click Close to finish.
The sections “Using HTTPS Communication” and “Using HTTP Communication” on this page explain the Forms Authentication and Windows Authentication IIS Configuration and SSL certificate fields supported in the Service and Website Settings window.
Using HTTPS Communication
Only servers configured with HTTPS and an SSL certificate from a trusted certificate authority can enable the newly introduced two-factor authentication feature, offering users additional security benefits. Due to security restrictions, servers configured with HTTP or self-signed certificates will have this option disabled to maintain system integrity and protect user security.
Forms Authentication
Configuring HTTPS and Forms Authentication in IIS with an SSL certificate:
Forms authentication is commonly used for IIS websites that require user logins, such as web applications, portals, or intranet sites.Select the Communication type option “HTTPS (Recommended).”
The default port number, 2026, should be selected.
Select the “Use Forms Authentication (Recommended)” option in IIS Configuration.
Choose your SSL certificate, or if you do not have one, select the “Identiv Velocity Web Services” self-signed certificate from the SSL certificate drop-down menu if you don’t have one.
Click Next. The VWSC installation is now complete, as shown in step 3.
Windows Authentication
Configuring HTTPS and Windows Authentication in IIS with an SSL certificate:
Windows authentication is often used in intranet environments where the web server and users' computers are part of the exact Windows Active Directory Domain or workgroup.Select the Communication type option “HTTPS (Recommended).”
The default port number, 2026, should be selected.
Select the “Use Windows Authentication” option in IIS Configuration.
Choose your SSL certificate, or if you do not have one, select the “Identiv Velocity Web Services” self-signed certificate from the SSL certificate drop-down menu.
Click Next. The VWSC installation is now complete, as shown in step 3.
Using HTTP Communication
Note that HTTP communication has been deprecated as of the 3.8.6 release and will no longer be supported from version 3.9 onwards. Please switch to HTTPS for more secure communication.
For the IIS setting that is configured using Forms Authentication or Windows Authentication using HTTP, you should be viewing a screen like the one below:
Forms Authentication
Configuring HTTP and Forms Authentication in IIS:
Select the Communication type option “HTTP (Deprecated).”
The default port number, 2026, should be selected.
Select the “Use Forms Authentication (Recommended)” option in IIS Configuration.
Click Next. As in step 3, you will see a screen showing that the VWSC installation is completed.
Windows Authentication
Configuring HTTP and Windows Authentication in IIS:
Select the Communication type option “HTTP (Deprecated).”
The default port number, 2026, should be selected.
Select the “Use Windows Authentication” option in IIS Configuration.
Click Next. As in step 3, you will see a screen showing that the VWSC installation is completed.
The Application Installation window appears; wait until the installer completes the VWSC Website installation.
Click Next to view the completed installation screen.
Click Close. A pop-up screen will launch the Velocity Web Services Client application in your default browser.
Click OK to access your local machine's Velocity Web Services Client login page.
