IT › 보안 › 애플리케이션 · 클라우드 보안 › 애플리케이션 보안

CSP콘텐츠 보안 정책 · Content Security Policy

웹 서버가 응답 헤더로 «이 페이지에서 실행 · 적재를 허락할 스크립트 · 플러그인 · 프레임»을 선언하면, 브라우저가 그 정책과 맞지 않는 것을 막고 위반을 보고하는 W3C 표준 정책 언어다.

1요약

  1. CSP 는 웹 서버가 응답 헤더로 페이지의 실행 규칙을 선언하는 W3C 정책 언어(권고 = CSP Level 2 · 2016, 현행 = CSP Level 3 · 2026년 10월 작업 초안)로, 그 위에서 nonce · hash 판정과 Reporting API 위반 보고가 돈다 — 클라우드 서비스 제공자(Cloud Service Provider)를 줄인 CSP 와는 다른 말이다.
  2. 출력 인코딩을 한 곳만 빠뜨려도 주입된 스크립트가 그 사이트 권한으로 실행되는데, 허용 출처 목록만으로 만든 정책은 2016년 조사에서 서로 다른 정책 26,011개 가운데 94.72% 가 우회될 수 있었다(Weichselbaum 2016).
  3. 정책을 켠 뒤 화면이 깨지면 위반 보고의 effectiveDirective 로 가른다 — script-src-attr 이면 우리 템플릿의 이벤트 속성, script-src-elem 에 blockedURL inline 이면 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쉽게 이해하기 — 출입 규칙표를 받는 전시회 입구

전시회 주최 본부가 손님이 올 때마다 입구 경비에게 출입 규칙표를 새로 건넨다. 규칙표에는 「오늘 색 팔찌를 찬 사람」과 「등록 사진과 똑같은 사람」만 들이고, 이들이 데리고 온 일행도 들여도 된다고 적혀 있다. 팔찌도 사진도 없이 줄에 끼어든 사람은 돌려보내고, 경비는 그 일을 기록지에 적어 본부로 보낸다. 새 규칙을 시험하는 리허설 날에는 아무도 막지 않고 기록만 한다.

주최 본부 본부 웹 서버 출입 규칙표 CSP 헤더 기록지 모음 보고 수집 끝점 입구 경비 브라우저 행사장 안 오늘 색 팔찌 nonce 사진 대조 hash 데려온 일행 strict-dynamic 끼어든 사람 주입 스크립트 1 2 들임 3 막음 4 리허설 날 — 아무도 막지 않고 4번 기록만 보낸다 CSP-Report-Only 배지 = 실제 기술 이름 · 원 숫자 = 손님 한 명이 오갈 때의 순서

그림 1 · 본부가 건넨 규칙표대로 경비가 팔찌 · 사진 · 일행만 들이고, 끼어든 사람은 막은 뒤 기록을 본부로 보낸다 — 리허설 날에는 막지 않고 기록만 한다.

규칙표 전달본부가 손님마다 새로 건넴
팔찌 확인오늘 색 팔찌만
사진 대조등록 사진과 똑같은가
일행 입장들어온 손님이 데려온 사람
돌려보냄표시 없이 끼어든 사람
기록 보고기록지를 본부로
비유 — 등록 사진과 대조 등록 사진 = 검은 모자 모자 판정 손님 1 검은 모자 입장 손님 2 흰 모자 돌려보냄 한 군데만 달라도 들이지 않는다 실제 — 인라인 스크립트의 SHA-256 script-src 'sha256-dhvU1u…' 내용 끝 값 SHA-256 앞 6자 판정 "dark" dhvU1u… 실행 "light" Ydj6m1… 차단 · 보고 내용 = 테마를 정하는 한 줄의 UTF-8 바이트 dhvU1u… · Ydj6m1… = 44자 base64 값의 앞 6자 굵은 테두리 = 바뀐 값

그림 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절).

응답 헤더 브라우저 정책 목록 지시어 분류(CSP Level 3 6절) Content-Security-Policy 강제 — 차단 + 보고 …-Report-Only 보고만 — 막지 않음 Reporting-Endpoints 끝점 이름 = 보고 주소 정책 1 enforce 정책 2 report 가져오기(6.1절) default-src · script-src object-src 문서(6.3절) base-uri 탐색(6.4절) frame-ancestors 보고(6.5절) report-to 요청마다 판정 허용 → 실행 · 적재 모든 정책 통과 차단 enforce 정책 위반만 보고 JSON → 끝점 두 처분 모두 정책 · 처분 보고 허용 차단 점선 상자 = 보고만 하는 정책

그림 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 을 직접 계산한 값이다.

  1. 빌드가 인라인 스크립트 두 개 — 테마를 정하는 한 줄과 /js/app.js 를 불러오는 로더 — 의 UTF-8 내용으로 SHA-256 을 계산해 'sha256-dhvU1u…' · 'sha256-L7FntO…' 를 얻는다(CSP Level 3 8.4절).
  2. 서버가 아래 정책을 Content-Security-Policy-Report-Only 로 내보내고, Reporting-Endpoints 헤더에 끝점 csp-docs 를 적는다(3.2절 · Reporting API 3.2절).
  3. 14일 동안 보고 1,846건이 모인다 — 1,790건은 effectiveDirective 가 script-src-attr(검색창 버튼의 onclick 속성), 41건은 sourceFile 이 브라우저 확장 주소, 15건은 script-src-elem 에 blockedURL inline 이다(5절).
  4. 15건이 나온 페이지는 테마 기본값을 "dark" 에서 "light" 로 고친 뒤 해시를 다시 계산하지 않아, 내용의 SHA-256 이 Ydj6m1… 로 바뀌어 있었다.
  5. onclick 속성을 외부 파일의 addEventListener 로 옮기고, 해시 계산을 배포 단계에 고정해 내용과 정책이 함께 바뀌게 한다 — 'unsafe-hashes' 로 속성을 허락하는 길은 쓰지 않는다(8.3절).
  6. 다시 7일 동안 우리 코드 위반은 0건, 확장 기능 보고만 38건이다.
  7. 헤더 이름을 Content-Security-Policy 로 바꿔 강제한다 — 로더가 createElement 로 넣은 /js/app.js 와 그 파일이 넣는 통계 스크립트는 'strict-dynamic' 으로 실행되고, 함께 적은 https: · 'unsafe-inline' 은 옛 브라우저용이라 무시된다(6.7.3.2 · 8.2절).
  8. 다른 출처 페이지가 문서를 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"
빌드 · 서버 브라우저 보고 수집 끝점 1 인라인 2개 SHA-256 계산 2 Report-Only 정책 헤더 3 14일 · 보고 1,846건 4 1,790 script-src-attr 41 확장 · 15 해시 불일치 5 onclick → 외부 파일 해시 계산을 배포에 고정 6 7일 · 우리 코드 0 · 확장 38 7 Content-Security-Policy 8 app.js · 통계 스크립트 실행 다른 출처 iframe 차단 정책 헤더(굵은 선 = 강제) 위반 보고 상자 = 그 열 안에서 한 일 · 원 숫자 = 사례 단계

그림 4 · 보고 전용 정책으로 3주를 지켜보며 이벤트 속성 1,790건과 해시 누락 15건을 먼저 없앤 뒤에야 강제 헤더로 바꿨다.

스크립트 하나 요소 · 속성 · 동적 생성 효과 지시어 찾기(6.8.3절) script-src-elem → script-src → default-src 목록에 nonce · hash 가 있나 6.7.3.2절 예 'unsafe-inline' 무시 맞는 값만 인라인 허용 예 · 아니오 모두 다음 판정으로 'strict-dynamic' 이 있나 8.2절 예 host · 'self' · https: 무시 만든 script 요소 허용 값 대조 nonce 값 · 해시 값 · 남은 출처 일치 → 실행 두 처분 같음 불일치 → 차단 + 보고 enforce 정책 불일치 → 실행 + 보고 report 정책(Report-Only) 판정 규칙 허용 차단 점선 상자 = 보고만 하는 정책

그림 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)noncehash
허락하는 근거스크립트가 온 출처 · 경로응답마다 새 값과 같은 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절).

#증상의심 원인구분확인 자료판정 기준(근거)
1script-src-attr 보고가 대부분템플릿의 onclick 같은 이벤트 속성속성보고 documentURL · 템플릿 검색우리 템플릿이면 외부 파일로 옮김 · 'unsafe-hashes' 는 마지막 수단(6.8.3 · 8.3절)
2script-src-elem · blockedURL inlinenonce 누락 또는 해시 갱신 누락요소응답 헤더의 값 ↔ 빌드가 계산한 해시값이 다르면 빌드 · 배포 순서 문제(8.4절)
3로더가 넣은 스크립트만 막힘'strict-dynamic' 없음 · 파서가 넣은 요소요소정책 문자열 · 로더가 요소를 넣는 방식'strict-dynamic' 이 있고 createElement 로 넣으면 허용(8.2절)
4정책을 넣었는데 프레임 삽입이 됨frame-ancestors 를 meta 요소로 전달탐색응답 헤더 ↔ HTML metameta 의 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시험 대비

출제 정보 정보관리(129회)문제 원문 — 큐넷 자료실 「기출문제(기술사)」 www.q-net.or.kr

시험에서는 지시어 · 원본 표현 · 위반 보고를 묻는 정의 · 특징형과 기존 사이트에 정책을 들이는 순서를 묻는 구현 · 설계형이 나올 수 있다. 유형 · 출력 인코딩은 XSS 가 맡는다.

답안 목차
  1. 개요 — 정의 · W3C CSP Level 3(작업 초안) · Level 2(권고 2016) · 클라우드 서비스 제공자와 구분 · 출력 인코딩 뒤의 추가 방어
  2. 구조 — 그림 3 정책 전달 구조(헤더 셋 · 처분 둘 · 지시어 네 분류) + 지시어 표(default-src · script-src · object-src · base-uri · frame-ancestors · report-to)
  3. 판정 원리 — 그림 5 판정 흐름(대체 순서 · nonce · hash 가 'unsafe-inline' 을 끔 · 'strict-dynamic')
  4. 방식 비교 — 허용 목록 · nonce · hash 비교표 + 우회 비율 94.72% · 75.81%(CCS 2016)
  5. 도입 절차 — 그림 4 순서도(해시 계산 → Report-Only → 보고 분류 → 코드 정리 → 강제) + 보고 필드 effectiveDirective · sourceFile
  6. 한계와 보완 — 출력 인코딩이 먼저 · 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-srcobject · embed 플러그인'none'정책 작성자헤더 · meta
base-uribase 요소의 기준 주소'none' · 'self'정책 작성자헤더 · meta
frame-ancestors이 페이지를 넣는 상위 프레임'none' · 'self'정책 작성자헤더만
nonce값이 없는 인라인 · 외부 스크립트응답마다 128비트 이상응답을 만드는 서버헤더 + script 속성
hash내용이 바뀐 인라인 스크립트sha256 · sha384 · sha512페이지를 만드는 빌드헤더
Report-Only막지 않고 보고만처분 report도입 담당헤더만
report-to보고를 보낼 곳끝점 이름서버헤더 + Reporting-Endpoints

11참고 문헌

  1. 먼저 볼 문헌
  2. ★ Content Security Policy Level 3 (W3C Working Draft) — 지시어 대체 순서 · 인라인 판정 알고리즘 · Strict CSP 예시를 원문으로 볼 때
    W3C · 2026-10 · www.w3.org/TR/CSP3/ · 확인 2026-11-04
  3. ★ 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' 이 나온 배경을 볼 때
    Google · 2016-10 · research.google.com/pubs/archive/45542.pdf · 확인 2026-11-04
  4. ★ Reporting API (W3C Working Draft) — Reporting-Endpoints 헤더와 보고 전송 형식을 볼 때
    W3C · 2025-06 · www.w3.org/TR/reporting-1/ · 확인 2026-11-04
  5. ★ Content Security Policy Cheat Sheet — 정책 전달 방법 세 가지와 nonce · hash 정책 예시를 볼 때
    OWASP · 2026-11 · cheatsheetseries.owasp.org/cheatsheets/Content_Security_Policy_Cheat_Sheet.html · 확인 2026-11-04
  6. 본문 근거
  7. Content Security Policy Level 2 (W3C Recommendation) — W3C · 2016-12 · www.w3.org/TR/CSP2/ · 확인 2026-11-04
  8. Content Security Policy 1.0 (W3C Working Group Note · 2012-11 Candidate Recommendation) — W3C · 2015-02 · www.w3.org/TR/CSP1/ · 확인 2026-11-04
  9. RFC 2606 Reserved Top Level DNS Names — IETF · 1999-06 · www.rfc-editor.org/rfc/rfc2606 · 확인 2026-11-04