课程大纲 第 63 课,共 156 课 · 脚本注入(XSS)
脚本注入(XSS)

默认转义的模板

为什么重要 你很少会手工拼接 HTML。真实的网站使用模板,而好的模板系统会替你转义每一个值。你的工作主要是不要无意中把它关掉,并认出那几个会关掉它的开关。

一个比喻:会替你刹车的汽车

现代汽车在你快要撞上什么东西时会自动刹车。你可以把这项功能关掉,有时也确实有充分的理由。但每次它被关掉时,都值得问一问为什么。自动转义也是一样:在好的工具里默认开启,只有几种名字很清楚的方式能把它关掉。

模板:一个带有空位的 HTML 文件,比如 {{ name }},服务器会为每个页面填上这些空位。模板引擎就是填空位的那部分代码。

自动转义:模板引擎会转义它放进空位的每一个值,除非你告诉它这个值已经是安全的。

Django

Django 模板默认会转义每一个 {{ value }}:<、>、&、" 和 ',就是你手工转义过的那五个。这个网站的课程页面就是这样构建的。

{# safe: escaped automatically #}
<p>{{ review.text }}</p>
<input name="q" value="{{ query }}">

{# the dangerous switches: each one turns escaping off #}
{{ review.text|safe }}
{% autoescape off %}{{ review.text }}{% endautoescape %}

在 Python 代码里,mark_safe(text) 告诉 Django“这已经是 HTML 了,不要转义它”。只把它用在你自己的代码写出的文本上。当你需要在 Python 里构建一小段 HTML 时,使用 format_html,它会转义你传进去的每一个值:

from django.utils.html import format_html
from django.utils.safestring import mark_safe

bad = mark_safe(f"<b>{user_name}</b>")            # user_name is NOT escaped
good = format_html("<b>{}</b>", user_name)          # user_name IS escaped

要把数据传给页面的 JavaScript,就使用 json_script 过滤器,而不要把值粘贴进一个 <script> 块里。它会以一种不可能提前关闭 script 标签的方式把数据写成 JSON。

Jinja(以及 Flask)

Jinja 是另一个流行的 Python 模板引擎。它的默认设置不一样:一个普通的 Environment() 不会转义。要把它打开,就像 Flask 为 .html 模板所做的那样:

from jinja2 import Environment, select_autoescape

env = Environment(autoescape=select_autoescape(["html", "htm", "xml"]))

# Jinja's dangerous switches: the |safe filter, Markup(text) in Python,
# and {% autoescape false %} blocks.

自动转义仍然做不到什么

  • 没加引号的属性:<div title={{ x }}> 一个空格就能把它弄坏。永远写成 title="{{ x }}"。
  • 链接地址:href="{{ url }}" 会被转义,但一个 javascript: 地址里没有任何需要转义的东西。在保存或显示链接之前,检查它们是否以 https:// 或 http:// 开头。
  • 在 <script> 块里面:使用 json_script 或 data- 属性,而不是模板空位。

代码审查的一个习惯

在你的项目里搜索 |safe、mark_safe、autoescape off、Markup(,在前端代码里还要搜索 innerHTML 和 dangerouslySetInnerHTML。每一处命中旁边都应该有一行理由。如果这个值有可能包含访客的文本,它就是一个随时会出现的漏洞。

一个常见的误解

“我们的框架会转义,所以我们不可能有 XSS。”框架转义的是空位。它们保护不了一个你标记为安全的值、一个你没有检查的地址,或者使用 innerHTML 的前端代码。下一个模块会加上第二层防护,也就是内容安全策略,用来应对那些仍然会漏过去的错误。

想更深入一些?PortSwigger 免费的 Web Security Academy 有一条完整的 XSS 学习路线,带有它自己的练习实验,专门为安全地学习而构建。

用其他语言实现

其他技术栈里同样的默认设置,以及同样危险的开关:

// React: text in JSX is escaped for you
<p>{review.text}</p>
// the switch that turns it off (the name is a warning on purpose)
<div dangerouslySetInnerHTML={{ __html: review.text }} />

// Go: html/template escapes for the context (text, attribute, URL, script)
import "html/template"           // escapes
// import "text/template"        // does NOT escape: never use it for HTML
tmpl := template.Must(template.New("p").Parse(`<p>{{.}}</p>`))
// the switch: template.HTML(text) marks text as already safe

// PHP (Twig) auto-escapes; {{ text|raw }} turns it off
// C# (Razor) auto-escapes @text; @Html.Raw(text) turns it off

回顾

  • Django 默认会转义每一个模板值;Jinja 只有在你打开时才会转义。
  • 危险的开关:|safe、mark_safe、autoescape off、Markup、dangerouslySetInnerHTML、Go 的 template.HTML。
  • 用 format_html 在 Python 里构建 HTML,用 json_script 把数据交给 JavaScript。
  • 转义不会检查链接地址,也修复不了没加引号的属性:给它们加上引号,并且只允许 http 和 https 链接。

发现这节课有问题?报告它 · 就这节课提问

这个练习即将开放

完成它前面的那一课,这一课就会解锁。整门课程免费,无需账号,而且你现在就可以阅读这节课。