This page last changed on Mar 21, 2007 by don.willis@atlassian.com.

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 too 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"

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 Oct 10, 2007 18:36