Node.js 프로젝트는 npm으로 패키지를 설치합니다. 설치한 패키지에는 알려진 취약점이 있을 수 있고, npm audit은 설치한 패키지 목록을 레지스트리의 보안 권고와 대조해 보여 줍니다. 이 글에서는 프로젝트를 만들고, 일부러 오래된 lodash를 설치한 뒤, 감사 결과를 읽고 고치는 순서를 실제 출력으로 따라갑니다.
준비물
| 항목 | 내용 |
|---|---|
| Node.js | v24.15.0 |
| npm | 11.12.1 |
| 실습 패키지 | lodash@4.17.15 (취약 버전, 실습용) |
| 실습 위치 | 빈 폴더 하나 (실제 프로젝트와 분리) |
| 예상 소요 시간 | 약 10분 |
npm audit은 네트워크로 레지스트리에 접속해야 합니다. 결과는 실행한 날짜의 권고 목록을 기준으로 하므로, 날짜가 다르면 개수가 달라질 수 있습니다.
1. Node.js와 npm 버전 확인
설치된 버전을 먼저 확인합니다.
node --version
npm --version
v24.15.0
11.12.1
Node.js 22 이상에서는 npm이 함께 설치되므로 별도 도구를 더 설치하지 않아도 됩니다.
2. 프로젝트 만들기
빈 폴더에서 npm init -y로 package.json을 만듭니다.
npm init -y
Wrote to .../node-lab/package.json:
{
"name": "lab",
"version": "1.0.0",
"main": "index.js",
"license": "ISC",
"type": "commonjs"
}
package.json은 의존성 목록이고, 설치 결과의 정확한 버전은 package-lock.json에 기록됩니다. 두 파일을 함께 저장소에 올리는 것이 점검의 출발점입니다.
3. 취약한 패키지 설치
lodash의 오래된 버전을 설치합니다.
npm install lodash@4.17.15
설치는 끝나지만 마지막에 취약점 경고가 나옵니다.
To address all issues, run:
npm audit fix --force
Run `npm audit` for details.
설치가 성공했다고 해서 안전하다는 뜻은 아닙니다. 경고는 설치 뒤에 따로 확인해야 합니다.
4. npm audit 결과 읽기
감사 명령으로 취약점 목록을 봅니다.
npm audit
# npm audit report
lodash <=4.17.23
Severity: high
Command Injection in lodash - https://github.com/advisories/GHSA-35jh-r3h4-6jhm
Prototype Pollution in lodash - https://github.com/advisories/GHSA-p6mc-m468-83gw
Regular Expression Denial of Service (ReDoS) in lodash - https://github.com/advisories/GHSA-29mw-wpgm-hmr9
lodash vulnerable to Code Injection via `_.template` imports key names - https://github.com/advisories/GHSA-r5fr-rjxr-66jc
Lodash has Prototype Pollution Vulnerability in `_.unset`, `_.omit`, and `_.pullAt` functions - https://github.com/advisories/GHSA-xxjr-mmjv-4gpg
fix available via `npm audit fix`
node_modules/lodash
1 high severity vulnerability
출력에서 읽을 항목은 네 가지입니다.
- 영향 범위:
lodash <=4.17.23은 이 버전 이하가 모두 해당한다는 뜻입니다. - 심각도:
high는 이 프로젝트에서 우선 고칠 대상입니다. - 권고 번호:
GHSA-로 시작하는 주소를 열면 취약한 호출 조건과 수정 버전을 확인할 수 있습니다. - 수정 방법:
npm audit fix로 고칠 수 있다고 알려 줍니다.
5. 수정하고 다시 점검하기
npm audit fix로 취약한 버전을 올립니다. 이 명령은 같은 주 버전 안에서 바꿀 수 있는 것만 바꿉니다.
npm audit fix
changed 1 package, and audited 2 packages in 3s
found 0 vulnerabilities
설치된 버전이 실제로 바뀌었는지 npm ls로 확인합니다.
npm ls lodash
lab@1.0.0
`-- lodash@4.18.1
마지막으로 감사 명령을 한 번 더 실행합니다.
npm audit
found 0 vulnerabilities
6. 점검 항목 정리
새 Node.js 프로젝트를 점검할 때는 다음 순서로 확인합니다.
package-lock.json이 저장소에 있는지 확인합니다. 없으면 설치할 때마다 버전이 달라질 수 있습니다.npm audit을 실행하고 심각도가high와critical인 항목부터 봅니다.npm audit fix로 해결되는지 확인하고, 해결되지 않으면 해당 패키지의 주 버전 업그레이드를 검토합니다.--force는 주 버전이 바뀔 수 있으므로 테스트를 돌린 뒤에만 씁니다.- 배포 전에
npm audit --omit=dev로 실행 환경에 들어가는 패키지만 따로 확인합니다.
npm audit은 알려진 권고만 찾습니다. 직접 작성한 코드의 취약점은 찾지 못하므로, 정적 분석 도구와 함께 쓰는 것이 좋습니다.
이 글의 다음 단계
- npm audit --audit-level 사용법: 종료 코드로 배포 막기npm audit --audit-level은 지정한 심각도 이상의 취약점이 있을 때만 종료 코드 1을 돌려줍니다. low부터 critical까지 단계별 종료 코드와 --omit=dev를 붙였을 때의 차이를 실제 실행 결과로 확인합니다. npm script와 CI 단계에 넣는 방법도 정리합니다.
- package.json과 package-lock.json 차이: npm ci로 확인하기package.json에는 허용하는 버전 범위가, package-lock.json에는 실제로 설치된 버전과 integrity 해시가 적힙니다. 같은 프로젝트에서 npm install과 npm ci를 번갈아 실행해 두 파일의 역할과 두 명령의 차이를 실제 출력으로 확인합니다.
이 내용을 팀 교육으로 진행하고 싶으신가요?
인원, 수준, 일정에 맞춰 실습 환경까지 준비해 진행합니다. 대상과 기간을 알려 주시면 구성을 제안해 드립니다.
교육 문의하기메일로 보내실 수도 있습니다: fankh111@gmail.com