CSP콘텐츠 보안 정책 · Content Security Policy
웹 서버가 응답 헤더로 «이 페이지에서 실행 · 적재를 허락할 스크립트 · 플러그인 · 프레임»을 선언하면, 브라우저가 그 정책과 맞지 않는 것을 막고 위반을 보고하는 W3C 표준 정책 언어다.
1요약
- CSP 는 웹 서버가 응답 헤더로 페이지의 실행 규칙을 선언하는 W3C 정책 언어(권고 = CSP Level 2 · 2016, 현행 = CSP Level 3 · 2026년 10월 작업 초안)로, 그 위에서 nonce · hash 판정과 Reporting API 위반 보고가 돈다 — 클라우드 서비스 제공자(Cloud Service Provider)를 줄인 CSP 와는 다른 말이다.
- 출력 인코딩을 한 곳만 빠뜨려도 주입된 스크립트가 그 사이트 권한으로 실행되는데, 허용 출처 목록만으로 만든 정책은 2016년 조사에서 서로 다른 정책 26,011개 가운데 94.72% 가 우회될 수 있었다(Weichselbaum 2016).
- 정책을 켠 뒤 화면이 깨지면 위반 보고의 effectiveDirective 로 가른다 —
script-src-attr이면 우리 템플릿의 이벤트 속성,script-src-elem에 blockedURLinline이면 nonce · 해시 누락, sourceFile 이 확장 기능 주소면 고칠 코드가 없다.
2등장 배경
XSS 는 출력 하나만 인코딩을 빠뜨려도 생기므로, 템플릿이 많은 사이트는 서버 점검만으로 모든 출력을 확신할 수 없었다. 브라우저가 사이트의 선언을 받아 실행 단계에서 한 번 더 거르는 장치가 필요했다.
Mozilla 출신 Brandon Sterne 과 Google 의 Adam Barth 가 편집한 CSP 1.0 이 2012년 11월 W3C 후보 권고가 됐고, 2016년 12월 CSP Level 2 가 nonce · hash 원본 표현을 넣어 권고로 확정됐다(CSP 1.0 · CSP Level 2). 같은 해 Google 의 Weichselbaum 등은 CCS 2016 논문에서 많이 허용되는 출처 15곳 가운데 14곳에 위험한 주소가 있어 허용 목록이 무너진다고 보이고 'strict-dynamic' 을 제안했다.
CSP Level 3(2026년 10월 27일 작업 초안)은 Fetch 표준 위에서 다시 쓰였고, report-uri 대신 Reporting API 의 report-to 로 보고하며 'strict-dynamic' · 외부 스크립트 해시 · 'unsafe-hashes' 를 더했다(CSP Level 3 1.3절).
3쉽게 이해하기 — 출입 규칙표를 받는 전시회 입구
전시회 주최 본부가 손님이 올 때마다 입구 경비에게 출입 규칙표를 새로 건넨다. 규칙표에는 「오늘 색 팔찌를 찬 사람」과 「등록 사진과 똑같은 사람」만 들이고, 이들이 데리고 온 일행도 들여도 된다고 적혀 있다. 팔찌도 사진도 없이 줄에 끼어든 사람은 돌려보내고, 경비는 그 일을 기록지에 적어 본부로 보낸다. 새 규칙을 시험하는 리허설 날에는 아무도 막지 않고 기록만 한다.
그림 1 · 본부가 건넨 규칙표대로 경비가 팔찌 · 사진 · 일행만 들이고, 끼어든 사람은 막은 뒤 기록을 본부로 보낸다 — 리허설 날에는 막지 않고 기록만 한다.
그림 2 · 등록 사진과 한 군데만 달라도 들이지 않듯, 인라인 스크립트도 한 낱말만 바뀌면 SHA-256 값이 달라져 막힌다.
| 아이콘 · 비유 속 역할 | CSP 요소 | 실제로 하는 일 |
|---|---|---|
| 주최 본부 | 웹 서버 | 응답마다 정책을 헤더에 실어 보낸다 |
| 출입 규칙표 | Content-Security-Policy 헤더 | 지시어마다 허락할 출처 · 값을 적는다 |
| 입구 경비 | 브라우저 | 스크립트 요청 · 인라인 스크립트를 정책과 대조해 허용하거나 막는다 |
| 오늘 색 팔찌 | nonce | 응답마다 새로 만든 임의 값과 같은 값을 가진 script 요소만 실행한다 |
| 사진 대조 | hash | 스크립트 내용의 SHA-256 값이 정책에 적힌 값과 같아야 실행한다 |
| 데려온 일행 | 'strict-dynamic' | 허용된 스크립트가 만들어 넣은 script 요소도 실행한다 |
| 기록지 | report-to · 위반 보고 | 막은 내용을 JSON 으로 수집 끝점에 보낸다 |
| 리허설 날 | Content-Security-Policy-Report-Only | 막지 않고 보고만 해서 새 정책을 시험한다 |
⚠ 비유가 맞지 않는 곳: 실제 경비는 손님 한 명이 아니라 스크립트 «한 덩이»를 보며, 같은 페이지 안에서도 onclick 같은 이벤트 속성은 script-src-attr 이라는 다른 줄로 판정된다(CSP Level 3 6.8.3절). 팔찌 값도 하루가 아니라 응답 하나마다 바뀌어야 한다(7.1절).
4구조 — 정책 전달 헤더와 지시어
정책은 응답 헤더로 오고, 브라우저는 받은 정책마다 강제(enforce) · 보고(report) 처분을 붙여 정책 목록에 둔다(CSP Level 3 3.1 · 3.2절). 정책이 둘 이상이면 요청은 모두를 통과해야 하므로, 정책을 더하면 제한만 늘어난다(8.1절).
그림 3 · 헤더 둘이 처분이 다른 정책 둘을 만들고, 지시어 네 분류가 요청마다 허용 · 차단 · 보고를 정한다 — 보고는 Reporting-Endpoints 가 정한 끝점으로 간다.
| 요소 | 분류 | 역할 | 값 · 근거 |
|---|---|---|---|
| default-src | 가져오기 | 따로 적지 않은 가져오기 지시어의 대체 값 | 'none' · 'self'(6.1.3절) |
| script-src | 가져오기 | 스크립트의 출처 · nonce · hash · 'strict-dynamic' | script-src-elem · script-src-attr 의 대체(6.8.3절) |
| object-src | 가져오기 | object · embed 플러그인 | 'none' 이면 주소 없는 플러그인도 막음(6.1.9절) |
| base-uri | 문서 | base 요소가 바꿀 수 있는 기준 주소 | Strict CSP = 'none' 또는 'self'(6.3.1 · 8.5절) |
| frame-ancestors | 탐색 | 이 페이지를 프레임에 넣을 수 있는 상위 페이지 | 헤더로만 · meta 이면 무시 · 강제 처분이면 X-Frame-Options 보다 우선(6.4.2절) |
| report-to | 보고 | 위반 보고를 보낼 끝점 이름 | Reporting-Endpoints 헤더의 이름(6.5.2절 · Reporting API 3.2절) |
| nonce | 원본 표현 | 응답마다 새로 만든 임의 값 | 인코딩 전 128비트 이상 · 암호학적 난수(7.1절) |
| hash | 원본 표현 | 스크립트 내용의 지문 | sha256 · sha384 · sha512(2.3.1절) |
🔑 정책 문자열이 같아도 nonce 는 응답마다 바뀌고 hash 는 내용이 바뀔 때만 바뀐다 — 그래서 nonce 는 응답을 만드는 서버가, hash 는 페이지를 만드는 빌드가 맡는다.
5동작 — 정적 문서 사이트의 해시 기반 정책 도입
문서 사이트 docs.example(RFC 2606 예약 도메인)은 CDN 이 같은 HTML 을 캐시해 내보내므로 응답마다 nonce 를 바꿀 수 없어 해시 기반 정책을 고른다. 보고 건수 · 기간은 설명용 가정 값이고, 해시 값은 사례 스크립트 원문의 SHA-256 을 직접 계산한 값이다.
- 빌드가 인라인 스크립트 두 개 — 테마를 정하는 한 줄과
/js/app.js를 불러오는 로더 — 의 UTF-8 내용으로 SHA-256 을 계산해'sha256-dhvU1u…'·'sha256-L7FntO…'를 얻는다(CSP Level 3 8.4절). - 서버가 아래 정책을
Content-Security-Policy-Report-Only로 내보내고,Reporting-Endpoints헤더에 끝점csp-docs를 적는다(3.2절 · Reporting API 3.2절). - 14일 동안 보고 1,846건이 모인다 — 1,790건은 effectiveDirective 가
script-src-attr(검색창 버튼의onclick속성), 41건은 sourceFile 이 브라우저 확장 주소, 15건은script-src-elem에 blockedURLinline이다(5절). - 15건이 나온 페이지는 테마 기본값을
"dark"에서"light"로 고친 뒤 해시를 다시 계산하지 않아, 내용의 SHA-256 이Ydj6m1…로 바뀌어 있었다. onclick속성을 외부 파일의addEventListener로 옮기고, 해시 계산을 배포 단계에 고정해 내용과 정책이 함께 바뀌게 한다 — 'unsafe-hashes' 로 속성을 허락하는 길은 쓰지 않는다(8.3절).- 다시 7일 동안 우리 코드 위반은 0건, 확장 기능 보고만 38건이다.
- 헤더 이름을
Content-Security-Policy로 바꿔 강제한다 — 로더가createElement로 넣은/js/app.js와 그 파일이 넣는 통계 스크립트는 'strict-dynamic' 으로 실행되고, 함께 적은https:·'unsafe-inline'은 옛 브라우저용이라 무시된다(6.7.3.2 · 8.2절). - 다른 출처 페이지가 문서를 iframe 으로 넣으려 하면
frame-ancestors 'self'에 막히고, 그 보고도 같은 끝점으로 온다(6.4.2절).
Content-Security-Policy-Report-Only: script-src 'sha256-dhvU1uerbner1yHh8/LmMp3j4AEURt34rCBAaAbIM94=' 'sha256-L7FntOLZDd13hrz6nYF1+mmlyxFhPRgVCgWciXNmLvA=' 'strict-dynamic' https: 'unsafe-inline'; object-src 'none'; base-uri 'none'; frame-ancestors 'self'; report-to csp-docs
Reporting-Endpoints: csp-docs="https://report.docs.example/csp"
그림 4 · 보고 전용 정책으로 3주를 지켜보며 이벤트 속성 1,790건과 해시 누락 15건을 먼저 없앤 뒤에야 강제 헤더로 바꿨다.
그림 5 · 판정은 효과 지시어를 찾은 뒤 nonce · hash 가 'unsafe-inline' 을, 'strict-dynamic' 이 출처 목록을 끄는 순서로 좁혀지고, 처분이 차단과 보고만을 가른다.
🔑 'unsafe-inline' 은 nonce · hash 가 하나라도 있으면 꺼지고 없으면 인라인 전부를 연다 — 옛 브라우저를 위한 대비 값일 뿐, 위반 보고를 없애려고 더하는 값이 아니다(CSP Level 3 6.7.3.2절).
⚠ CSP Level 3 8.5절은 'strict-dynamic' 이 도입을 쉽게 하지만 될 수 있으면 피하라고 적는다. 허용된 스크립트가 넣는 스크립트는 모두 따라 허용되므로, 로더가 넣는 주소가 고정 값인지 함께 점검한다.
6비교 — 허용 목록 · nonce · hash 방식
| 기준 | 허용 목록(host-source) | nonce | hash |
|---|---|---|---|
| 허락하는 근거 | 스크립트가 온 출처 · 경로 | 응답마다 새 값과 같은 nonce 속성 | 내용의 SHA-256 · 384 · 512 지문 |
| 맞는 페이지 | 출처가 적고 고정된 사이트 | 서버가 응답마다 HTML 을 만드는 사이트 | CDN 캐시 · 정적 페이지 |
| 인라인 스크립트 | 'unsafe-inline' 없으면 전부 막힘 | 값을 넣은 것만 실행 | 내용이 같은 것만 실행 |
| 정책을 고칠 때 | 새 외부 출처를 쓸 때마다 | 거의 없음 | 인라인 내용이 바뀔 때마다 |
| 무너지는 조건 | 허용 출처 안의 위험한 주소(조사 정책의 75.81%) | 값이 새거나 재사용될 때(7.1 · 7.2절) | 허락한 스크립트 자체가 외부 값을 실행할 때 |
| Strict CSP 해당 | 아님 | 해당(8.5절) | 해당(8.5절) |
분석서버가 응답을 만들면 nonce, 같은 HTML 을 캐시해 내보내면 hash 를 고르고, 허용 목록은 Strict CSP 의 옛 브라우저용 대비 값(https:) 자리에만 둔다. 근거는 표의 「무너지는 조건」 행 — 2016년 조사에서 서로 다른 정책의 75.81% 가 허용 목록 때문에 우회될 수 있었다(Weichselbaum 2016).
7실무 진단 — 위반 보고로 원인 가르기
분석보고 묶음은 effectiveDirective → sourceFile → 처분 순으로 나눈다. 지시어가 고칠 코드의 종류(요소 · 속성 · 프레임)를 정하고, sourceFile 이 우리 코드인지가 고칠지 말지를 정하기 때문이다(CSP Level 3 5절 · 6.8.3절).
| # | 증상 | 의심 원인 | 구분 | 확인 자료 | 판정 기준(근거) |
|---|---|---|---|---|---|
| 1 | script-src-attr 보고가 대부분 | 템플릿의 onclick 같은 이벤트 속성 | 속성 | 보고 documentURL · 템플릿 검색 | 우리 템플릿이면 외부 파일로 옮김 · 'unsafe-hashes' 는 마지막 수단(6.8.3 · 8.3절) |
| 2 | script-src-elem · blockedURL inline | nonce 누락 또는 해시 갱신 누락 | 요소 | 응답 헤더의 값 ↔ 빌드가 계산한 해시 | 값이 다르면 빌드 · 배포 순서 문제(8.4절) |
| 3 | 로더가 넣은 스크립트만 막힘 | 'strict-dynamic' 없음 · 파서가 넣은 요소 | 요소 | 정책 문자열 · 로더가 요소를 넣는 방식 | 'strict-dynamic' 이 있고 createElement 로 넣으면 허용(8.2절) |
| 4 | 정책을 넣었는데 프레임 삽입이 됨 | frame-ancestors 를 meta 요소로 전달 | 탐색 | 응답 헤더 ↔ HTML meta | meta 의 frame-ancestors 는 무시(3.3 · 6.4.2절) |
| 5 | 보고가 한 건도 오지 않음 | report-to 이름과 끝점 이름 불일치 | 보고 | Reporting-Endpoints 헤더 · 정책의 report-to | 두 이름이 같아야 전송(6.5.2절 · Reporting API 3.2절) |
effectiveDirective 부터 보면 사례의 1,846건도 지시어 두 개로 묶여 고칠 코드가 바로 좁혀진다. 그다음 sourceFile 로 확장 기능을 떼고, 처분이 report 이면 화면은 아직 깨지지 않았으므로 강제 전환을 미룬다.
8시험 대비
www.q-net.or.kr시험에서는 지시어 · 원본 표현 · 위반 보고를 묻는 정의 · 특징형과 기존 사이트에 정책을 들이는 순서를 묻는 구현 · 설계형이 나올 수 있다. 유형 · 출력 인코딩은 XSS 가 맡는다.
- 개요 — 정의 · W3C CSP Level 3(작업 초안) · Level 2(권고 2016) · 클라우드 서비스 제공자와 구분 · 출력 인코딩 뒤의 추가 방어
- 구조 — 그림 3 정책 전달 구조(헤더 셋 · 처분 둘 · 지시어 네 분류) + 지시어 표(default-src · script-src · object-src · base-uri · frame-ancestors · report-to)
- 판정 원리 — 그림 5 판정 흐름(대체 순서 · nonce · hash 가 'unsafe-inline' 을 끔 · 'strict-dynamic')
- 방식 비교 — 허용 목록 · nonce · hash 비교표 + 우회 비율 94.72% · 75.81%(CCS 2016)
- 도입 절차 — 그림 4 순서도(해시 계산 → Report-Only → 보고 분류 → 코드 정리 → 강제) + 보고 필드 effectiveDirective · sourceFile
- 한계와 보완 — 출력 인코딩이 먼저 · Trusted Types · nonce 128비트 이상 · meta 로는 frame-ancestors 불가
꼭 쓸 키워드
Strict CSPnoncehashstrict-dynamicReport-Onlyreport-toReporting-Endpointsframe-ancestorsobject-srcbase-uri
차이를 내는 한 가지 = 「nonce · hash 가 있으면 'unsafe-inline' 이 꺼진다」는 판정 규칙(6.7.3.2절)을 그림 5 로 보이는 것이다.
9오해와 사실
- 오해CSP 를 켜면 XSS 취약점이 고쳐진다.사실CSP 는 주입된 스크립트의 실행을 막을 뿐 값이 HTML 로 들어가는 출력은 그대로 남으며, OWASP 도 CSP 를 XSS 의 유일한 방어로 믿지 말고 안전한 개발 관행 위에 더하는 방어로 쓰라고 적는다(OWASP CSP 치트 시트).
- 오해meta 요소에 넣은 정책은 헤더와 똑같이 동작한다.사실meta 로는 Report-Only · report-uri · frame-ancestors · sandbox 를 전달할 수 없고, frame-ancestors 는 무시된다(CSP Level 3 3.3 · 6.4.2절).
- 오해보고 전용 정책은 강제 정책과 함께 보낼 수 없다.사실두 헤더를 함께 보내면 각각 강제 · 보고 처분의 정책이 되어, 강제 중에도 다음 정책을 보고만 받으며 시험할 수 있다(CSP Level 3 3.2 · 8.1절).
10핵심 정리
| 구분 | 거르는 대상 | 대표 값 | 값을 정하는 곳 | 실어 보내는 곳 |
|---|---|---|---|---|
| script-src | 스크립트 요소 · 속성 | nonce · hash · 'strict-dynamic' | 서버 · 빌드 | 헤더 · meta |
| object-src | object · embed 플러그인 | 'none' | 정책 작성자 | 헤더 · meta |
| base-uri | base 요소의 기준 주소 | 'none' · 'self' | 정책 작성자 | 헤더 · meta |
| frame-ancestors | 이 페이지를 넣는 상위 프레임 | 'none' · 'self' | 정책 작성자 | 헤더만 |
| nonce | 값이 없는 인라인 · 외부 스크립트 | 응답마다 128비트 이상 | 응답을 만드는 서버 | 헤더 + script 속성 |
| hash | 내용이 바뀐 인라인 스크립트 | sha256 · sha384 · sha512 | 페이지를 만드는 빌드 | 헤더 |
| Report-Only | 막지 않고 보고만 | 처분 report | 도입 담당 | 헤더만 |
| report-to | 보고를 보낼 곳 | 끝점 이름 | 서버 | 헤더 + Reporting-Endpoints |
11참고 문헌
- 먼저 볼 문헌
- ★ Content Security Policy Level 3 (W3C Working Draft) — 지시어 대체 순서 · 인라인 판정 알고리즘 · Strict CSP 예시를 원문으로 볼 때
- ★ CSP Is Dead, Long Live CSP! On the Insecurity of Whitelists and the Future of Content Security Policy (Weichselbaum · Spagnuolo · Lekies · Janc · ACM CCS 2016) — 허용 목록 정책이 우회되는 까닭과 'strict-dynamic' 이 나온 배경을 볼 때
- ★ Reporting API (W3C Working Draft) — Reporting-Endpoints 헤더와 보고 전송 형식을 볼 때
- ★ Content Security Policy Cheat Sheet — 정책 전달 방법 세 가지와 nonce · hash 정책 예시를 볼 때
- 본문 근거
- Content Security Policy Level 2 (W3C Recommendation) — W3C · 2016-12 ·
www.w3.org/TR/CSP2/· 확인 2026-11-04 - Content Security Policy 1.0 (W3C Working Group Note · 2012-11 Candidate Recommendation) — W3C · 2015-02 ·
www.w3.org/TR/CSP1/· 확인 2026-11-04 - RFC 2606 Reserved Top Level DNS Names — IETF · 1999-06 ·
www.rfc-editor.org/rfc/rfc2606· 확인 2026-11-04