물류 데이터를 대시보드로 보여주는 사내 SaaS에 CSP(Content Security Policy)를 붙였다. 붙인 날 새벽에 배포했고, 그날 밤 화면의 자바스크립트가 전부 안 돈다는 걸 알았다. 차트만 깨진 게 아니라 사이드바도, 테마 토글도, 테이블 검색도 죽어 있었다.
원인은 CSP 자체가 아니라, CSP를 켜면서 한 파일을 빠뜨린 것이었다. 그 18시간짜리 실수와, 다시 안 겪으려고 짠 테스트를 남긴다.
왜 CSP를 켰나
이 제품에는 AI 어시스턴트가 리포트를 만들어 주는 기능이 있다. 문제는 그 결과물이 AI가 생성한 HTML이고, 그게 토큰이 붙은 공개 URL(/reports/:token)에서 렌더된다는 점이다. 로그인 없이 고객이 링크로 열어 본다.
지금은 저장 전에 sanitize를 거친다. 하지만 sanitize 화이트리스트는 언젠가 뚫린다고 보는 편이 맞다. 그때 스크립트가 실행되지는 못하게 막아 줄 한 겹이 필요했다.
그리고 확인해 보니 config/initializers/content_security_policy.rb가 Rails 기본 생성 상태 그대로, 파일 전체가 주석 처리돼 있었다. 켠 적이 한 번도 없던 것이다.
무엇을 했나
정책의 핵심은 하나다. script-src에 unsafe-inline을 두지 않는다.
Rails.application.configure do
config.content_security_policy do |policy|
policy.default_src :self
policy.base_uri :self
policy.form_action :self
policy.frame_ancestors :self
policy.object_src :none
policy.font_src :self, :data
policy.img_src :self, :data, :https
policy.connect_src :self
policy.script_src :self
# 인라인 style="" 속성(파이프라인 바 너비 등)은 nonce 로 못 덮는다.
# script 와 달리 스타일 주입은 위험도가 낮아 unsafe_inline 을 허용한다.
policy.style_src :self, :unsafe_inline
end
config.content_security_policy_nonce_generator = ->(_request) { SecureRandom.base64(16) }
config.content_security_policy_nonce_directives = %w[script-src]
end
여기서 한 판단이 두 개다.
하나, style-src는 타협했다. 인라인 style="" 속성(진행바 너비 같은 것)은 nonce로 덮을 수 없다. 전부 걷어내려면 뷰를 대대적으로 고쳐야 하는데, 스타일 주입은 스크립트 실행에 비해 위험도가 낮다. 여기선 unsafe_inline을 남기고 script 쪽에 집중했다.
둘, nonce 생성기를 세션 ID가 아니라 SecureRandom으로 했다. Rails 기본 주석은 request.session.id를 쓰는데, 그러면 같은 세션 동안 nonce가 고정된다. 요청마다 새로 뽑는 쪽을 택했다.
그리고 인라인 스크립트 3곳(레이아웃 2개 + 리포트 차트 1개)에 nonce를 붙이고, 인라인 onclick은 addEventListener로 옮겼다.
- <button onclick="window.print()"
+ <button data-report-print
같이 한 게 하나 더 있다. 고객이 보는 리포트 페이지가 <script src="https://cdn.jsdelivr.net/npm/chart.js@4">를 쓰고 있었다. CDN이고 버전도 안 고정이다. 지난달에 만든 리포트의 차트가 4.x 마이너 업데이트 때문에 어느 날 조용히 깨질 수 있는 구조다. vendor/javascript/chart.umd.js(4.5.0)로 내려서 고정했다.
시행착오 1: 리포트 페이지만 고치고 importmap을 빠뜨렸다
CDN 스크립트를 vendor로 내린 건 리포트 페이지 하나뿐이었다. config/importmap.rb는 손대지 않았다.
pin "chartkick", to: "https://cdn.jsdelivr.net/npm/[email protected]/dist/chartkick.esm.js"
pin "Chart.bundle", to: "https://cdn.jsdelivr.net/npm/[email protected]/dist/chart.umd.js"
application.js가 이 둘을 import한다. script-src 'self'는 이 둘을 차단한다.
여기서 실제로 아픈 지점은, ES 모듈은 의존성 하나가 못 불러와지면 모듈 전체가 실패한다는 것이다. 차트만 안 뜨는 게 아니다. application.js가 통째로 죽고, 그 안에서 등록되는 Stimulus 컨트롤러 11개(사이드바·테마·클립보드·AI 채팅·테이블 검색…)가 전부 등록되지 않는다.
증상은 “차트가 안 나와요”가 아니라 “화면이 반응을 안 해요”였다. 그래서 CSP를 의심하는 데 시간이 걸렸다. 서버 로그에는 아무것도 안 남는다. 전부 브라우저 콘솔에만 있다.
CSP 도입 커밋이 03:40, 이 수정이 같은 날 22:07이다. 18시간 반 동안 배포된 상태로 있었다.
고친 내용:
# CDN 금지 — CSP 가 script-src 'self' 라 외부 호스트 모듈은 브라우저에서 차단된다.
# application.js 가 이 둘을 import 하므로, 하나라도 막히면 Stimulus 전체가 안 뜬다.
pin "chartkick", to: "chartkick.js"
pin "Chart.bundle", to: "chart.umd.js"
chartkick 5.0.1을 vendor/javascript로 받았고, Chart.bundle은 리포트 페이지용으로 이미 내려둔 chart.umd.js(4.5.0)를 재사용했다. 덤으로 기존 핀(4.4.8)과 중복으로 받던 200KB가 사라졌다.
시행착오 2: WebSocket은 'self'에 포함되는데도 명시했다
AI 채팅은 ActionCable(same-origin WebSocket)로 응답을 받는다. CSP3 명세상 connect-src 'self'는 같은 오리진의 ws/wss를 포함한다. 규격대로면 건드릴 필요가 없다.
그래도 명시했다.
# CSP3 에서 'self' 가 ws/wss 를 포함하지만, 여기서 조용히 막히면
# 채팅이 통째로 죽으므로 프로덕션 호스트는 명시해 둔다.
ws_origin = ENV["APP_HOST"].presence&.then { |host| "wss://#{host}" }
policy.connect_src(*[ :self, ws_origin ].compact)
명세를 믿는 것과, 브라우저·프록시 조합이 명세대로 동작한다고 믿는 것은 다르다. 틀렸을 때의 비용(채팅 기능 전체 사망 + 로그에 안 남음)이 코드 두 줄보다 훨씬 크면 두 줄을 쓴다.
다시 안 겪으려고 짠 가드 테스트
CSP 사고의 공통점은 조용하다는 것이다. 500도 안 나고, CI도 초록이고, 서버 로그도 깨끗하다. 그래서 회귀 테스트를 통합 테스트로 박았다.
test "no importmap pin points at an external host" do
map = Rails.application.importmap.to_json(resolver: ActionController::Base.helpers)
external = JSON.parse(map)["imports"].select { |_, url| url.start_with?("http") }
assert_empty external,
"외부 호스트 핀은 CSP 에 막힌다 — vendor/javascript 에 받아서 로컬로 핀할 것"
end
def assert_no_cross_origin_scripts
srcs = response.body.scan(/<script\b[^>]*\bsrc=["']([^"']+)["']/i).flatten
srcs += response.body.scan(/<link\b[^>]*rel=["']modulepreload["'][^>]*href=["']([^"']+)["']/i).flatten
offenders = srcs.reject { |u| u.start_with?("/") }
assert_empty offenders, "CSP(script-src 'self')가 차단하는 외부 스크립트"
end
앞의 것은 설정을 보고, 뒤의 것은 실제로 렌더된 HTML을 본다. 둘 다 필요했다. modulepreload 링크까지 검사하는 이유는 importmap이 <link rel="modulepreload">도 같이 뱉기 때문이다.
그리고 두 테스트 모두, 고친 커밋을 되돌린 상태에서 실제로 빨개지는지 확인했다. 이 확인을 안 하면 “잡아 주는 줄 알았는데 안 잡아 주는 테스트”가 하나 늘 뿐이다.
같은 파일에 처음부터 있던 가드도 있다.
test "no inline event handlers in any view" do
offenders = Dir[Rails.root.join("app/views/**/*.erb")].select do |f|
File.read(f).match?(/\son(click|change|submit|load|input|error)\s*=/)
end
assert_empty offenders.map { |f| f.sub(Rails.root.to_s + "/", "") },
"CSP 가 인라인 이벤트 핸들러를 차단한다 — Stimulus 나 addEventListener 로 옮길 것"
end
정규식으로 뷰 전체를 훑는 조잡한 테스트지만, onclick 하나를 무심코 넣는 순간 CI에서 잡힌다.
배운 것
- CSP를 켜는 작업은 “정책 파일 하나 쓰기”가 아니라 “자산 공급 경로 전수 조사”다. 페이지에 박힌
<script src>만 보면 절반만 본 것이다. importmap 핀, 뷰에 남은 인라인 핸들러, WebSocket 오리진까지가 한 세트다. - ES 모듈에서 차단 하나는 국소 장애가 아니다. 의존성 하나가 막히면 진입점 모듈 전체가 실패한다. 그래서 “차트가 안 보인다”가 아니라 “앱이 죽었다”로 나타난다.
- 조용히 실패하는 변경에는 가드를 같이 넣는다. 서버 로그에 안 남는 종류의 버그는, 테스트로 고정해 두지 않으면 다음 사람이 똑같이 밟는다.
- 가드 테스트는 되돌려서 빨개지는 걸 확인해야 가드다.
한계와 다음 계획
아직 안 된 것들을 그대로 적는다.
style-src에unsafe_inline이 남아 있다. 인라인style속성을 CSS 클래스/커스텀 프로퍼티로 걷어내야 없앨 수 있는데, 아직 손대지 않았다.report-uri(또는report-to)가 없다. 지금은 위반이 발생해도 우리 쪽에 아무 신호가 안 온다. 이번 사고도 결국 사람이 화면을 보고 알았다. 위반 리포트 수집 엔드포인트를 붙이는 게 다음 순서다.- 프로덕션 브라우저 실물 검증이 없다. 통합 테스트는 응답 HTML만 보지, 브라우저가 실제로 모듈을 실행했는지는 모른다. 주요 화면에 대해 headless 브라우저로 콘솔 에러 0건을 확인하는 스모크가 있으면 좋겠다.
FAQ
Q. script-src 'self'면 CDN 라이브러리는 전부 못 쓰나?
쓰려면 script-src에 그 호스트를 명시해야 한다. 다만 그러면 그 CDN이 보내는 모든 스크립트를 신뢰하겠다는 뜻이 된다. 우리는 반대로 갔다 — 필요한 라이브러리를 vendor/javascript에 버전 고정해서 내려두고 정책은 'self'로 좁혔다. 버전이 고정되는 부수 효과가 오히려 더 컸다. 고객이 보는 리포트의 차트가 외부 CDN 상태에 좌우되지 않는다.
Q. importmap 핀이 CDN인 걸 배포 전에 알 방법은?
브라우저 콘솔에 Refused to load the script ... because it violates the following Content Security Policy directive 형태로 찍힌다. 문제는 아무도 콘솔을 안 본다는 것이다. 그래서 위 두 가지를 테스트로 박았다. 설정 레벨(importmap.to_json에 http로 시작하는 URL이 있는가)과 렌더 결과 레벨(응답 HTML의 script src/modulepreload가 전부 /로 시작하는가)을 각각 본다.
Q. nonce 생성기는 세션 ID와 SecureRandom 중 뭐가 맞나?
Rails 기본 주석은 request.session.id를 제시하지만, 그러면 같은 세션 안에서 nonce가 재사용된다. 요청마다 새로 뽑는 쪽이 안전하다. 대신 페이지 캐싱과는 궁합이 나쁘다 — nonce가 박힌 HTML을 캐시하면 헤더의 nonce와 어긋난다. 전면 캐싱을 쓰는 앱이라면 이 조합을 먼저 확인해야 한다.
Q. CSP를 처음 켤 때 report-only부터 하는 게 맞지 않나?
맞다. config.content_security_policy_report_only = true로 먼저 돌리면서 위반만 수집했다면 이 18시간을 안 겪었을 것이다. 다만 report-only는 리포트를 받아 볼 엔드포인트가 있어야 의미가 있는데, 그게 없는 상태였다. 순서를 바꿨어야 했다 — 리포트 수집부터 만들고, report-only로 한 사이클 돌리고, 그 다음에 enforce.