ESET Online Help

Search English
Select the topic

ESET Bridge Policy

You can configure ESET Bridge only remotely from ESET PROTECT using an ESET Bridge Policy:


note

If there is an existing ESET Bridge Policy in place, you can:

Request the applied ESET Bridge configuration to see the current ESET Bridge configuration.

Edit the existing ESET Bridge Policy instead of creating a new one.

1.Open the ESET PROTECT Web Console in your web browser and log in.

2.Click Policies > New Policy.

new_policy

3.In Basic, type the Name. You can also type the Description and Select tags.

policy_basic

4.Click Settings and select ESET Bridge from the Select product drop-down menu.

policy_settings

5.Configure ESET Bridge Policy settings:

General

Port—By default, ESET Bridge uses port 3128. You can set a custom port.

 


note

The ESET Bridge port must be open and free—no other application is using the port (listening on the port) and the operating system does not block the port.

If you set a custom port and the port is unavailable, ESET Bridge will use the default port and ESET PROTECT Web Console will show an alert.

If the default port is unavailable, ESET PROTECT Web Console will display the ESET Bridge Proxy is non-functional alert.

 

Authentication—By default, there is no proxy server authentication. Enable the toggle and type the Username and Password to enable the authentication.


note

You can set any Username and Password based on your preference. ESET Bridge version 1 does not support the Active Directory login.

 

Trace log verbosity—Select the trace log verbosity level from the drop-down menu: 0 (turn the logging off), Debug, Information (default), Warning, Error, Fatal.

 

policy_settings_general

 

Cache

Maximum cache size (MB)—The default and recommended value is 5000. If the cache size exceeds the set maximum cache size, the oldest cached data will be removed.

 


note

If the maximum cache size set in the policy is higher than the available free space on the partition with the cache file, ESET Bridge Web Console will show an alert and ESET Bridge will use the default cache size.

 

Minimum free space (MB)—The default value is 1000. If the free space goes under the set minimum space, the least recently used cached data will be removed.


important

We recommend that you do not set the Minimum free space to less than 1000 (1 GB), as it may lead to deleting the already cached data and cache performance degradation.

If the minimum free space set in the policy is higher than the available free space on the partition with the cache file, ESET Bridge Web Console will show an alert and ESET Bridge will use the default minimum free space.

 

Cache HTTPS traffic—Enable the toggle to enable HTTPS traffic caching.


warning

Only the latest ESET security products support HTTPS traffic caching. See the supported products.

 

HTTPS Certificate—Add or change a peer certificate required for HTTPS traffic caching.


important

ESET PROTECT Cloud does not support HTTPS traffic caching. HTTPS traffic policy settings do not apply to ESET PROTECT Cloud.

 

Enable custom cache directory—By default, ESET Bridge stores the cache files in the %PROGRAMDATA% directory. Enable the toggle and type the Custom cache directory to store cache files in a custom directory.

policy_settings_cache

 


important

You must restart the ESET Bridge service after applying the custom cache policy.

Ensure to meet these prerequisites before applying the policy with the custom cache:

The custom cache directory exists on the disk.

The user (NETWORK_SERVICE on Windows or eset-bridge on Linux) has access rights to the directory. On Linux, use this Terminal command to give access rights: sudo chown -R eset-bridge:eset-bridge <cache_path_dir> (replace <cache_path_dir> with the custom cache directory).

If you set a custom cache path in the ESET Bridge Policy and the directory does not exist, or there are no access rights to it:

ESET PROTECT Web Console will alert the user that the setting is invalid.

ESET Bridge will trigger a fallback mechanism to run with the default cache path.

 

6.Click Assign and assign the computer running ESET Bridge as the policy target.

7.Click Finish, or click Summary to see the policy overview and then click Finish.

Request the applied ESET Bridge configuration to see the current ESET Bridge configuration.