기본으로 이스케이프하는 템플릿
왜 중요한가 HTML을 손으로 이어 붙이는 일은 드물 거예요. 진짜 사이트는 템플릿을 쓰고, 좋은 템플릿 시스템은 모든 값을 이스케이프해 줘요. 여러분의 일은 대부분 실수로 그걸 끄지 않는 것, 그리고 그걸 끄는 몇 안 되는 스위치를 알아보는 거예요.
비유: 알아서 브레이크를 거는 차
현대 차는 무언가에 부딪히려 하면 자동으로 브레이크를 걸어요. 그 기능을 끌 수 있고, 가끔은 좋은 이유가 있어요. 하지만 꺼져 있을 때마다 왜인지 물을 가치가 있어요. 자동 이스케이프도 같아요: 좋은 도구에서는 기본으로 켜져 있고, 끄는 방법이 몇 개 분명한 이름으로 있어요.
템플릿: 서버가 페이지마다 채우는 {{ name }} 같은 빈칸이 있는 HTML 파일. 템플릿 엔진이 빈칸을 채우는 코드예요.
자동 이스케이프: 값이 이미 안전하다고 말하지 않으면 템플릿 엔진이 빈칸에 넣는 모든 값을 이스케이프하는 것.
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에 데이터를 넘길 때는 <script> 블록에 값을 붙여 넣는 대신 json_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. - Python에서 HTML을 만들 때는
format_html을, JavaScript에 데이터를 건넬 때는json_script를 쓰세요. - 이스케이프는 링크 주소를 확인하거나 따옴표 없는 속성을 고치지 않아요: 따옴표로 감싸고 http와 https 링크만 허락하세요.
이 연습은 곧 열려요
앞의 레슨을 마치면 이 레슨이 열려요. 강좌 전체가 무료이고 계정도 필요 없으며, 이 레슨은 지금 바로 읽을 수 있어요.
이 브라우저가 learn.floati.life의 쿠키를 막고 있어서, 여기서 마친 레슨들이 순서대로 열리지 않아요. 이 사이트의 쿠키를 허용하고 새로고침하세요.