문단속내 사이트 보안 자가점검

가이드 · 보안 헤더

콘텐츠 보안 정책 (CSP)

무엇을 보나요

페이지가 어디서 스크립트·스타일·틀(iframe)을 불러올 수 있는지 제한하는 헤더가 있는지 봅니다.

왜 위험한가요

게시판 등에 악성 스크립트가 끼어드는 공격(XSS)이 성공해도, CSP가 있으면 피해 범위를 크게 줄일 수 있습니다.

어떻게 고치나요

먼저, 내 사이트는 어디에 해당하나요?

아래 방법 중 내 경우에 맞는 하나만 하면 됩니다. 모두 할 필요는 없습니다.

카페24·아임웹·식스샵·윅스 같은 쇼핑몰·홈페이지 제작 서비스대부분 직접 바꿀 수 없습니다. 서비스 고객센터에 아래 '요청 문구'를 보내세요. 일부 서비스는 관리자 화면의 '보안 설정'이나 'HTTPS 설정' 메뉴에서 켤 수 있습니다.
웹호스팅에 그누보드·워드프레스 등을 설치 (FTP로 파일을 올림)아래 Apache(.htaccess) 방법을 먼저 해 보고, 막히면 PHP·그누보드5 방법을 씁니다. 윈도우 호스팅이면 IIS입니다.
서버를 직접 운영 (SSH로 접속)쓰는 웹서버에 맞는 방법(Apache, Nginx, Caddy)을 씁니다. 모르면 서버에서 systemctl is-active nginx apache2 httpd caddy를 실행해 active로 나오는 것을 보세요.
외주 업체·관리 업체가 관리직접 고치지 말고 아래 '요청 문구'를 업체에 보내세요.

Apache (사이트 설정 또는 .htaccess)

<IfModule mod_headers.c>
    Header always set Content-Security-Policy "object-src 'none'; base-uri 'self'; frame-ancestors 'self'"
</IfModule>
처음이라면: 이 코드를 어디에, 어떻게 넣나요?

이런 경우에 씁니다: 웹호스팅(FTP로 파일을 올리는 곳: 카페24 웹호스팅, 가비아, 닷홈, 호스팅케이알 등)이거나, 서버에 Apache를 설치해 쓰는 경우

  1. 웹호스팅이라면 .htaccess 파일에 넣습니다. FTP 프로그램(파일질라 등)이나 호스팅 관리 화면의 '파일 관리자'로 접속합니다.
  2. 웹 폴더(이름이 public_html, www, html 중 하나이고 index.php나 index.html이 들어 있는 곳)를 엽니다.
  3. 그 안의 .htaccess 파일을 내 PC로 내려받아 복사본을 하나 만들어 둡니다(문제가 생기면 이걸로 되돌립니다). 파일이 없으면 메모장으로 새로 만들면 됩니다.
  4. 메모장으로 열어 맨 아래에 위 코드를 그대로 붙여 넣고 저장합니다(인코딩은 UTF-8).
  5. 다시 같은 자리에 올리고, 브라우저로 사이트가 잘 열리는지 확인합니다.
  6. 서버를 직접 운영한다면 사이트 설정 파일(Ubuntu: /etc/apache2/sites-available/사이트.conf, RHEL 계열: /etc/httpd/conf.d/사이트.conf)의 <VirtualHost> 안에 넣고, sudo apachectl configtest로 문법을 검사한 뒤 sudo systemctl reload apache2(RHEL: httpd)로 적용합니다.

잘 안 되면 저장 뒤 사이트에 '500 Internal Server Error'가 나오면 호스팅이 이 설정을 막아 둔 것입니다. 당황하지 말고 백업해 둔 .htaccess를 다시 올리면 바로 원래대로 돌아옵니다. 그다음 아래 'PHP' 방법을 쓰거나 호스팅사에 요청하세요. 윈도우 탐색기에서는 점(.)으로 시작하는 파일이 안 보일 수 있어 FTP 프로그램에서 작업하는 편이 쉽습니다.

Nginx (server 블록)

add_header Content-Security-Policy "object-src 'none'; base-uri 'self'; frame-ancestors 'self'" always;
처음이라면: 이 코드를 어디에, 어떻게 넣나요?

이런 경우에 씁니다: 서버에 직접 접속(SSH)해서 Nginx를 쓰는 경우

  1. 서버에 SSH로 접속합니다.
  2. 내 사이트 설정 파일을 찾습니다: sudo grep -rl "server_name" /etc/nginx/ 결과 중 내 도메인이 들어 있는 파일입니다(보통 /etc/nginx/sites-available/ 또는 /etc/nginx/conf.d/ 안).
  3. 바꾸기 전에 복사본을 만듭니다: sudo cp 파일 파일.bak
  4. 파일을 열어(sudo nano 파일) server { 로 시작하는 블록 안, server_name 줄 아래에 위 코드를 넣습니다. HTTPS를 쓴다면 listen 443이 있는 블록에 넣어야 합니다.
  5. 문법 검사: sudo nginx -t — 'syntax is ok'가 나올 때만 다음으로 갑니다.
  6. 적용: sudo systemctl reload nginx

잘 안 되면 nginx -t에서 오류가 나면 적용하지 말고 복사본으로 되돌리세요: sudo cp 파일.bak 파일. reload는 접속 중인 방문자를 끊지 않습니다.

IIS (web.config)

<configuration>
  <system.webServer>
    <httpProtocol>
      <customHeaders>
        <add name="Content-Security-Policy" value="object-src 'none'; base-uri 'self'; frame-ancestors 'self'" />
      </customHeaders>
    </httpProtocol>
  </system.webServer>
</configuration>
처음이라면: 이 코드를 어디에, 어떻게 넣나요?

이런 경우에 씁니다: 윈도우 서버(IIS)나 윈도우 웹호스팅(ASP, ASP.NET 사이트)인 경우

  1. 사이트 폴더(웹 폴더) 맨 위에 있는 web.config 파일을 찾습니다. FTP나 원격 데스크톱으로 접속합니다.
  2. 복사본을 먼저 만듭니다.
  3. web.config가 이미 있다면 통째로 덮어쓰지 마세요. 위 코드에서 <add name=… /> 한 줄만, 파일 안의 <customHeaders> 안에 넣습니다. customHeaders가 없다면 <system.webServer> 안에 위 코드의 <httpProtocol> 부분을 넣습니다.
  4. 파일이 없다면 위 코드 전체로 새로 만들면 됩니다.
  5. 저장하면 바로 적용됩니다. 사이트가 잘 열리는지 확인합니다.

잘 안 되면 IIS 관리자 프로그램의 사이트 → 'HTTP 응답 헤더' 메뉴에서 [추가]로 이름과 값을 넣어도 같은 결과입니다. 사이트가 500 오류를 내면 복사본으로 되돌리세요.

Caddy (사이트 블록)

header Content-Security-Policy "object-src 'none'; base-uri 'self'; frame-ancestors 'self'"
처음이라면: 이 코드를 어디에, 어떻게 넣나요?

이런 경우에 씁니다: 서버에서 Caddy를 쓰는 경우

  1. 서버에 SSH로 접속해 /etc/caddy/Caddyfile을 엽니다. 먼저 복사본: sudo cp /etc/caddy/Caddyfile /etc/caddy/Caddyfile.bak
  2. 내 사이트 주소로 시작하는 블록(example.com { … }) 안에 위 줄을 넣습니다.
  3. 검사: sudo caddy validate --config /etc/caddy/Caddyfile
  4. 적용: sudo systemctl reload caddy

PHP·그누보드5 (웹서버 설정을 바꿀 수 없을 때)

<?php
// 그누보드5: extend/security_headers.php 로 저장하면 모든 페이지에 적용됩니다.
// 다른 PHP 사이트: 모든 페이지가 불러오는 공통 파일 맨 위에 header() 줄만 넣습니다.
if (!defined('_GNUBOARD_')) exit;
header("Content-Security-Policy: object-src 'none'; base-uri 'self'; frame-ancestors 'self'");
처음이라면: 이 코드를 어디에, 어떻게 넣나요?

이런 경우에 씁니다: 웹호스팅이라 웹서버 설정은 못 바꾸지만 PHP 파일은 올릴 수 있는 경우 (그누보드5·영카트에 특히 쉬움)

  1. FTP 프로그램이나 호스팅 파일 관리자로 접속해 사이트 폴더를 엽니다.
  2. 그누보드5·영카트: extend 폴더 안에 위 코드를 담은 새 파일(예: security_headers.php)을 올립니다. 이 폴더의 파일은 모든 페이지에서 자동으로 읽힙니다. 이미 같은 이름의 파일이 있다면 header(…) 줄만 그 파일에 더합니다.
  3. 워드프레스: 이 코드 대신 관리자 화면 → 플러그인 → 새로 추가에서 'security headers'로 검색해 보안 헤더 플러그인을 쓰는 편이 안전합니다(테마를 바꿔도 유지됩니다).
  4. 그 밖의 PHP 사이트: 모든 페이지가 맨 처음 불러오는 공통 파일(보통 config.php, common.php, header.php) 맨 위 <?php 바로 아래에 header(…) 줄만 넣습니다.
  5. 메모장으로 저장할 때 인코딩은 UTF-8(BOM 없이)로 합니다. 사이트가 잘 열리는지 확인합니다.

잘 안 되면 화면이 하얗게 나오면 방금 올린 파일을 지우거나 원래 파일로 되돌리면 바로 복구됩니다. 파일 앞에 빈 줄이나 BOM이 있으면 'headers already sent' 오류가 날 수 있습니다.

위 값은 기존 사이트를 거의 깨뜨리지 않는 시작점입니다. 다음 단계로 script-src를 제한하려면, 먼저 Content-Security-Policy-Report-Only 헤더로 같은 정책을 걸어 브라우저 개발자 도구 콘솔에서 무엇이 막히는지 확인한 뒤 적용하세요. 광고·분석 스크립트를 쓰는 사이트는 그 도메인을 허용 목록에 넣어야 합니다. Nginx는 location 블록 안에 add_header가 하나라도 있으면 server 블록의 add_header를 물려받지 않습니다. 헤더가 안 붙으면 location 블록에도 같은 줄을 넣으세요. 설정을 바꾼 뒤에는 문법 검사(apachectl configtest, nginx -t) 후 다시 불러오세요.

직접 고치기 어렵다면: 호스팅사·관리 업체에 보낼 요청 문구

상자를 한 번 누르면 전체가 선택됩니다. 복사해서 주소만 채워 보내세요.

안녕하세요. 저희 사이트(주소: ____________)를 보안 점검 도구 '문단속'으로 확인해 보니 '콘텐츠 보안 정책 (CSP)' 항목을 고치라는 안내가 나왔습니다.
점검 내용: 페이지가 어디서 스크립트·스타일·틀(iframe)을 불러올 수 있는지 제한하는 헤더가 있는지 봅니다.
번거로우시겠지만 이 설정을 적용해 주실 수 있을까요? 웹서버별 설정 방법은 아래 페이지에 정리돼 있습니다.
https://mundansok.kr/guide/csp
감사합니다.
고친 뒤 확인하기 문단속 첫 화면에 주소를 넣으면 소유 확인 없이 바로 다시 확인할 수 있습니다. 이 항목이 '양호'로 바뀌면 끝입니다. CDN(클라우드플레어 등)을 쓴다면 캐시 때문에 몇 분 늦게 반영될 수 있습니다. 고친 뒤 사이트의 첫 화면, 로그인, 글쓰기 같은 주요 기능이 정상인지도 꼭 눌러 보세요. 이상하면 백업해 둔 파일로 되돌리면 됩니다.

무엇이든 바꾸기 전에는 원래 파일을 복사해 두세요. 문제가 생기면 그 파일로 되돌리면 바로 원래대로 돌아옵니다.