Restricting Access to WSO2 Servers

Yasassri Ratnayake
4 min readJun 29, 2019


In this post I’ll explain how we can restrict access to WSO2 Carbon console for specific client machines. In WSO2 servers they have an embedded tomcat instance to host the web-apps including the server. So here we will be using tomcat valves to restrict access to the server. I’ll be covering few different scenarios where you will have to use different configurations and valves.

White List a IP When Accessing the Server Directly

Take a scenario where the WSO2 server is accessed directly without a load balancer. So in this case how can we whitelist only requests generating from a particular IP or block requests originating from a particular IP.

In-order to do this we need to use tomcats’ RemoteAddrValve. Follow the steps below to add the valve.

  1. Open <WSO2_HOME>/repository/conf/tomcat/carbon/META-INF/context.xml and add the valve configurations as below,
<Valve className=”org.apache.catalina.valves.RemoteAddrValve” allow=”10\.100\.5\.112"/>

2. Then restart the server for changes to be effective.

Above filter will only allow requests that are originating from the 10\.100\.5\.112 IP. Also note the value for the allow property accepts a regex, so you can add a proper regex pattern here. There are few attributes you can set in the valve. You can also add multiple IPs, deny access to specific IPs etc. You can refer the tomcat documents for more details on this.

White List a Host Name When Accessing the Server

In this case we are validating whether the requests are generated for a specific Host. By default Tomcat doesn’t do a DNS lookup on the clients IP to determine the Host name if the client. So we need to enable this in the relevent tomcat connector. After enabling dns lookup you have to use RemoteHostValve in tomcat to validate the host. Follow instructions below to do this.

  1. Open To do that open “<IS_HOME>/repository/conf/tomcat/catalina-server.xml” and enable enableLookups property. Full connector configurations will look like following.
<Connector protocol=”org.apache.coyote.http11.Http11NioProtocol”
server=”WSO2 Carbon Server”
noCompressionUserAgents=”gozilla, traviata”

2. Next open <WSO2_HOME>/repository/conf/tomcat/carbon/META-INF/context.xml and add the following valve configuration,

<Valve className=”org.apache.catalina.valves.RemoteHostValve” allow=”wso2\.mydomain\.com"/>

3. Then restart the server for changes to get effective.

Now if you try to access the WSO2 server with you will be able to access but if you try to access the server with a different host you will be access denied. You can get more details on this valve from here

White List a Client IP When Accessing the Server through a LB

When you are accessing WSO2 servers through a LB the connections will be made as follows.

The client will create a connection with the LB(Load balancer) and the LB will be creating a connection with the backend server. So for the LB the client will be and for the WSO2 server the client will be the LB. So WSO2 server will always see the clients IP as irrespective from which client machine the request is generating from. So in-order to get the clients IP we need to read the X-Forwarded-For header, when ever a request is parsing through a proxy the clients IP will be appended to the X-Forwarded-For header. So the first IP in the X-Forwarded-For header is the IP of the request originating client.

Inorder to get the original clients IP we need to use tomcats RemoteIpValve this will read the X-Forwarded-For header and set the original clients IP as the request generating clients IP. After we get the remote clients IP we can use a Access Control valve to white list the requests. So in this case we need to use two different valves together.

Please follow instruction below,

  1. Open <WSO2_HOME>/repository/conf/tomcat/carbon/META-INF/context.xml and add the following valve configurations,
<Valve className=”org.apache.catalina.valves.RemoteIpValve”/>
<Valve className=”org.apache.catalina.valves.RemoteAddrValve” allow=”10\.100\.5\.112"/>

2. Then restart the server for changes to get effective.

Now if you try to access the WSO2 server with the client you will be allows to access WSO2 servers. But for other clients the requests will be blocked. You can use what ever valve you desire in cinjuction with the RemoteIpValve.



Yasassri Ratnayake