How to Use
Ensure secure communications between multiple projects, nodes, or other systems you want to communicate with via our Secure Multi-Port Gateway.
Set up 1-to-1 communications to a single site or set up 1-to-many communications for multiple sites running into the same "master" project.
In the example below, we created a business-level project that can send requests to any site in a group, and all the traffic is handled via our Secure Multi-Port Gateway.
Our Secure Multi-Port Gateway ensures safe data communications by only allowing the traffic that is supposed to go from point A to point B, point A to point E, and so on, all while keeping the sites separate from each other.
Installation
o install the “WebGateway,” run the “InstallTWebGatewayService.exe” application. All the information for the WebGateway is in the TWebGatewayService.exe.config. This will create a Windows service, and all output will be sent to the Windows Event Viewer. After any modifications to the .config file, the Windows service must be stopped and restarted.
Using Additional Ports
When using additional ports (ExtraCount parameter), you need to configure the TWebGatewayService.exe.config file and then execute the WebGateway installation. The executable “InstallTWebGatewayService.exe” will verify the TWebGatewayService.exe.config and install the additional ports on the Windows routing table. After you make modifications to the related additional ports, you must follow the steps below:
- In the command prompt, run the application:
InstallWebGateway /uninstall
- Modify the file:
TWebGatewayService.exe.config
- In the command prompt, run the application:
InstallWebGateway
Available Parameters
The available WebGateway parameters can be found below:
LocalPort : WebGateway listening port. If you are ONLY using Windows Authentication, set the parameters to zero (0) and the port will not be opened
LocalPortWA: WebGateway listening port using Windows Authentication. If you are not using Windows Authentication, set the parameters to zero (0) and the port will not be opened
RemoteIP : Computer IP that runs the runtime server (TServer.exe)
RemotePort : “TServer.exe” listening port without Windows Authentication
RemotePortWA: “TServer.exe” listening port using Windows Authentication
WA: Must use either RemotePort or RemotePortWA. It does not matter which port the data arrives in (LocalPort or LocalPortWA)
True = Use only Remote Port WA
False = Use only Remote Port
RuntimeUsersProject: [optional] Set which project (tproj) has the RuntimeUsers data table that will validate the users from SmartClient/RichClient
CheckRunTimeUsersWA: [optional] Set to validate the users from SmartClient/RichClient using Windows Authentication
True = Enabled (Runtime Using Project parameter cannot be used when True)
False = Disabled
TargetCF : [optional] This enables a project to be deployed in a Compact Framework environment (WindowsCE).
True = Enabled
False = Disabled.
ExtraCount: [optional] Number of additional ports. These ports will only route the incoming data in the LocalPort<#> to the RemoteIP<#> and RemotePort<#>.
LocalPort2: WebGateway listening port. It must start with #2.
RemoteIP2: Computer IP that is running the runtime service
RemotePort2: “TServer.exe” listening port
LocalPort3: WebGateway listening port
RemoteIP3: Computer IP that is running the runtime service
RemotePort3: “TServer.exe” listening port
.....
RemoteIP<n>: Computer IP that is running the runtime service
RemotePort<n>: “TServer.exe” listening port
Notes:
You can find any default values in the “TWebGatewayService.exe.config” located in the product binaries folder.
When editing directly the config files, the line ”<! − −” and ”−− >” would create a comment block, so it needs to be removed.
When using Windows Authentication, the multiport functionality cannot be enabled
Starting the Service
When the WebGateway service is started, log messages appear in the Windows Event Viewer.
Below is a message similar to the log messages:
First redirect :: LocalPort: 3101, RemoteIP: localhost, RemotePort: 3101,RemotePortWA: 3102 Extra Redirection Table: Listen on ipv4: Connect to ipv4: Address Port Address Port --------------- ---------- --------------- ---------- 0.0.0.0 3100 192.168.80.129 3100 0.0.0.0 3102 192.168.80.129 3101
In this section: