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

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

- 주소: https://copyandrun.com/blog/express-helmet-security-headers-compare/
- 분야: 시큐어코딩
- 발행일: 2026-11-16
- 태그: Express, helmet, 보안 헤더, CSP, Node.js

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. 프로젝트와 패키지 설치

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

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

```text
+-- express@4.21.2
`-- helmet@8.1.0
```

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

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

```javascript
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}`);
});
```

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

```bash
node server.js plain 4101
node server.js helmet 4102
```

```text
listening on 127.0.0.1:4101 helmet=false
listening on 127.0.0.1:4102 helmet=true
```

## 3. 응답 헤더 비교

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

```bash
curl -sI http://127.0.0.1:4101/
```

```text
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을 붙인 서버에 보냅니다.

```bash
curl -sI http://127.0.0.1:4102/
```

```text
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` 명령을 한 번 더 실행합니다.

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