CSP 헤더 생성기
지시문, 해시, nonce로부터 Content-Security-Policy 헤더 구축. 엄격 모드 템플릿과 Report-Only 디버그 모드, Express / Nginx 스니펫 지원. 브라우저에서 처리.
- 브라우저에서 처리
- 도구 입력을 ZeroTool 서버에 업로드하지 않습니다
- 무료 · 회원가입 불필요
WeChat으로 스캔하여 공유
예시·자세한 설명·자주 묻는 질문 실제 출력이 있는 예시, 다른 도구와의 차이, 자주 묻는 질문.
Strict CSP 시작 구성
Strict 프리셋은 web.dev에서 설명하는 nonce 기반 strict CSP를 따릅니다. HTTP 헤더 탭의 출력은 다음과 같습니다.
Content-Security-Policy: default-src 'self'; script-src 'nonce-{RANDOM}' 'strict-dynamic'; style-src 'self'; img-src 'self' data:; font-src 'self'; connect-src 'self'; object-src 'none'; base-uri 'self'; form-action 'self'; frame-ancestors 'none'; upgrade-insecure-requests
'nonce-{RANDOM}'는 자리표시자이며 그대로는 쓸 수 없습니다. 서버가 응답마다 128비트 이상의 새 무작위 값으로 바꾸고, 렌더링하는 각 <script>의 nonce="…"에 같은 값을 써야 합니다. 정책에 자리표시자가 남아 있는 동안 도구는 경고를 표시합니다. 고정된 nonce 하나를 정적 설정에 붙여 넣지 마세요. 한 번 본 사람은 누구나 주입한 스크립트에서 다시 쓸 수 있습니다.
이전 버전의 이 프리셋은 'self'를 썼지만 자리표시자로 바꿨습니다. 'strict-dynamic'이 있으면 CSP Level 3은 일치하는 nonce나 해시가 없는 한 HTML 파서가 삽입한 스크립트를 모두 차단하고, 'self'와 호스트 소스는 더 이상 확인하지 않습니다(CSP3 §8.2). 그래서 script-src 'self' 'strict-dynamic'만으로는 현재 Chrome, Firefox, Safari에서 스크립트가 하나도 실행되지 않으며, 도구는 이제 이 조합에 경고를 띄웁니다. nonce를 설정할 수 없는 정적 빌드 사이트라면 자리표시자를 지우고 해시 계산기로 인라인 스크립트마다 해시를 추가하거나, '중간' 프리셋에서 시작하세요.
Express (helmet) 탭은 응답마다 값을 만드는 부분까지 출력합니다. crypto.randomBytes(16).toString('base64')를 res.locals.cspNonce에 저장하는 미들웨어를 추가하고 script-src에 함수를 넘기는데, helmet README에 나오는 방식입니다. 템플릿에서는 이 값을 각 script 태그에 출력해야 합니다. Nginx 탭은 자리표시자를 그대로 두고 주석을 붙입니다. Nginx는 애플리케이션이 렌더링하는 HTML에 같은 nonce를 넣을 수 없기 때문입니다.
카카오 JavaScript SDK를 쓰는 페이지
카카오디벨로퍼스 문서의 JavaScript 시작하기 페이지는 https://t1.kakaocdn.net/kakao_js_sdk/ 아래의 kakao.min.js를 script 태그로 넣은 뒤, 인라인 스크립트에서 Kakao.init()을 부르는 예제를 보여 줍니다. 이 구성을 CSP에 옮기려면 두 가지가 필요합니다. SDK 파일이 있는 호스트를 허용하는 것과, 인라인 초기화 코드를 해시로 허용하는 것입니다.
'중간' 프리셋을 고르고 script-src에 https://t1.kakaocdn.net을 넣습니다. 이어서 해시 계산기에 아래 한 줄을 붙여 넣고 '계산 후 추가'를 누릅니다(예제에서는 앱 키를 JAVASCRIPT_KEY로 적었습니다. 실제 키를 넣으면 해시도 바뀝니다).
Kakao.init("JAVASCRIPT_KEY");
Content-Security-Policy: default-src 'self'; script-src 'self' https://t1.kakaocdn.net 'sha256-bP8OujdNYRJwn379Gq4TPz8e1ii8EsssrENxVJsA3kY='; style-src 'self' 'unsafe-inline'; img-src 'self' data: https:; font-src 'self' data:; connect-src 'self'; object-src 'none'; base-uri 'self'; frame-ancestors 'self'; upgrade-insecure-requests
해시는 script 태그 사이의 텍스트와 한 글자도 다르지 않아야 합니다. 예제처럼 Kakao.init() 아래에 console.log(Kakao.isInitialized()) 같은 줄을 더 두면, 그 줄까지 포함한 전체 텍스트로 다시 계산하세요. SDK가 실행된 뒤 어떤 호스트에 요청을 보내는지는 이 도구가 알 수 없으니, Report-Only로 먼저 배포해 보고서에서 차단될 요청을 확인하세요.
한글 도메인은 punycode로
CSP Level 3 문법에서 호스트 이름에 쓸 수 있는 문자는 ASCII 영문자, 숫자, 하이픈뿐입니다(§2.3.1). 도구에 한글 도메인을 입력하면 브라우저의 URL 해석 규칙대로 xn-- 형식으로 바꾸고, 상태 줄에 바꾼 값을 보여 줍니다. Strict 프리셋의 connect-src에 https://한국인터넷진흥원.한국을 넣은 결과입니다.
Content-Security-Policy: default-src 'self'; script-src 'nonce-{RANDOM}' 'strict-dynamic'; style-src 'self'; img-src 'self' data:; font-src 'self'; connect-src 'self' https://xn--3e0bx5e6xzftae3gxzpskhile.xn--3e0b707e; object-src 'none'; base-uri 'self'; form-action 'self'; frame-ancestors 'none'; upgrade-insecure-requests
흔한 함정
'none'은 단독으로만 효과가 있습니다. 다른 소스와 함께 적으면'none'은 효과가 없고 다른 소스는 허용됩니다.- HTTP 헤더 전용 지시문이 있습니다. CSP3 §3.3에 따라
<meta>안의frame-ancestors,report-uri,sandbox는 무시되고 Report-Only 모드도 없습니다. 도구는<meta>탭에서 이들을 빼고 경고합니다. 'strict-dynamic'에는 nonce나 해시가 필요합니다. 없으면 페이지의 스크립트가 모두 차단되며, 도구가 이를 알려 줍니다.- 해시/nonce가 있으면
'unsafe-inline'은 무시됩니다. 최신 브라우저는 더 안전한 쪽을 우선합니다. default-src는 반드시 정의하세요. 누락된 fetch 지시문은default-src로 폴백하며, 이것이 없으면 새로 추가될 지시문에도 폴백이 적용되지 않습니다.- 커스텀 호스트에 세미콜론을 넣지 마세요. 세미콜론은 정책을 끊어 이후 모든 지시문을 손상시킵니다.
해시 vs. Nonce
정적 인라인 콘텐츠(애널리틱스 스니펫, 크리티컬 CSS, 서버 렌더링되는 보조 스크립트)에는 해시를 사용합니다. 정적 HTML과 엣지 캐시와 잘 맞고, 요청별 값을 필요로 하지 않습니다.
요청마다 새로 렌더링되는 콘텐츠에는 nonce를 사용합니다. 서버가 헤더에 'nonce-XYZ'를 넣고, 동일한 값을 모든 <script nonce="XYZ">에 새깁니다. 'strict-dynamic'과 함께 사용하면 신뢰된 스크립트의 자식 스크립트도 신뢰가 상속돼 거대한 호스트 허용 목록을 유지할 필요가 없습니다.
배포 치트시트
- Nginx: Nginx 탭 내용을
server블록에 붙여넣고 reload.always플래그는 오류 응답에도 헤더를 강제합니다. - Apache:
.htaccess나httpd.conf에Header always set Content-Security-Policy "..."를 작성합니다. - Express / Node: helmet 스니펫을 붙여 넣습니다. 스니펫에는 이미
useDefaults: false가 들어 있습니다. 지우면 helmet 기본 지시문이 정책에 더해지므로 그대로 두세요. - Cloudflare Pages / Vercel / Netlify: HTTP 헤더 형식을 각 플랫폼의 헤더 설정(
_headers,vercel.json,netlify.toml)에 붙여넣습니다.
도구의 한계
- 정책을 만들 뿐 검증하지는 않습니다. 사이트에 접속하거나 기존 헤더를 읽지 않으며, 외부 스크립트가 나중에 어떤 호스트를 불러오는지도 알지 못합니다.
- 소스 검사는 최소한입니다. 세미콜론을 거부하고, 공백으로 여러 소스를 나누고, ASCII가 아닌 호스트를 punycode로 바꾸는 것이 전부입니다.
https//cdn.example.com같은 오타는 그대로 정책에 들어갑니다. 호스트가 아닌 값은 바꾸지 않습니다.trusted-types정책 이름은 Trusted Types §4.2.2가 허용하는 문자만,sandbox토큰과report-to엔드포인트 이름은 ASCII만 쓸 수 있으며 그렇지 않으면 거부합니다. - 해시는 글자 그대로입니다. 브라우저는 스크립트나 스타일 텍스트를 UTF-8로 인코딩한 바이트로 해시를 비교합니다(CSP3 §6.7.3.3). 공백이나 줄바꿈 하나만 달라도 값이 달라집니다.
- nonce는 서버가 만들어야 합니다. 도구는
'nonce-{RANDOM}'자리표시자만 쓰며, 응답마다 값을 만드는 출력은 Express 탭뿐입니다. - 더 이상 쓰이지 않는 지시문.
prefetch-src와navigate-to는 2026년 9월 16일자 CSP3 초안에 없어 선택지에서 뺐습니다. 예전에 저장한 정책에 들어 있으면 페이지를 열 때 지우고 상태 줄에 한 번 알립니다.block-all-mixed-content스위치는 남겨 두었지만 Mixed Content §6.1에서 더 이상 쓰이지 않는다고 정한 지시문이라, 켜면 출력 아래에 안내를 표시합니다. - Report-Only에서 upgrade-insecure-requests는 동작하지 않습니다(Upgrade Insecure Requests §3.1). 도구는 Report-Only 헤더에도 그대로 출력하되, 출력 아래에 안내를 표시합니다.
FAQ
Content Security Policy란 무엇인가요?
CSP는 브라우저에 스크립트, 스타일, 이미지, 폰트, 프레임 등 신뢰할 수 있는 콘텐츠 출처를 알려 주는 HTTP 응답 헤더입니다. 출력 인코딩을 대신하지는 못하고, 주입이 뚫렸을 때 피해를 줄입니다. 예를 들어 맞는 nonce나 해시가 없는 주입 스크립트를 막고, frame-ancestors로 페이지를 iframe에 넣을 수 있는 곳을 제한합니다.
Enforce와 Report-Only 중 무엇을 먼저 배포해야 하나요?
`Content-Security-Policy-Report-Only`와 `report-uri`(또는 `report-to`) 엔드포인트로 시작해 실제 트래픽의 위반 보고를 보고 코드를 고친 다음, 강제형 `Content-Security-Policy`로 바꿉니다. `upgrade-insecure-requests`는 Report-Only 헤더에서는 동작하지 않으므로 강제 모드에서 확인하세요.
인라인 스크립트에 'unsafe-inline'이 꼭 필요한가요?
가능한 한 피하세요. 최신 CSP는 콘텐츠 기반 해시(`'sha256-...'`, `'sha384-...'`, `'sha512-...'`)와 요청별 nonce(`'nonce-...'`)를 지원합니다. 이 페이지의 해시 계산기로 특정 스니펫에 맞는 해시를 즉시 만들 수 있습니다.
'strict-dynamic'은 어떤 역할을 하나요?
nonce나 해시로 신뢰된 스크립트가 런타임에 다른 스크립트를 모든 CDN 호스트를 나열하지 않고도 로드할 수 있게 합니다. 모던 앱에서 권장되는 패턴이며, 자식 스크립트에 대해 호스트 기반 허용 목록을 무효화하고 일반적인 우회를 차단합니다.
생성된 헤더는 어디에 배포해야 하나요?
원본 서버에서 `Content-Security-Policy`를 전송하세요(Nginx `add_header`, Apache `Header set`, Cloudflare Transform Rules, Vercel `headers` 등). HTML `<meta http-equiv>` 형태는 정적 호스트용 대안입니다. CSP Level 3에서는 `<meta>` 안의 `frame-ancestors`, `report-uri`, `sandbox`가 무시되므로 도구는 그 탭에서 이들을 뺍니다. `report-to`는 `<meta>`에서도 동작하지만 엔드포인트는 `Reporting-Endpoints` 헤더로 정의합니다.
만든 정책이 전송되거나 저장되나요?
입력한 내용은 서버로 보내지 않습니다. 정책, 각 출력, 해시는 페이지 안에서 만들고 해시는 브라우저의 Web Crypto API로 계산합니다. 정책 자체(프리셋, 모드, 두 전송 스위치, 해시를 포함한 모든 지시문과 소스)는 이 브라우저의 localStorage에 저장되어 다음에 열 때 복원됩니다. Ctrl/⌘+L은 텍스트 입력과 계산한 해시를 지우지만 저장된 정책은 남깁니다. 해시 계산기의 텍스트는 저장하지 않습니다. 다른 도구 페이지처럼 Google Analytics와 AdSense를 불러오며, 정책을 바꿀 때마다 도구 이름과 동작만 담은 `generate` 이벤트를 한 번 기록하고 정책 내용은 기록하지 않습니다.