콘텐츠 보안 정책(CSP): 귀하의 웹사이트에서 확인, 수정 및 구성하는 방법
Apache, Nginx, WordPress 및 Joomla에서 콘텐츠 보안 정책 헤더를 확인, 추가 및 수정하는 방법을 실용적인 진단 도구와 호스팅 가이드를 통해 배워보세요.
콘텐츠 보안 정책 (CSP): 웹사이트에서 확인, 수정 및 구성 방법
HTTPS와 소프트웨어 업데이트는 필수적이지만, 모든 악성 스크립트가 방문자의 브라우저에서 실행되는 것을 방지하지는 않습니다. 콘텐츠 보안 정책(CSP)은 페이지가 로드하고 실행할 수 있는 리소스에 대해 브라우저에서 강제하는 제한을 추가합니다. 이는 특정 크로스 사이트 스크립팅(XSS) 공격을 완화하는 데 도움이 되지만, 맥락적 출력 이스케이프, 입력 검증 또는 의존성 업데이트를 대체하지는 않습니다.
이 실용적인 튜토리얼은 현재 정책을 검사하고, 출처를 찾고, 변경 사항을 안전하게 도입하며, Apache, Nginx, WordPress 및 Joomla에서 문제를 해결하는 방법을 보여줍니다.
1. 기존 CSP 확인
Chrome 또는 Firefox: 페이지를 열고 F12를 누르고 Network를 선택한 다음, 다시 로드하고 HTML 문서를 클릭하고 Response Headers를 검사합니다. Content-Security-Policy(강제됨) 또는 Content-Security-Policy-Report-Only(진단 전용)를 찾습니다. 위반 사항은 콘솔에서 확인합니다.
명령줄: curl -I https://example.com/를 실행합니다. macOS/Linux에서 curl -sSI https://example.com/ | grep -i content-security-policy로 응답을 필터합니다. HEAD 응답은 GET 응답과 다를 수 있으므로 브라우저 DevTools를 사용하여 확인합니다.
온라인 도구: SecurityHeaders.com는 보안 헤더를 확인하고; Google CSP Evaluator는 정책의 취약점을 표시합니다. 둘 다 전체 웹사이트가 안전하다는 것을 증명하지는 않습니다.
한 응답에 CSP 헤더가 없어도 모든 페이지에 CSP가 없다는 것을 의미하지 않습니다. 또한 <meta http-equiv="Content-Security-Policy"> 태그를 확인하세요: meta 정책에는 frame-ancestors 또는 Report-Only를 지원하지 않는 등의 제한이 있습니다.
2. 정책이 정의된 위치 찾기
| 환경 | 예상 위치 |
|---|---|
| Apache / 호환 LiteSpeed | .htaccess, 가상 호스트 또는 서버 구성 |
| Nginx | server / location 구성 |
| PHP | header()를 사용하는 애플리케이션 코드 |
| WordPress | 플러그인, 사용자 지정 코드, 리버스 프록시 또는 호스트 |
| Joomla | System – HTTP Headers 플러그인, 서버 또는 프록시 |
| Cloudflare | 응답 헤더 변환 규칙 |
| 관리형 호스팅 | 호스팅 패널 또는 제공자 관리 구성 |
다른 CSP를 추가하기 전에 먼저 기존 응답 헤더를 확인하세요. 브라우저는 여러 CSP 정책을 누적하여 적용하며, 새로운 허용적인 헤더가 기존에 제한적인 헤더를 취소하지 않습니다. CDN 및 호스팅 규칙도 확인하세요.
3. .htaccess를 사용한 Apache에 CSP 추가
호스트의 파일 관리자 또는 SFTP(FileZilla/WinSCP)를 사용하고, index.php가 포함된 공개 디렉터리를 찾습니다. 일반적으로 public_html 또는 httpdocs입니다. 숨겨진 파일(가)을 활성화하여 .htaccess를 확인하세요. 백업을 다운로드하고, CMS 관리형 재작성 블록 안에 사용자 지정 규칙을 두지 마세요.
Apache의 mod_headers가 활성화되어 있고 호스트가 이러한 지시문을 허용하면 다음을 추가하세요:
<IfModule mod_headers.c>
Header always set Content-Security-Policy-Report-Only "default-src 'self'; script-src 'self'; object-src 'none'; base-uri 'self'"
</IfModule>
Network → Headers 아래에서 헤더를 다시 로드하고 확인하세요. 위반 사항은 콘솔에서 확인하세요. Report-Only는 가능한 제한을 보고하지만 리소스를 차단하지 않습니다. 이 예시는 진단용이며 완전한 배포 정책이 아닙니다.
신뢰할 수 있는 CDN 스크립트가 차단되었다고 보고되면 먼저 목적과 소유권을 확인하세요. 지시문을 script-src 'self' https://cdn.example.com에 맞게 조정할 수 있습니다. 모든 차단된 호스트를 무조건 추가하지 마세요. 호스트 허용 목록은 잘 설계된 nonce/해시 정책보다 XSS에 취약한 경우가 많습니다.
로그인, 양식, 결제, 에디터 및 기타 워크플로우를 테스트한 후, tested한 정책을 적용하려면 Content-Security-Policy-Report-Only을 Content-Security-Policy로 교체할 수 있습니다. 사이트가 깨지면 백업된 파일을 복원하고, 서버/CDN 캐시를 지우고 다시 테스트하세요. 편집 후 HTTP 500이 발생하면 구문 또는 서버 권한 문제가 있는 것입니다.

4. Nginx에서 CSP 구성
Nginx는 .htaccess를 무시합니다. 서버를 관리한다면 활성 구성을 확인하세요(종종 /etc/nginx/sites-available/ 또는 /etc/nginx/conf.d/). 관련 server 블록에서 다음을 사용하세요:
add_header Content-Security-Policy-Report-Only "default-src 'self'; script-src 'self'; object-src 'none'; base-uri 'self'" always;
sudo nginx -t로 테스트한 다음, sudo systemctl reload nginx로 다시 로드하세요. add_header 상속과 더 구체적인 위치의 규칙을 주의하세요. Nginx 구성에 접근할 수 없는 관리형 호스팅에서는 제공자의 컨트롤 패널이나 지원을 사용하세요.
5. WordPress: 플러그인 또는 소규모 사용자 지정 통합
No-code 방법: 먼저 호스트 또는 기존 보안 헤더 플러그인이 이미 CSP를 전송하는지 확인하세요. CSP를 명시적으로 지원하고 가능한 한 Report-Only를 지원하는 유지 관리 중인 플러그인을 선택하세요. 일반 보안 플러그인이 둘 중 하나를 지원한다고 가정하지 마세요. 설정에서 Report-Only를 활성화하고, 보수적인 진단 정책으로 시작한 다음 저장하고, 적용 전에 공개 페이지와 wp-admin을 모두 테스트하세요.
개발자 방법: wp-content/plugins/ceikay-csp/ceikay-csp.php를 생성하세요:
<?php
/**
* Plugin Name: CeiKay CSP Example
* Description: CSP diagnostics on the WordPress frontend.
*/
add_action('send_headers', function () {
if (is_admin()) {
return;
}
header(
"Content-Security-Policy-Report-Only: "
. "default-src 'self'; "
. "script-src 'self'; "
. "object-src 'none'; "
. "base-uri 'self'"
);
});
Plugins → Installed Plugins에서 활성화한 다음 응답 헤더를 확인하세요. 이는 웹 서버, CDN 또는 다른 플러그인의 기존 CSP를 재정의하지 않습니다. 의도적으로 wp-admin을 제외하며 완전한 적용 정책을 제공하지 않습니다.
문제 해결: CAPTCHA가 실패하면 차단된 script-src, frame-src 및 connect-src 요청을 검사하고 CAPTCHA 제공자의 통합 가이드를 참조하세요. 페이지 빌더가 차단된 인라인 스크립트를 보고하면 CSP nonce 또는 해시 지원 여부를 확인하세요. 'unsafe-inline'를 자동으로 추가하지 마세요. 응답별 nonce의 경우, 전체 페이지 캐싱이 방문자 간에 동일한 nonce와 HTML을 재사용하지 않도록 하세요.
6. Joomla: 네이티브 HTTP Headers 플러그인 사용
Joomla 관리에서 System → Plugins를 열고 HTTP Headers를 검색한 다음 System – HTTP Headers를 엽니다. 정확한 메뉴 문구는 Joomla 버전과 언어에 따라 다를 수 있습니다.
CSP 옵션을 활성화하고 공개 사이트에서 Report-Only로 시작하세요. script-src 'self'와 같은 지시문을 진단으로 시작하고 저장한 다음 콘솔을 확인하세요. 템플릿, 페이지 빌더, 에디터, 문의 양식, CAPTCHA, 결제 통합 및 미디어 기능을 테스트하세요.
Refused to execute inline script를 확인하면 어떤 템플릿 또는 확장 프로그램이 생성하는지 식별하세요. 지원되는 경우 호환되는 nonce 또는 해시 방식을 선호하세요. 승인하기 전에 스크립트가 합법적인지 확인하세요. 관리자 측을 프론트엔드와 별도로 테스트하세요. 서버가 이미 CSP를 설정하고 있다면, 충돌하는 정책을 쌓는 대신 구성을 조정하세요.
설치된 버전에서 지원하는 옵션은 Joomla HTTP Headers 문서를 참조하세요.
7. 전체 정책이 아닌 실제 위반 수정
| 위반 | 조사할 사항 | 일반적인 수정 |
|---|---|---|
script-src |
외부 또는 인라인 JavaScript | 출처 확인; 적절한 nonce/hash 또는 좁은 범위 source 사용 |
style-src |
Stylesheet 또는 인라인 CSS | 생성된 스타일 검사; 승인된 source 또는 호환되는 hash/nonce 사용 |
img-src |
외부 이미지 또는 data URL | 필요한 경우에만 확인된 이미지 호스트 허용 |
connect-src |
fetch/XHR/WebSocket | API origin 확인 및 좁은 범위 권한 추가 |
frame-src |
임베디드 비디오/CAPTCHA/결제 프레임 | 제공자가 문서화한 도메인 따르기 |
form-action |
Form 제출 대상 | 합법적인 제출 origin 허용 |
frame-ancestors |
페이지를 포함하는 다른 사이트 | 의도된 parent origin 명시적으로 허용 또는 'none' 사용 |
예를 들어, https://images.example.com/photo.webp의 합법적인 이미지가 img-src 'self'에 의해 차단된 경우, 해당 호스트가 신뢰 가능함을 확인한 후 관련 지시문을 img-src 'self' https://images.example.com로 변경하세요. 하나의 이미지를 수정하기 위해 default-src를 약화시키지 마세요.

일부 지시문은 frame-ancestors 및 form-action을 포함하지만 default-src으로 대체되지 않습니다. 필요할 때 명시적으로 포함하세요.
8. 호스팅이 CSP 구성에 영향을 미나는가?
네—CSP 브라우저 표준은 동일하게 유지되지만, 응답 헤더에 대한 제어가 변경될 수 있습니다. Apache 공유 호스팅은 .htaccess를 노출할 수 있고, 관리형 Nginx는 제공자 패널이 필요할 수 있으며, VPS 관리자는 서버 구성을 수정할 수 있고, CDN는 애플리케이션이 응답을 생성한 후 헤더를 추가할 수 있습니다.
호스팅 서비스를 선택하기 전에 질문하세요: 루트 접근 권한 없이 CSP 헤더를 설정하고 제거할 수 있나요? Report-Only를 사용할 수 있나요? 최종 응답을 확인할 수 있나요? 내 플랜에서 사용자 지정 헤더를 사용할 수 있나요? 지원팀이 CDN 또는 애플리케이션 규칙과의 충돌을 설명할 수 있나요?
Cloudways: 호스팅 수준 HTTP 헤더 제어
Cloudways는 CSP를 포함한 HTTP 응답 헤더를 관리하기 위해 Web Rules → Header Rules를 문서화합니다. 이는 애플리케이션 파일 편집 수준의 대안이지만, 사용 가능한 애플리케이션 및 플랜 기능에 따라 제한됩니다. 이는 안전한 CSP를 자동으로 생성하지 않으며, 지시문을 여전히 테스트하고 유지해야 합니다.
9. nonce 기반 CSP로 더 강력한 보호
강력한 CSP는 도메인 허용 목록에만 의존하는 대신 예측 불가능한 nonce 또는 해시를 사용합니다. 간단한 PHP 예시입니다:
<?php
$nonce = base64_encode(random_bytes(16));
header(
"Content-Security-Policy: "
. "script-src 'nonce-{$nonce}' 'strict-dynamic'; "
. "object-src 'none'; "
. "base-uri 'none'"
);
HTML 템플릿에서:
<script nonce="<?= htmlspecialchars($nonce, ENT_QUOTES, 'UTF-8') ?>">
console.log('Trusted script');
</script>
각 응답에 새로운 예측 불가능한 nonce를 생성하세요. 헤더와 HTML nonce를 일관되게 유지하고, 리버스 프록시 및 전체 페이지 캐시를 고려하세요. 'strict-dynamic'의 경우 신뢰할 수 있는 스크립트가 더 많은 스크립트를 로드할 수 있으므로 신뢰할 수 있는 로더를 신중하게 감사하세요. 이것은 모든 애플리케이션에 완전한 정책을 적용하는 삽입형 설명이 아니라 설명입니다.
10. 최종 배포 체크리스트
- 모든 기존 CSP 헤더와 meta 정책을 식별하세요.
- 서버 및 CMS 구성을 백업하세요.
- 스크립트, 스타일, 프레임, API, 이미지 및 외부 서비스를 목록으로 파악하세요.
- Report-Only 정책을 먼저 배포하세요.
- 모든 위반을 조사하고 신뢰할 수 있고 필요한 동작만 승인하세요.
- 프론트엔드, 관리자, 로그인, 결제, 양식 및 통합을 테스트하세요.
- 캐싱, nonce, CDN 동작 및 중복 헤더를 확인하세요.
- 적용을 점진적으로 활성화하고 소프트웨어 업데이트 후 모니터링하세요.
결론
유용한 CSP는 단순히 체크리스트에서 복사한 헤더가 아닙니다. 현재 구성을 검사하고, 정의된 위치를 찾고, Report-Only 모드로 테스트하며, 정확한 호환성 문제를 수정한 후에야 웹사이트에 적합한 정책을 적용하세요. WordPress 및 Joomla 관리자는 CMS 도구로 시작할 수 있고, 개발자는 Apache, Nginx 또는 PHP를 사용할 수 있으며, 호스팅 플랫폼은 직접 헤더 제어를 제공할 수 있습니다.
CSP는 공격 기회를 줄이지만, 안전한 코딩, 업데이트, 인증 및 모니터링과 함께 하나의 계층으로 남습니다.