Skip to content

Connect to VTScada – Adding a Web Application

Overview

The following guide outlines the steps for creating a VTSCada web application in the Agilicus platform. These instructions are intended for SSL configured VTScada deployments on windows, linux, and android devices.

If you require assistance for Safari and iOS device or if your VTScada is not configured for SSL, contact us.

Step 1: Create the Application

From the left sidebar, expand Applications and select New:

Select β€œa new application”.

Click on Next to be taken to the β€œDefine application” tab:

Within the β€œDefine application” section, populate the:

  1. application name
  2. a description of the application
  3. create a category name that fits the application in question

Click on Next to get to the β€œHostname Aliases” section:

Select the first option of β€œI access via NAME-OF-APP.subdomain.domain.name” and click on next.

First under β€œMy application is accessed” select β€œfrom my site via an onsite connector”

  • Within β€œSet up web application firewall” select β€œMy application expects to receive requests using its internal hostname”

Click on β€œSelect connector”:

From the β€œSelect a connector” drop down, pick the connector that you had previously created.Β 

Click on β€œData Path Processing”:

Select β€œEnd to End Transparent TLS” and click on β€œEnter upstream service”:

Within the β€œEnter the hostname” field, type in the hostname of the server that is hosting your VTScada web portal.Β Β 

Within the β€œEnter the port” field, type in the port number that the VTScada web portal is listening on.Β 

  • For example if TLS is used, the port number would likely be 443.Β Β 

For TLS enabled services, you would also want to select β€œMy service is accessed via TLS”.

Click on Next to be taken to the β€œAuthentication section”:

Select β€œis authentication by a proxy” and type in β€œ/logout” (without the double quotes) into the β€œEnter the logout url” field.

Click on β€œAuthenticate users”:

Select β€œhas named users with a single role (I will assign users later)” and click on Next:

Select the APPLY button to finish off this section of the setup.

Step 2: Configure the Application

Click on β€œOverview” within the Applications section and select the Actions icon in the very far right hand side of the screen for the VTScada application that we just created:

After clicking on β€œConfigure Application”, select the Proxy section

Within the Proxy section select the β€œInclude Users Context Headers” checkbox.

Within the same section, scroll down to the β€œRewrite Rules” heading and click on β€œADD OTHER MAPPING”:

Populate the Internal name with your internal hostname that is hosting VTScada and the External name with the hostname Agilicus generated for external access.

Step 3: Add Permissions

We have now completed setting up your VTScada resource within the Agilicus platform.  At this point you would want to create the appropriate Role Based Access Control permissions per the steps below:

  1. Select Access
    • select Users
    •  select ADD USER
  2. Select Groups
    • select ADD GROUP
  3. Select Resource Permissions, select ADD RESOURCE PERMISSION
    • enter the group that you created beforehand and select owner