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 앱을 점검할 때는 다음 순서로 확인합니다.
curl -sI <주소>로 응답 헤더를 봅니다.X-Powered-By가 남아 있는지부터 확인합니다.app.use(helmet())이 라우트 등록보다 앞에 있는지 확인합니다.- 브라우저 개발자 도구의 콘솔에서 CSP 위반 메시지가 없는지 확인합니다.
- 헤더가 빠지기 쉬운 응답(정적 파일, 에러 페이지)에도 붙는지 확인합니다. helmet보다 먼저 등록된 미들웨어가 응답을 끝내면 헤더가 빠집니다.
- 운영 배포 전에 실제 도메인으로 같은
curl명령을 한 번 더 실행합니다.
헤더는 방어의 한 겹일 뿐입니다. 입력을 검증하고 출력을 이스케이프하는 일은 여전히 앱 코드에서 해야 합니다.
이 글의 다음 단계
- Express 라우팅과 미들웨어: REST API 만들고 curl로 확인Express 4로 할 일 목록 REST API를 만들면서 라우터 모듈, express.json(), 로깅 미들웨어, 입력 검증을 순서대로 붙입니다. 404 처리와 에러 처리 미들웨어까지 다룹니다. 요청마다 curl -i로 보낸 명령과 실제 응답을 함께 싣습니다.
- XSS 막기: 출력 이스케이프와 CSP를 Flask에 적용하고 브라우저에서 확인게시판 앱에서 저장형 XSS를 일으켜 보고, 자동 이스케이프와 nonce CSP 헤더, HttpOnly·SameSite 쿠키로 고친 뒤 개발자 도구의 Console과 Network 탭에서 막힌 것을 확인합니다.
이 내용을 팀 교육으로 진행하고 싶으신가요?
인원, 수준, 일정에 맞춰 실습 환경까지 준비해 진행합니다. 대상과 기간을 알려 주시면 구성을 제안해 드립니다.
교육 문의하기메일로 보내실 수도 있습니다: fankh111@gmail.com