Copy & Run

Express helmet 보안 헤더: 적용 전후 응답 비교

같은 Express 앱을 helmet 없이 실행했을 때와 helmet을 적용했을 때 HTTP 응답 헤더가 어떻게 달라지는지 curl 출력으로 비교합니다. 헤더가 무엇을 막는지, 어디서 확인하는지, 적용할 때 주의할 점까지 정리합니다.

실습 노트 · 2026-11-16 발행 · 6분 · 2026-11 확인

Express는 기본 설정으로 응답을 만들 때 보안 헤더를 넣지 않습니다. 그래서 브라우저가 페이지를 어떻게 다룰지 정하는 방어 설정이 빠진 채로 응답이 나갑니다. helmet은 여러 보안 헤더를 한 번에 붙여 주는 미들웨어입니다. 이 글에서는 같은 앱을 두 번 실행해, 적용 전후 응답 헤더를 실제 출력으로 비교합니다.

준비물

항목 내용
Node.js v24.15.0
npm 11.12.1
Express 4.21.2
helmet 8.1.0
확인 도구 curl (Windows 10 이상에 기본 포함)

실습 서버는 모두 127.0.0.1에만 엽니다. 다른 PC에서는 접속할 수 없습니다.

1. 프로젝트와 패키지 설치

빈 폴더에서 프로젝트를 만들고 두 패키지를 설치합니다.

npm init -y
npm install express@4.21.2 helmet@8.1.0
+-- express@4.21.2
`-- helmet@8.1.0

2. 같은 앱을 두 가지로 준비

server.js는 실행 인자로 helmet 사용 여부를 고릅니다. 코드는 아래와 같습니다. 핵심은 app.use(helmet())을 라우트보다 먼저 등록하는 것입니다. 미들웨어는 등록된 순서대로 실행되므로, 뒤에 등록하면 그 앞에서 응답이 끝난 요청에는 헤더가 붙지 않습니다.

const express = require("express");
const helmet = require("helmet");

const useHelmet = process.argv[2] === "helmet";
const port = Number(process.argv[3] || 3000);
const app = express();

if (useHelmet) {
  app.use(helmet());
}

app.get("/", (req, res) => {
  res.send("<h1>lab</h1>");
});

app.listen(port, "127.0.0.1", () => {
  console.log(`listening on 127.0.0.1:${port} helmet=${useHelmet}`);
});

두 서버를 다른 포트로 띄웁니다.

node server.js plain 4101
node server.js helmet 4102
listening on 127.0.0.1:4101 helmet=false
listening on 127.0.0.1:4102 helmet=true

3. 응답 헤더 비교

helmet을 붙이지 않은 서버의 응답 헤더를 봅니다.

curl -sI http://127.0.0.1:4101/
HTTP/1.1 200 OK
X-Powered-By: Express
Content-Type: text/html; charset=utf-8
Content-Length: 12
ETag: W/"c-f8ETZ1cfRUn/D3yBtaOaDvffVeE"

보안 관련 헤더가 없습니다. X-Powered-By: Express는 서버 종류를 알려 주므로, 공격자가 알려진 취약점을 고르는 데 쓸 수 있습니다.

같은 요청을 helmet을 붙인 서버에 보냅니다.

curl -sI http://127.0.0.1:4102/
HTTP/1.1 200 OK
Content-Security-Policy: default-src 'self';base-uri 'self';font-src 'self' https: data:;form-action 'self';frame-ancestors 'self';img-src 'self' data:;object-src 'none';script-src 'self';script-src-attr 'none';style-src 'self' https: 'unsafe-inline';upgrade-insecure-requests
Cross-Origin-Opener-Policy: same-origin
Cross-Origin-Resource-Policy: same-origin
Origin-Agent-Cluster: ?1
Referrer-Policy: no-referrer
Strict-Transport-Security: max-age=31536000; includeSubDomains
X-Content-Type-Options: nosniff
X-DNS-Prefetch-Control: off
X-Download-Options: noopen
X-Frame-Options: SAMEORIGIN
X-Permitted-Cross-Domain-Policies: none
X-XSS-Protection: 0

X-Powered-By는 사라졌고, 그 자리를 여러 보안 헤더가 채웠습니다. 두 응답의 차이를 표로 보면 다음과 같습니다.

헤더 적용 전 적용 후 막거나 줄이는 것
X-Powered-By Express 없음 서버 종류 노출
Content-Security-Policy 없음 script-src 'self' 등 외부 스크립트 주입과 XSS 피해
X-Content-Type-Options 없음 nosniff 브라우저의 MIME 타입 추측
X-Frame-Options 없음 SAMEORIGIN 다른 사이트의 iframe 삽입(클릭재킹)
Strict-Transport-Security 없음 1년 HTTPS 대신 HTTP로 내려가는 접속
Referrer-Policy 없음 no-referrer 이동할 때 주소가 외부로 전달되는 것
Cross-Origin-Opener-Policy 없음 same-origin 다른 창과 정보를 주고받는 공격

4. 각 헤더가 실제로 하는 일

헤더 이름만 외우면 적용 뒤 문제가 생겨도 원인을 찾기 어렵습니다. 자주 보는 세 가지만 짚습니다.

  • Content-Security-Policy: 페이지가 불러올 수 있는 스크립트 출처를 정합니다. script-src 'self'는 같은 출처의 파일만 실행하겠다는 뜻입니다. 주입된 <script>가 있어도 외부 주소에서 받아 실행하지 못합니다. 다만 CSP는 브라우저가 적용하므로, curl로는 차단되는지 확인할 수 없습니다. 브라우저 개발자 도구의 콘솔에서 Refused to execute ... 메시지가 나오는지 봐야 합니다.
  • X-Content-Type-Options: nosniff: 응답의 Content-Type을 믿고 그대로 처리하게 합니다. 텍스트처럼 보내 놓은 파일을 브라우저가 스크립트로 해석하는 일을 줄입니다.
  • X-Frame-Options: 다른 사이트의 <iframe>에 내 페이지를 넣지 못하게 합니다. 로그인 버튼 위에 투명한 프레임을 겹쳐 클릭을 가로채는 공격을 막습니다. 최신 기준으로는 CSP의 frame-ancestors가 더 정밀하고, helmet은 두 가지를 함께 넣습니다.

헤더 값은 helmet 기본값만으로 맞지 않는 경우가 많습니다. CSP는 앱이 실제로 쓰는 스크립트와 스타일 주소에 맞춰야 합니다. 예를 들어 CDN에서 script를 받아 쓰는 페이지는 script-src에 그 주소를 추가해야 합니다.

5. 적용할 때 주의할 점

helmet을 붙인 뒤에는 화면이 깨지는지 브라우저에서 한 번 열어 확인합니다.

  • 인라인 스크립트(<script>...</script>)와 인라인 이벤트 속성(onclick="...")은 기본 CSP에서 실행되지 않습니다. 별도 파일로 옮기거나 nonce를 붙입니다.
  • 외부 폰트나 이미지 서버를 쓰면 CSP 목록에 그 출처를 추가해야 합니다.
  • Strict-Transport-Security는 한 번 브라우저에 저장되면 지정한 기간 동안 HTTP 접속을 막습니다. HTTPS를 쓰는 환경에서만 켭니다.
  • 리버스 프록시(nginx 등)에서 이미 같은 헤더를 넣고 있다면 중복되지 않게 한쪽에서만 설정합니다.

6. 점검 순서

새 Express 앱을 점검할 때는 다음 순서로 확인합니다.

  1. curl -sI <주소>로 응답 헤더를 봅니다. X-Powered-By가 남아 있는지부터 확인합니다.
  2. app.use(helmet())이 라우트 등록보다 앞에 있는지 확인합니다.
  3. 브라우저 개발자 도구의 콘솔에서 CSP 위반 메시지가 없는지 확인합니다.
  4. 헤더가 빠지기 쉬운 응답(정적 파일, 에러 페이지)에도 붙는지 확인합니다. helmet보다 먼저 등록된 미들웨어가 응답을 끝내면 헤더가 빠집니다.
  5. 운영 배포 전에 실제 도메인으로 같은 curl 명령을 한 번 더 실행합니다.

헤더는 방어의 한 겹일 뿐입니다. 입력을 검증하고 출력을 이스케이프하는 일은 여전히 앱 코드에서 해야 합니다.

이 글의 다음 단계

이 내용을 팀 교육으로 진행하고 싶으신가요?

인원, 수준, 일정에 맞춰 실습 환경까지 준비해 진행합니다. 대상과 기간을 알려 주시면 구성을 제안해 드립니다.

교육 문의하기

교육 진행 순서와 자주 묻는 질문 보기

팀이나 교육 담당자에게 이 글 제안하기

메일로 보내실 수도 있습니다: fankh111@gmail.com

같은 카테고리의 글