This page last changed on Apr 09, 2008 by rhartono.

Overview

Some of Confluence's macros, such as {rss} and {jiraissues} need to make web requests to remote servers in order to retrieve data. If Confluence is deployed within a datacentre or DMZ, it may not be able to access the Internet directly to make these requests. If you find that the {rss} macro does not work, ask your network administrator if Confluence needs to access the Internet through a web proxy.

Configuring Proxy Support

Proxy support is configured by passing certain system properties to the Java Virtual Machine on startup. These properties are defined by Sun here: http://java.sun.com/j2se/1.4.2/docs/guide/net/properties.html

  • http.proxyHost (default: <none>)
  • http.proxyPort (default: 80 if http.proxyHost specified)
  • http.nonProxyHosts (default: <none>)

http.proxyHost and http.proxyPort indicate the proxy server and port that the http protocol handler will use.

http.nonProxyHosts indicates the hosts which should be connected to directly and not through the proxy server. The value can be a list of hosts, each seperated by a |, and in addition a wildcard character (*) can be used for matching. For example: -Dhttp.nonProxyHosts="*.foo.com|localhost".

Configure HTTP proxy with authentication

  • http.proxyUser = username
  • http.proxyPassword = secret

Reference: source

Please consult your application server documentation for how to provide system properties to the Java runtime, or to a particular application server. Some examples of how to start up different application servers with these system properties set are:

AppServer Startup script Variable to edit Example
Orion n/a n/a java -Dhttp.proxyHost=proxy.example.com -Dhttp.proxyPort=3128 orion.jar -userThreads
Tomcat bin/catalina.sh, bin\catalina.bat JAVA_OPTS set JAVA_OPTS="-Dhttp.proxyHost=proxy.example.com -Dhttp.proxyPort=3128" (Windows), or export JAVA_OPTS="-Dhttp.proxyHost=proxy.example.com -Dhttp.proxyPort=3128" (Unix)
Tomcat Service n/a n/a When using a sevice to start tomcat, JVM parameters must be set using special syntax. See Start Confluence automatically on Windows as a Service.
Weblogic $BEA_HOME/domain/<domain>/startWebLogic.sh JAVA_OPTIONS export JAVA_OPTIONS="$JAVA_OPTIONS -Dhttp.proxyHost=proxy.example.com -Dhttp.proxyPort=3128"
JBoss 3.2.x bin/run.sh JAVA_OPTS export JAVA_OPTS="-Dhttp.proxyHost=proxy.example.com -Dhttp.proxyPort=3128"

Confluence running as a Windows Service

*.bat configuration in Confluence's Windows Service will be useless

Defining JAVA_OPTS in your setenv.bat file will not have any effect on your proxy configuration if you are running Confluence as a Windows Service. Simply because your application server will follow its own configuration and will not load any batch files in your Confluence installation folder.

You may need to define the configuration in your Windows Registry. For example, if you are running Confluence as a service with Tomcat 5 as the Application Server then you will need to modify HKEY_LOCAL_MACHINE -> SOFTWARE -> Apache Software Foundation -> Procrun 2.0 -> Tomcat5 -> Parameters -> Java -> Options and add the JAVA_OPTS parameter there.

NTLM Authentication

Confluence does not currently support NTLM authentication, and can not identify itself to a proxy server in this way.

Document generated by Confluence on Aug 07, 2008 19:08