강의 계획 레슨 156개 중 63번째 · 스크립트 주입 (XSS)
스크립트 주입 (XSS)

기본으로 이스케이프하는 템플릿

왜 중요한가 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 링크만 허락하세요.

이 레슨에서 문제를 발견했나요? 알려 주세요 · 이 레슨에 대해 묻기

이 연습은 곧 열려요

앞의 레슨을 마치면 이 레슨이 열려요. 강좌 전체가 무료이고 계정도 필요 없으며, 이 레슨은 지금 바로 읽을 수 있어요.