개발
같은 블로그에서 XSS 가 세 번 났다 — 맥락마다 이스케이프가 다르다
2026.09.16 · 3분
이 블로그를 만들면서 XSS 가 세 번 났다. 같은 저장소에서, 몇 주 사이에.
세 번 다 원인이 같았다. 코드를 잘못 쓴 게 아니라 이 값이 어느 맥락으로 나가는지를 덜 본 것이었다. 그리고 맥락마다 이스케이프가 다르다.
맥락이 네 개였다
정리하고 나서야 보였다. 이 블로그에서 사용자 입력이 나가는 자리가 넷이다.
| 맥락 | 방어 |
|---|---|
| HTML 텍스트 | React 가 자동으로 한다 |
| 본문 HTML | 원시 HTML 을 버린다 + URL 스킴 검사 |
href · src |
URL 검사 함수 |
| XML (RSS) | XML 이스케이프 |
| JSON-LD | 유니코드 코드포인트 치환 |
React 쓰니까 XSS 는 알아서 막힌다고 생각하기 쉬운데, React 가 막아 주는 건 첫 줄뿐이다. 나머지 넷은 각자 막아야 한다.
본문 HTML — 원시 HTML 을 버리는 게 의도다
마크다운을 HTML 로 바꿔서 dangerouslySetInnerHTML 로 넣는다. 이름 그대로 위험한
일인데, 근거가 하나 있다. 본문의 원시 HTML 을 살리지 않기 때문이다.
마크다운 처리기에 원시 HTML 을 살려주는 플러그인이 있다. 그걸 붙이는 순간 글 안에
<script> 를 쓸 수 있게 되고 dangerouslySetInnerHTML 이 진짜로 위험해진다.
그래서 저장소에 이렇게 적어 뒀다.
원시 HTML 플러그인을 붙이지 마세요. 본문의 원시 HTML 이 버려지는 것은 의도이고, 그게
dangerouslySetInnerHTML을 쓰는 근거입니다.
살균 플러그인도 안 쓴다. 얼핏 더 안전해 보이는데, 기본 규칙이 코드 하이라이터가
붙인 class 와 style 을 벗겨서 하이라이팅이 통째로 깨진다. 원시 HTML 을 애초에
안 받는 쪽이 더 단순하고 더 안전하다.
XML — 이스케이프로 못 막는 게 있다
RSS 를 만들면서 배운 것이다. 제목에 들어간 < 나 & 를 바꿔 주면 끝날 줄 알았다.
아니었다. XML 1.0 은 C0 제어문자를 문자 참조로도 허용하지 않는다. 
이라고 써도 안 된다. 스펙 자체가 그 문자를 문서에 담는 걸 금지한다.
즉 이스케이프로는 막을 수 없고 제거해야 한다. 제목에 제어문자가 하나 섞여 있으면 RSS 전체가 파싱 실패로 죽는다.
다만 전부 지우면 안 된다. 탭·개행·캐리지리턴은 XML 이 허용하고 제목에 든 줄바꿈이 사라지면 그것대로 곤란하다. 그래서 그 셋은 일부러 남긴다.
JSON-LD — 치환 순서에 의존하지 않기
구조화 데이터를 <script type="application/ld+json"> 안에 넣는다. 여기서 <
가 그대로 나가면 스크립트 태그를 닫아 버릴 수 있다.
처음엔 HTML 엔티티로 바꾸려 했다. < 를 < 로.
그러면 순서에 의존하게 된다. & 를 먼저 바꾸느냐 나중에 바꾸느냐에 따라
< 가 다시 &lt; 가 되는 이중 이스케이프가 난다. 한 번 어긋나면 찾기
어렵다.
지금은 유니코드 코드포인트 표기로 바꾼다. 여는 꺾쇠를 \u 로 시작하는 여섯 글자
표기로 쓰는 것이다. 순서 의존성이 없다.
& 를 건드리지 않으니 서로 간섭할 일이 없다.
세 번 다 같은 모양이었다
되짚어 보니 패턴이 하나다. 막은 곳과 새는 곳이 달랐다.
- HTML 을 막았더니 URL 로 샜다
- URL 을 막았더니 XML 로 샜다
- XML 을 막았더니 JSON-LD 로 샜다
매번 "이제 막았다" 고 생각했는데, 막은 건 그 맥락 하나였다. 값은 여러 곳으로 나가는데 나는 한 곳만 보고 있었다.
그래서 바꾼 것
방어를 코드에 적는 것만으로는 부족했다. 세 번 다 코드에는 방어가 있었고 새 경로가 생겼을 때 그 방어를 안 지나간 것이었다.
두 가지를 했다.
첫째, 표를 만들었다. 위에 붙인 그 표다. 값이 나가는 자리가 넷이라는 걸 한눈에 보이게 해 두면, 새 출력 경로를 만들 때 "이건 어느 칸이지" 를 묻게 된다.
둘째, 테스트로 경계를 고정했다. 특히 XML 쪽은 "탭·개행은 남기고 나머지 제어 문자는 지운다" 는 경계가 미묘해서 나중에 누가 "이거 왜 이렇게 복잡하지" 하고 단순화하면 바로 깨진다. 테스트가 있으면 단순화하려는 순간 빨간불이 켜진다.
남는 것
XSS 를 "입력을 검증하는 문제" 로 생각하면 틀린다. 출력하는 문제다.
같은 문자열이 HTML 로 나가면 안전하고 URL 로 나가면 위험하고 XML 로 나가면 파일 전체를 깨뜨린다. 입력 쪽에서 한 번 걸러서 끝낼 수 있는 성질이 아니다.
그래서 지금은 새 출력 경로를 만들 때 먼저 묻는다. 이 값이 어디로 나가는가.
URL 검사 함수는 이야기가 더 길어서 따로 썼다. 같은 부류가 거기서만 세 번 재발했고 원인이 매번 같았다.
이 글은 AI 가 조사·초안을 작성하고 사람이 검수한 뒤 발행했습니다.