Special Activations - Static IPs, OnPremises & Proxies

There are a variety of special situations that require you to customize your environment before you can activate. In these situations, the CA doesn't have direct access to the Viakoo Data Center but must go through other means to reach Viakoo. In these situations, you must reconfigure the Viakoo CA so that it can properly reach Viakoo.

This article takes you through the three different setup procedures in the CA Console.

Before you start

Make sure you have already installed the RAs and CA to your on-premises infrastructure. If you have not, please begin here.

Topics in this section include:

  1. Setting Up Static IP Addresses
  2. Setting Up for OnPremises Users
  3. Configuring a Proxy Server

For users with 4192 Agents or later, the activation automatically checks to see if you can reach the default location of the Viakoo service. If that check fails, it will immediately take you to the "Connection Settings" screen (below):Screen_Shot_2019-03-20_at_5.41.23_PM.png

You can also use the administrative menu to choose the "Connection Settings" page from the administrative menu (upper right corner).


In versions of the agent prior to 4192, you will have to request the appropriate page more manually in your browser.


Setting Up Static IP Address

Below are instructions to set up the static IP address.This shouldn’t really be use unless there are very strict firewall settings that require it.

If you choose to set up the firewall with the static IP, then you will also need to do the following modifications for our software to be configured properly.

Here they are below:

A: On the CA host C:\Windows\System32\drivers\etc\hosts

Add following TWO lines: files1.viakoo.com proxy1.viakoo.com

Sample Windows HOSTS files



Now change Viakoo IP Address to: https://proxy1.viakoo.com


After you hit submit, just go back to the main menu and continue the activation process.


Setting Up for OnPremises Users

Changing the path to the Viakoo Service

Instead of beginning the activation immediately, Viakoo OnPremise customers need to change the IP path the CA uses to talk to the Viakoo service. By default, the CA is configured to talk to the Viakoo hosted datacenter. Similarly to changing for Static IP, you must explicitly change the Viakoo IP Address to point to the API Server of your Viakoo OnPremises configuration.

Navigate to the Viakoo Connection Settings page as described above (if you can't reach the public internet, the Viakoo CA may begin at this page automatically):


In the space provided, enter the URL to reach the data reader in the Viakoo OnPremise API Server. The URL will have the following structure:

http://<address of api server>

Reader Path If Using DNS Service

If ViakooAPI is defined in your DNS service (e.g., ActiveDirectory, LDAP service or through a ViakooProxy VM), you can use that name in the address portion of the URL. You may have to use a full path such as:


where mycompany.com, is your top-level organization’s domain, and mysecuritynetwork, is the subdomain path within your organization so that the ViakooAPI name can be resolved anywhere in your organization.

If you have configured the ViakooAPI server in your namespace, the URL might be:


Reader Path Using IP Address

If you did not set up the ViakooAPI name in your DNS service, you can just use the IP address allocated to this server in your VMware configuration:


For example, if the IP address of the Viakoo OnPremise API Server is “” the URL to put in the ModVNNIP.jsp field would be:

Entering the value will allow the CA to connect to your Viakoo OnPremise service instead of attempting to connect to the hosted version of the Viakoo Service.

Now go to the "Home" screen of the Viakoo CA to activate your site.


 Configuring a Proxy Server

Skip this step if you do not have a proxy server. If you are not sure, click here to read instructions on how to check. 

Before you can setup Viakoo with a proxy server, make sure you have the following:

  • The proxy server IP address or URL 
  • TheTCP service port used to access the proxy service 
  • A proxy service username and password

NOTE: A small percentage of proxy servers do not require a username and password.

If you are unable to determine the required information please check with your organizations IT group or help desk.

Setting up Viakoo with a Proxy Server 

Step 1:

Click on the "Setup Proxy" tab in the "Connection Settings" screen.


Now enter the following information in the input fields:

  • URL of the proxy server - This is the IP address or URL of the proxy server
  • Port for the proxy server - This is the TCP service port used to access the proxy service i.e.8080
  • Username - If server requires, enter a username if required to access the proxy service
  • Password - If server requires, enter a password if required to access the proxy service

Enter "Submit". If the current Connection Status goes from Red to Green, you have done it correctly. Navigate to the Home screen ("Return Home") to start your activation.

Step 2:

If the Connection Status remains Red, you are likely using an invasive proxy and need to use the unsecured, HTTP protocol instead of the default HTTPS (encrypted) protocol. To use standard HTTP, go to "Set Viakoo Location" and prepend "HTTP://" in front of “reader.viakoo.com” URL.



Click Submit and go back to Main Menu on the CA Console to check the key again.


If successful, you will see Connection Status indicators go Green.


If you are getting an error message, refer to the proxy server of the Troubleshooting Activation Issues article.



Have more questions? Submit a request


Powered by Zendesk