For networks within an organization, the access to the public domain Internet is often routed through a web proxy and therefore only accessible by using this proxy. Fedora >= v3.3 allows the usage of a http proxy. This means that you can for example have objects with external referenced content that is only reachable through a proxy server.
There are five properties that can be used for configuring the http proxy:
Parameter |
Description |
---|---|
|
The hostname or IP address of the machine the proxy server is running on. |
|
The port of the proxy. Defaults to 80. |
|
A list of hosts that should be reached directly, bypassing the proxy. This is a list of regular expressions separated by '|'. Any host matching one of these regular expressions will be reached through a direct connection instead of through a proxy. If the nonProxyHosts list is invalid, the Fedora web client dismisses it, writes the error to the logfile and continues its operation. |
|
Should the http proxy require credentials in the form of username and password, you must provide them with these properties. Note: if the proxyUser is set the proxyPassword must not be empty, otherwise the username is not being used by Fedora's web client. |
|
The password for the http proxy. |
Note: https proxies are currently not supported. |
For more detailed information see the official java documentation.
The proxy setup can be done in basically two ways. Either by using the JAVA_OPTS environment variable:
JAVA_OPTS="-DproxyHost=host -DproxyPort=3128 -DnonProxyHosts=host1|host2 -DproxyUser=fedora -DproxyPassword=secret |
Or by supplying these values directly to Tomcat ($CATALINA_HOME/bin/catalina.sh for *nix or %CATALINA_HOME%/bin/catalina.bat for Windows). Please consult the official Tomcat documentation for further details.