Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Please note this article describes running Unimus behind a forward proxy.
For running Unimus behind a reverse proxy, see this article: Running Unimus behind a reverse proxy

Unimus requires outbound HTTPS connectivity to our licensing server. Some environments might not allow outbound connections directly, and require usage of HTTP(S) proxies.
Running Unimus behind a HTTP or HTTPS forward proxy is fully supported, but requires additional configuration.

On Windows:

For installer:
Create a file named Unimus.l4j.ini in 'C:\Program Files\Unimus\'.For portable:
Create a file named Unimus.l4j.ini in the same directory as the Unimus executable.
Change
Change Unimus in  in the above file name to exactly match the name of the Unimus executable.

For installer:
Add the below lines to Unimus.l4j.ini in 'C:\Program Files\Unimus\'.

Inside of this configuration file, please place add the following lines:

Code Block
languagetext
-Dhttp.proxyHost=1.1.1.1
-Dhttp.proxyPort=8080
-Dhttps.proxyHost=2.2.2.2
-Dhttps.proxyPort=8443

Please make sure to place each argument into its own line.
Insert proper values behind each configuration argument.

If you only use HTTP proxy, or only use HTTPS proxy, remove the other from the configuration file.

Restart Unimus, and any HTTP(S) outbound connectivity from Unimus will go through the configured proxy.

On Linux (Debian/Ubuntu):

Edit the contents of of /etc/default/unimus.If the file doesn't exist, simply create it.

Insert Add this into the file:

Code Block
languagetext
--httpDhttp.proxyHost=1.1.1.1 --httpDhttp.proxyPort=8080 --httpsDhttps.proxyHost=2.2.2.2 --httpsDhttps.proxyPort=8443

Insert proper values behind each configuration argument.

If you only use HTTP proxy, or only use HTTPS proxy, remove the other from the configuration file.

Restart Unimus, and any HTTP(S) outbound connectivity from Unimus will go through the configured proxy.

HTTPS proxy type

When using a HTTPS proxy, Unimus suports 2 proxying modes:

  • HTTP 1.1 Connect
  • SOCKS

By default, the "HTTP 1.1 Connect" proxy method will be used. If your proxy requires SOCKS proxying, you can configure this by:

Code Block
languagetext
-Dhttps.proxyType=socks

Proxies with authentication

If you need to authenticate to your proxy, you will need to setup additional configuration:

Code Block
languagetext
-Dhttp.proxyUser=username
-Dhttp.proxyPassword=password
-Dhttps.proxyUser=username
-Dhttps.proxyPassword=password

If your proxy uses Basic Auth, this is disabled by default. You will also need to configure:

Code Block
languagetext
-Djdk.http.auth.tunneling.disabledSchemes=""

(please keep proper format for Linux / Windows)

Running in Tomcat:

Please refer to Tomcat documentation on configuring proxying.

...