默认转义的模板
为什么重要 你很少会手工拼接 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 链接。
这个练习即将开放
完成它前面的那一课,这一课就会解锁。整门课程免费,无需账号,而且你现在就可以阅读这节课。
这个浏览器屏蔽了 learn.floati.life 的 Cookie,所以你在这里完成的课程无法按顺序打开。请允许这个网站使用 Cookie,然后重新加载。