[Download] | [Documentation Home] | [Release Note]

WSAS Running behind a proxy

In a production environment or the network is under certain constrains, it is sometime necessary to run WSO2 WSAS behind a proxy or a firewall. Though WSAS should be behind a proxy or firewall, the ultimate end user should not see this information.

WSAS has been designed to run on top of Embedded Tomcat or in Servlet containers such as Tomcat, JBoss, Web Logic etc. Thus, WSAS has two mode of operations.

  1. As an embedded server on top of Embedded Tomcat.
  2. In a Servlet container.
When WSAS has been configured to run on prior modes, it will be give two different axis2.xml by default. This section describes the configuration of theses axis2.xmls, when WSAS is running behind a proxy or a firewall. Lets assume you have enabled mod_proxy

Mode 1:

axis2.xml is available in "conf" directory, where WSAS is installed. Find the elements that has the tag name transportReceiver. You will be able to find a commented parameter named "proxyPort". Uncomment this one and your WSAS instance is ready for accept request coming through the proxy. You should uncomment the @proxyPort parameter in both http and https listeners.

Mode 2:

axis2.xml is available in the location where you have give as the WSAS home. By default this will be $USER_HOME/.wso2wsas. Find the elements that has the tag name transportReceiver. You will be able to find a commented parameter named "proxyPort". Uncomment this one and your WSAS instance is ready for accept request coming through the proxy. You should uncomment the @proxyPort parameter in both http and https listeners.