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 | ||
---|---|---|
| ||
-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 | ||
---|---|---|
| ||
--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 | ||
---|---|---|
| ||
-Dhttps.proxyType=socks |
Proxies with authentication
If you need to authenticate to your proxy, you will need to setup additional configuration:
Code Block | ||
---|---|---|
| ||
-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 | ||
---|---|---|
| ||
-Djdk.http.auth.tunneling.disabledSchemes="" |
(please keep proper format for Linux / Windows)
Running in Tomcat:
Please refer to Tomcat documentation on configuring proxying.
...