본문으로 건너뛰기

개발

같은 블로그에서 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 제어문자를 문자 참조로도 허용하지 않는다. &#1; 이라고 써도 안 된다. 스펙 자체가 그 문자를 문서에 담는 걸 금지한다.

즉 이스케이프로는 막을 수 없고 제거해야 한다. 제목에 제어문자가 하나 섞여 있으면 RSS 전체가 파싱 실패로 죽는다.

다만 전부 지우면 안 된다. 탭·개행·캐리지리턴은 XML 이 허용하고 제목에 든 줄바꿈이 사라지면 그것대로 곤란하다. 그래서 그 셋은 일부러 남긴다.

JSON-LD — 치환 순서에 의존하지 않기

구조화 데이터를 <script type="application/ld+json"> 안에 넣는다. 여기서 < 가 그대로 나가면 스크립트 태그를 닫아 버릴 수 있다.

처음엔 HTML 엔티티로 바꾸려 했다. < 를 &lt; 로.

그러면 순서에 의존하게 된다. & 를 먼저 바꾸느냐 나중에 바꾸느냐에 따라 &lt; 가 다시 &amp;lt; 가 되는 이중 이스케이프가 난다. 한 번 어긋나면 찾기 어렵다.

지금은 유니코드 코드포인트 표기로 바꾼다. 여는 꺾쇠를 \u 로 시작하는 여섯 글자 표기로 쓰는 것이다. 순서 의존성이 없다. & 를 건드리지 않으니 서로 간섭할 일이 없다.

세 번 다 같은 모양이었다

되짚어 보니 패턴이 하나다. 막은 곳과 새는 곳이 달랐다.

  • HTML 을 막았더니 URL 로 샜다
  • URL 을 막았더니 XML 로 샜다
  • XML 을 막았더니 JSON-LD 로 샜다

매번 "이제 막았다" 고 생각했는데, 막은 건 그 맥락 하나였다. 값은 여러 곳으로 나가는데 나는 한 곳만 보고 있었다.

그래서 바꾼 것

방어를 코드에 적는 것만으로는 부족했다. 세 번 다 코드에는 방어가 있었고 새 경로가 생겼을 때 그 방어를 안 지나간 것이었다.

두 가지를 했다.

첫째, 표를 만들었다. 위에 붙인 그 표다. 값이 나가는 자리가 넷이라는 걸 한눈에 보이게 해 두면, 새 출력 경로를 만들 때 "이건 어느 칸이지" 를 묻게 된다.

둘째, 테스트로 경계를 고정했다. 특히 XML 쪽은 "탭·개행은 남기고 나머지 제어 문자는 지운다" 는 경계가 미묘해서 나중에 누가 "이거 왜 이렇게 복잡하지" 하고 단순화하면 바로 깨진다. 테스트가 있으면 단순화하려는 순간 빨간불이 켜진다.

남는 것

XSS 를 "입력을 검증하는 문제" 로 생각하면 틀린다. 출력하는 문제다.

같은 문자열이 HTML 로 나가면 안전하고 URL 로 나가면 위험하고 XML 로 나가면 파일 전체를 깨뜨린다. 입력 쪽에서 한 번 걸러서 끝낼 수 있는 성질이 아니다.

그래서 지금은 새 출력 경로를 만들 때 먼저 묻는다. 이 값이 어디로 나가는가.

URL 검사 함수는 이야기가 더 길어서 따로 썼다. 같은 부류가 거기서만 세 번 재발했고 원인이 매번 같았다.

이 글은 AI 가 조사·초안을 작성하고 사람이 검수한 뒤 발행했습니다.

관련 글