가이드 · 보안 헤더
Referrer-Policy
무엇을 보나요
다른 사이트로 이동할 때 현재 주소를 얼마나 알려줄지 정하는 헤더가 있는지 봅니다.
왜 위험한가요
주소에 회원 번호나 검색어, 임시 토큰이 들어 있으면 외부 사이트(광고, 링크된 사이트)에 그대로 전달될 수 있습니다.
어떻게 고치나요
먼저, 내 사이트는 어디에 해당하나요?
아래 방법 중 내 경우에 맞는 하나만 하면 됩니다. 모두 할 필요는 없습니다.
| 카페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 Referrer-Policy "strict-origin-when-cross-origin"
</IfModule>처음이라면: 이 코드를 어디에, 어떻게 넣나요?
이런 경우에 씁니다: 웹호스팅(FTP로 파일을 올리는 곳: 카페24 웹호스팅, 가비아, 닷홈, 호스팅케이알 등)이거나, 서버에 Apache를 설치해 쓰는 경우
- 웹호스팅이라면 .htaccess 파일에 넣습니다. FTP 프로그램(파일질라 등)이나 호스팅 관리 화면의 '파일 관리자'로 접속합니다.
- 웹 폴더(이름이 public_html, www, html 중 하나이고 index.php나 index.html이 들어 있는 곳)를 엽니다.
- 그 안의
.htaccess파일을 내 PC로 내려받아 복사본을 하나 만들어 둡니다(문제가 생기면 이걸로 되돌립니다). 파일이 없으면 메모장으로 새로 만들면 됩니다. - 메모장으로 열어 맨 아래에 위 코드를 그대로 붙여 넣고 저장합니다(인코딩은 UTF-8).
- 다시 같은 자리에 올리고, 브라우저로 사이트가 잘 열리는지 확인합니다.
- 서버를 직접 운영한다면 사이트 설정 파일(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 Referrer-Policy "strict-origin-when-cross-origin" always;처음이라면: 이 코드를 어디에, 어떻게 넣나요?
이런 경우에 씁니다: 서버에 직접 접속(SSH)해서 Nginx를 쓰는 경우
- 서버에 SSH로 접속합니다.
- 내 사이트 설정 파일을 찾습니다:
sudo grep -rl "server_name" /etc/nginx/결과 중 내 도메인이 들어 있는 파일입니다(보통/etc/nginx/sites-available/또는/etc/nginx/conf.d/안). - 바꾸기 전에 복사본을 만듭니다:
sudo cp 파일 파일.bak - 파일을 열어(
sudo nano 파일)server {로 시작하는 블록 안,server_name줄 아래에 위 코드를 넣습니다. HTTPS를 쓴다면listen 443이 있는 블록에 넣어야 합니다. - 문법 검사:
sudo nginx -t— 'syntax is ok'가 나올 때만 다음으로 갑니다. - 적용:
sudo systemctl reload nginx
잘 안 되면 nginx -t에서 오류가 나면 적용하지 말고 복사본으로 되돌리세요: sudo cp 파일.bak 파일. reload는 접속 중인 방문자를 끊지 않습니다.
IIS (web.config)
<configuration>
<system.webServer>
<httpProtocol>
<customHeaders>
<add name="Referrer-Policy" value="strict-origin-when-cross-origin" />
</customHeaders>
</httpProtocol>
</system.webServer>
</configuration>처음이라면: 이 코드를 어디에, 어떻게 넣나요?
이런 경우에 씁니다: 윈도우 서버(IIS)나 윈도우 웹호스팅(ASP, ASP.NET 사이트)인 경우
- 사이트 폴더(웹 폴더) 맨 위에 있는
web.config파일을 찾습니다. FTP나 원격 데스크톱으로 접속합니다. - 복사본을 먼저 만듭니다.
- web.config가 이미 있다면 통째로 덮어쓰지 마세요. 위 코드에서
<add name=… />한 줄만, 파일 안의<customHeaders>안에 넣습니다. customHeaders가 없다면<system.webServer>안에 위 코드의<httpProtocol>부분을 넣습니다. - 파일이 없다면 위 코드 전체로 새로 만들면 됩니다.
- 저장하면 바로 적용됩니다. 사이트가 잘 열리는지 확인합니다.
잘 안 되면 IIS 관리자 프로그램의 사이트 → 'HTTP 응답 헤더' 메뉴에서 [추가]로 이름과 값을 넣어도 같은 결과입니다. 사이트가 500 오류를 내면 복사본으로 되돌리세요.
Caddy (사이트 블록)
header Referrer-Policy "strict-origin-when-cross-origin"처음이라면: 이 코드를 어디에, 어떻게 넣나요?
이런 경우에 씁니다: 서버에서 Caddy를 쓰는 경우
- 서버에 SSH로 접속해
/etc/caddy/Caddyfile을 엽니다. 먼저 복사본:sudo cp /etc/caddy/Caddyfile /etc/caddy/Caddyfile.bak - 내 사이트 주소로 시작하는 블록(
example.com {…}) 안에 위 줄을 넣습니다. - 검사:
sudo caddy validate --config /etc/caddy/Caddyfile - 적용:
sudo systemctl reload caddy
PHP·그누보드5 (웹서버 설정을 바꿀 수 없을 때)
<?php
// 그누보드5: extend/security_headers.php 로 저장하면 모든 페이지에 적용됩니다.
// 다른 PHP 사이트: 모든 페이지가 불러오는 공통 파일 맨 위에 header() 줄만 넣습니다.
if (!defined('_GNUBOARD_')) exit;
header("Referrer-Policy: strict-origin-when-cross-origin");처음이라면: 이 코드를 어디에, 어떻게 넣나요?
이런 경우에 씁니다: 웹호스팅이라 웹서버 설정은 못 바꾸지만 PHP 파일은 올릴 수 있는 경우 (그누보드5·영카트에 특히 쉬움)
- FTP 프로그램이나 호스팅 파일 관리자로 접속해 사이트 폴더를 엽니다.
- 그누보드5·영카트:
extend폴더 안에 위 코드를 담은 새 파일(예:security_headers.php)을 올립니다. 이 폴더의 파일은 모든 페이지에서 자동으로 읽힙니다. 이미 같은 이름의 파일이 있다면header(…)줄만 그 파일에 더합니다. - 워드프레스: 이 코드 대신 관리자 화면 → 플러그인 → 새로 추가에서 'security headers'로 검색해 보안 헤더 플러그인을 쓰는 편이 안전합니다(테마를 바꿔도 유지됩니다).
- 그 밖의 PHP 사이트: 모든 페이지가 맨 처음 불러오는 공통 파일(보통 config.php, common.php, header.php) 맨 위
<?php바로 아래에header(…)줄만 넣습니다. - 메모장으로 저장할 때 인코딩은 UTF-8(BOM 없이)로 합니다. 사이트가 잘 열리는지 확인합니다.
잘 안 되면 화면이 하얗게 나오면 방금 올린 파일을 지우거나 원래 파일로 되돌리면 바로 복구됩니다. 파일 앞에 빈 줄이나 BOM이 있으면 'headers already sent' 오류가 날 수 있습니다.
직접 고치기 어렵다면: 호스팅사·관리 업체에 보낼 요청 문구
상자를 한 번 누르면 전체가 선택됩니다. 복사해서 주소만 채워 보내세요.
안녕하세요. 저희 사이트(주소: ____________)를 보안 점검 도구 '문단속'으로 확인해 보니 'Referrer-Policy' 항목을 고치라는 안내가 나왔습니다. 점검 내용: 다른 사이트로 이동할 때 현재 주소를 얼마나 알려줄지 정하는 헤더가 있는지 봅니다. 번거로우시겠지만 이 설정을 적용해 주실 수 있을까요? 웹서버별 설정 방법은 아래 페이지에 정리돼 있습니다. https://mundansok.kr/guide/referrer_policy 감사합니다.
무엇이든 바꾸기 전에는 원래 파일을 복사해 두세요. 문제가 생기면 그 파일로 되돌리면 바로 원래대로 돌아옵니다.