Apache VelocityÂ is a well-known templating engine used in Java Enterprise applications. It is used as a web page rendering engine, e-mail message composition etc. Many commercial products rely on Velocity as one of the fastest content generators that is producing content, based on predefined templates and dynamically supplied parameters.
A couple of days ago, a major application vendor reported security vulnerability that is connected with their customer support forms and e-mail based notifications. I donâ€™t know if Velocity was the source of this security vulnerability, but it could be.
First of all, let me state thatÂ Apache VelocityÂ is an excellent product and if used properly there is no possibility for security breaches because the input parameters are escaped and sanitized. However, developers sometimes make mistakes, they choose to circumvent the well-established rules and proceed on their own way.
This is not going to be a Velocity tutorial. Here is the simplest template:
The content generation is as simple as:
It will render the content “Hello World”. Ok, we know what Velocity is and how it works :).
What else can we do with Velocity? For example, can we access the operating system from the Velocity template while it has been rendered? The answer is yes. Velocity supports directives. One of them is theÂ #setÂ directive. You can’t create and execute plain Java code directly, however if you know Java Reflection and obtain Classes and Constructors you can implement some interesting logic and constructs.
For example, consider the following template that will render the listing of the root directory on the server machine:
I’ve obtained through Java Reflection classes, constructors etc. The final instance isÂ BufferedReaderÂ that reads the output from theÂ RuntimeÂ command execution.
Let’s go a step further.Â NetcatÂ is an excellent command line for pen-testing and general TCP/IP socket network communication. We can start Netcat on a Windows machine in listening mode (port 3000) this way:
Consider this Velocity template:
Execute the Java rendering program above. The listening Netcat instance will receive the server’s root directory listing!
It’s getting warm đź™‚
We are convinced now that by executing Velocity rendering, we can execute OS commands, send those commands to a remote listener etc. Off course, the user running the Java program must have appropriate OS permissions, the network firewall must be opened… But it is possible and can be exploited if we don’t care how we design our application and how we protect our environment.
The real question is why would we put the above Velocity directives in our templates? The answer is that we will never do that by ourselves.
Sometimes developers construct their templates dynamically. Consider this Velocity template (warning: Dangerous approach, never use it!):
The %s is a raw string substitution variable. Velocity will not render it, but developers could replace it with user provided input (customer support form for example) before Velocity rendering. Here is an example:
Execute the program above and you will receive the OS directory listing by listening to the Netcat.
In a real server application, the Velocity commands will be supplied through HTML form and injected in the “evil” Velocity template. I’ve shown above the possible outcomes.
This kind of a security attack can be easily avoided if developers never inject raw content in their templates through string based substitution. Never do that unless there is a really sound reason. In that situation double your tests and provide proper sanitation.
Till the next time!