웹 만들기

CSP 설정하는 법: 인라인 스크립트 해시가 깨질 때

「인라인 스타일과 스크립트를 해시로 잠그면 왜 깨질까?」 Windows CRLF 줄바꿈과 Cloudflare 분석 스크립트 충돌 해결.

인라인 CSS와 SHA-256 해시 CSP로 굽던 3판 카보틴 스튜디오 홈 화면

정적 웹사이트에서 외부 CSS와 자바스크립트 요청을 없애려고 모든 코드를 HTML 안에 인라인으로 넣으면서, 동시에 unsafe-inline 없이 엄격한 CSP(Content-Security-Policy)를 유지하려면 어떻게 해야 할까?

가장 확실한 방법은 빌드 시점에 <style>과 <script> 태그 안의 텍스트를 SHA-256으로 해싱해 응답 헤더(_headers)에 'sha256-...' 목록으로 적어 주는 것이다.

카보틴 스튜디오 공식 홈(kavotin.com)은 첫 화면 표시 시간(FCP)을 줄이려고 홈 CSS(11월 20일 빌드 기준 18.0KB)와 블로그 추가 CSS(10.4KB), 카드 가로 넘김 스크립트(src/main.js), 구조화 데이터(application/ld+json)를 모두 HTML 안에 인라인으로 굽고 default-src 'none' 기반의 해시 CSP를 걸었다.

하지만 이 해시 CSP는 두 번 흔들렸다. 11월 11일에는 Cloudflare가 응답에 끼워 넣은 스크립트가 실제로 막혔고, 11월 15일에는 Windows 줄바꿈 문자(CRLF)가 원본 파일에 섞여 들어온 것을 굽기 전에 찾아냈다. 두 원인과 build.mjs · test/check.mjs에 넣은 대책을 기록한다.

외부 요청을 없앤 인라인 구조와 해시

홈페이지 첫 화면을 캐시 없이 열 때 브라우저가 별도의 .css나 .js 파일을 다시 요청하면 왕복 지연(RTT)이 한 번 더 든다.

그래서 build.mjs는 주석과 공백을 압축한 CSS 문자열과 스크립트 문자열을 모든 HTML 파일의 <head>와 <body> 끝에 바로 넣는다.

그 대신 인라인 코드가 임의로 실행되는 XSS(교차 사이트 스크립팅) 구멍을 막으려고 unsafe-inline을 열지 않고 Node.js의 crypto 모듈로 각 블록의 SHA-256 해시를 계산한다.

const b64 = (s) => crypto.createHash('sha256').update(s).digest('base64');
const csp = (styles, scripts) =>
  `default-src 'none'; img-src 'self' data:; font-src 'self'; ` +
  `style-src ${styles.map((s) => `'sha256-${b64(s)}'`).join(' ')}; ` +
  `script-src ${scripts.map((s) => `'sha256-${b64(s)}'`).join(' ')} https://static.cloudflareinsights.com; ` +
  `connect-src 'self' https://cloudflareinsights.com; base-uri 'none'; form-action 'none'; frame-ancestors 'none'`;

블로그 페이지는 홈 기본 스타일(css, 18.0KB)에 블로그 전용 스타일(blogCss, 10.4KB)까지 <style> 태그 두 개를 쓰므로 style-src에 SHA-256 해시 두 개가 나란히 들어간다.

스크립트 쪽도 본문 동작 스크립트(js)와 첫 화면 조직 정보 JSON-LD(jsonLd) 두 개의 해시가 script-src에 들어간다.

Windows CRLF 줄바꿈과 해시 불일치

줄바꿈 이야기는 2026년 11월 15일, 블로그 틀을 만들려고 같은 저장소의 git worktree를 Windows에 새로 풀었을 때 시작됐다.

파일 내용은 그대로인데 grep -c $'\r'로 세어 보니 build.mjs · src/styles.css 같은 원본에 CR 문자가 섞여 있었다. git이 체크아웃하면서 줄 끝을 CRLF(\r\n, 0x0D 0x0A)로 바꿔 놓은 것이다.

이대로 구우면 해시가 틀어진다. 이유는 빌드 도구와 HTML 파서가 같은 글자를 다르게 읽기 때문이다.

  1. Windows에서 편집하거나 체크아웃한 파일에 \r\n이 섞여 들어가면, 빌드 스크립트의 crypto.createHash('sha256').update(s)는 \r(0x0D) 바이트까지 그대로 포함해 해시를 계산한다.
  2. 반면 웹 브라우저의 HTML 파서는 WHATWG HTML 명세(Preprocessing the input stream)에 따라 네트워크로 받은 바이트 스트림에서 모든 \r\n과 단독 \r을 먼저 \n(0x0A, LF)으로 바꾼 뒤 DOM 트리를 만든다.
  3. 브라우저의 CSP 검사기는 그렇게 정규화가 끝난(<style> · <script> 안의 \r이 모두 제거된) 문자열을 기준으로 SHA-256 해시를 계산한다.

결국 인라인 블록 안에 CR이 1바이트라도 남으면 빌드 도구가 계산한 해시(\r\n 기준)와 브라우저가 계산한 해시(\n 기준)가 달라져 스타일이나 스크립트가 통째로 막힌다. 화면이 깨진 채 배포되기 전에 찾았으니 운이 좋았던 편이다.

같은 일이 다시 생기지 않게 세 가지를 고정했다.

  • 저장소 루트에 .gitattributes 파일을 만들고 * text=auto eol=lf와 바이너리 확장자(*.png, *.webp, *.jpg, *.ico, *.woff2)를 지정해 Windows에서도 모든 텍스트 파일이 LF로만 체크아웃되도록 고정했다(커밋 2c3acc0). 그다음 파일을 지우고 git checkout-index --all로 다시 풀었다.
  • build.mjs는 스크립트(src/main.js)의 주석 줄을 지우고 \n 뒤 공백까지 걷어 한 줄로 만든 뒤 해시를 낸다. CSS(src/styles.css · src/blog.css)도 minCss()로 줄인 문자열을 해싱한다.
  • test/check.mjs에 !h.includes(String.fromCharCode(13)) 검사를 넣었다(커밋 ea26d20, 지금은 29줄). 구운 HTML 파일(dist/*.html) 어디에든 CR 문자(0x0D, ASCII 13)가 단 1바이트라도 섞여 있으면 빌드가 즉시 실패한다.

Cloudflare 분석 스크립트 주입과 차단

두 번째 문제는 2026년 11월 11일 첫 판(ba41fb7d)을 실제 도메인(kavotin.com)에 올린 직후에 일어났다.

로컬에서 구운 파일을 헤드리스 크롬으로 열었을 때는 390폭과 1440폭 모두 콘솔 오류가 0건이었다.

그런데 Cloudflare Workers에 배포한 뒤 실제 주소(https://kavotin.com/)를 열자 브라우저 콘솔에 CSP 차단 오류가 1건 찍혔고, 로컬 빌드본과 배포본이 일치하는지 확인하는 라이브 검사까지 실패했다.

실제 서버가 내려준 HTML 응답 본문을 뜯어보니, 우리가 구운 </body> 바로 앞에 로컬에는 없던 <script> 태그 하나가 끼워져 있었다.

Cloudflare 대시보드의 Web Analytics(RUM, 실제 사용자 모니터링) 기능이 켜져 있으면, Cloudflare 프록시가 HTML 응답을 내보낼 때 자동으로 https://static.cloudflareinsights.com/beacon.min.js 스크립트 태그를 주입한다. 그리고 이 스크립트가 브라우저에서 돌면서 /cdn-cgi/rum 경로와 https://cloudflareinsights.com으로 방문 통계 비콘(connect-src)을 보낸다.

우리의 초기 CSP 헤더는 default-src 'none'에 우리가 구운 인라인 해시만 열어 두었기 때문에, Cloudflare가 스스로 끼워 넣은 외부 스크립트도 막히고 비콘 전송 요청도 막힌 것이다.

해결 방법은 두 단계였다.

표의 「스크립트」는 script-src, 「비콘 전송」은 connect-src, 「배포본 대조」는 test/check.mjs의 --live 검사다.

처음 검사는 body === html로 문자열을 그대로 비교했다.

무엇처음고친 뒤
스크립트해시만해시 + 분석 스크립트 주소
비콘 전송막힘'self' + 분석 주소
배포본 대조그대로 비교분석 태그 빼고 비교

먼저 build.mjs의 csp() 함수에서 script-src에 https://static.cloudflareinsights.com을 더하고 connect-src 'self' https://cloudflareinsights.com을 열었다. 다시 배포하자 실제 주소의 콘솔 오류가 즉시 0건으로 내려갔다.

그다음 배포 검증 도구인 test/check.mjs의 --live 검사에서는 로컬 dist/index.html과 실서버 응답 본문을 비교할 때 Cloudflare가 끼워 넣은 분석 스크립트 줄만 정규식으로 걷어내고 비교하도록 flat 함수를 작성했다.

const flat = (s) =>
  s.replace(/<script[^>]*cloudflareinsights[^>]*><\/script>|<!--[\s\S]*?-->/g, '')
   .replace(/\s+/g, ' ');
ok(flat(body) === flat(html), '올라간 첫 화면이 구운 것과 같다(Cloudflare 방문 셈 스크립트는 뺀다)');

빌드 뒤 자동 검사 734개 항목

11월 20일 기준 test/check.mjs는 로컬 빌드 직후 734개 항목을 검사한다. --live https://kavotin.com 옵션을 주면 실서버 응답 검사가 그 뒤에 더 붙는다.

그중 CSP 및 바이트 무결성과 관련된 핵심 검사 항목은 다섯 가지다.

  1. 구운 모든 HTML 파일에 CR 문자(String.fromCharCode(13))가 0개인지 확인한다.
  2. 실서버 첫 화면 응답 헤더의 content-security-policy에 default-src 'none'이 포함되어 있는지 확인한다.
  3. 실서버가 내려준 첫 화면과 제품 소개 페이지 4곳(/about/oncall, /about/cloudline, /about/hongsil, /about/karyon) 등의 HTML이 Cloudflare 분석 스크립트를 제외하고 로컬 빌드본과 글자 하나까지 일치하는지 대조한다.
  4. 첫 화면 전체 무게(HTML + 글꼴 두 벌 + 첫 화면 그림)가 230KB 상한 아래(11월 20일 빌드 219.2KB)인지 확인한다. 인라인 CSS가 커질수록 여기에 먼저 걸린다.
  5. 헤드리스 크롬으로 실제 주소를 390폭과 1440폭으로 열었을 때 console.error와 pageerror가 0건인지 확인한다.

저는 정적 사이트에 CSP를 걸면서 귀찮다는 이유로 unsafe-inline을 열어 두면 CSP를 쓰는 의미가 반감된다고 본다. 빌드 스크립트에서 SHA-256 해시를 자동으로 뽑아 _headers에 적고, Windows의 CRLF 줄바꿈과 호스팅 프록시가 주입하는 스크립트 두 가지만 테스트 코드로 고정해 두면 unsafe-inline 없이도 인라인 최적화와 보안을 둘 다 챙길 수 있다.

웹 만들기

글 · Kavotin Studio. 숫자는 직접 잰 것만 기록. 문의