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

가이드 · 쿠키

쿠키 보안 속성

무엇을 보나요

첫 화면에서 설정하는 쿠키에 Secure, HttpOnly, SameSite 속성이 붙어 있는지 봅니다.

왜 위험한가요

Secure가 없으면 쿠키가 HTTP로 새어 나갈 수 있고, HttpOnly가 없으면 악성 스크립트가 로그인 쿠키를 훔칠 수 있으며, SameSite가 없으면 다른 사이트가 방문자 몰래 요청을 보내는 공격(CSRF)에 더 취약해집니다.

어떻게 고치나요

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

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

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

PHP (php.ini 또는 호스팅의 PHP 설정)

session.cookie_secure = 1
session.cookie_httponly = 1
session.cookie_samesite = "Lax"
처음이라면: 이 코드를 어디에, 어떻게 넣나요?

이런 경우에 씁니다: PHP 설정(php.ini)을 바꿔야 하는 경우

  1. 웹호스팅이라면 호스팅 관리 화면에 'PHP 설정' 메뉴가 있는지 찾아 봅니다. 없으면 호스팅사에 요청합니다(아래 요청 문구).
  2. 서버를 직접 운영한다면 쓰는 php.ini 위치를 확인합니다: php --ini (웹에서 쓰는 PHP-FPM은 보통 /etc/php/버전/fpm/php.ini).
  3. 복사본을 만들고 해당 줄을 찾아 값을 바꿉니다(앞에 ; 가 있으면 지웁니다).
  4. 적용: sudo systemctl restart php8.3-fpm(버전에 맞게) 또는 Apache 모듈 방식이면 sudo systemctl restart apache2

PHP 코드로 쿠키를 만들 때 (PHP 7.3+)

setcookie('name', $value, [
    'secure'   => true,
    'httponly' => true,
    'samesite' => 'Lax',
    'path'     => '/',
]);
처음이라면: 이 코드를 어디에, 어떻게 넣나요?

이런 경우에 씁니다: 웹호스팅이라 웹서버 설정은 못 바꾸지만 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' 오류가 날 수 있습니다.

Nginx 리버스 프록시 (1.19.3+)

proxy_cookie_flags ~ secure httponly samesite=lax;
처음이라면: 이 코드를 어디에, 어떻게 넣나요?

이런 경우에 씁니다: 서버에 직접 접속(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는 접속 중인 방문자를 끊지 않습니다.

Apache (애플리케이션을 고칠 수 없을 때)

Header always edit Set-Cookie ^(.*)$ "$1; HttpOnly; Secure; SameSite=Lax"
처음이라면: 이 코드를 어디에, 어떻게 넣나요?

이런 경우에 씁니다: 웹호스팅(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 프로그램에서 작업하는 편이 쉽습니다.

Secure는 HTTPS를 켠 뒤에 적용하세요. HTTP 사이트에서 Secure를 붙이면 로그인이 안 됩니다. Apache의 edit 방식은 이미 속성이 있는 쿠키에 중복으로 붙을 수 있으니 가능하면 애플리케이션 설정에서 고치세요.

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

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

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

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