6.9. Proxy agent for Windows

For Windows users, it is possible to provide the Internet access through the explicitly specified proxy server for applications that cannot directly work with proxy servers. Sometimes you may also need to provide the Internet access to such applications when UserGate is not set up as the default Internet gateway for user workstations. In such cases, you can use the proxy agent. The proxy agent resends all TCP requests not intended for local addresses to UserGate that serves as a proxy server for them.

Important! The proxy agent does not authorize users on UserGate, so when authentication is required, make sure to set up an authentication method for users, e.g. install an authentication agent for Windows.

You can also install the proxy agent either manually or by using Active Directory policies.

When installing and setting up the agent manually, make sure to create a text file called utmagent.cfg in C:\Documents and Settings\All Users\Application Data\Entensys\UTMAgent\. Add the following information to this configuration file:

ServerName=10.255.1.1

ServerHttpPort=8090

LocalNetwork=192.168.1.0/24; 192.168.0.0/24; 192.168.30.0/24;

ServerName and ServerHttpPort are the IP address and proxy server port on UserGate; by default, port 8090 is used.
LocalNetwork is a list of networks that do not need any routing to the proxy. The network of workstation interfaces is not routed to the proxy by default.

Once the configuration file is created or modified, make sure to restart the proxy agent service.

When installing the proxy agent through GPO, the proxy agent will contain the administrative template for convenient deployment through Active Directory policies. Using this template, administrators can deploy a valid pre-configured agent to a large number of user workstations at once. For more details on how to deploy a software using Active Directory policies, please refer to Microsoft documentation.

All mandatory parameters for proper operation of the proxy agent are specified during the group policy configuration. During the configuration process, the parameters are added to the Registry on the workstation and thus have priority over the CFG file. Deleting the agent with a policy will not remove the values from the Registry, and they will remain in the following branch:

Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Entensys\UTMAgent