npm audit
경고 메시지를 보고 무엇부터 조사해야 할지 막막하다. 직접 설치하지 않은 라이브러리의 취약점을 어떻게 다뤄야 하는지 알고 싶다.
- AI가 제공하는 "업데이트 후 테스트를 통과했습니다"라는 보고서를 스스로 판단하고 싶다.
취약점 탐지부터 의존 경로 및 영향 확인, 업데이트 후 검증까지의 과정을 정리합니다. 단순히 경고 건수를 줄이는 것을 목표로 삼기보다, 무엇이 명확하게 파악되었고 무엇이 아직 미확인인지 설명할 수 있는 관점을 정리했습니다.
Impress의 공개 기획물 중 'Python으로 배우는 Web 앱 보안 코딩'에서는 SCA(Software Composition Analysis)를 이용한 라이브러리 취약점 관리 방법을 다루었습니다. 본 글에서는 이 주제를 Node.js와 npm을 사용하는 개발 관점에서 정리합니다.
명령어는 조사 방법을 설명하기 위한 예시로 제시됩니다. 각 명령어의 설명은 npm v11 공식 문서를 기반으로 합니다.
npm audit
은 의존 관계를 알려진 취약점 정보와 대조하는 명령어입니다. 경고가 발생하면, 먼저 대상 패키지와 버전, 그리고 Advisory(취약점 보고서)를 확인해야 합니다.
여기서 알 수 있는 것은 감사 대상의 의존 관계에 이미 알려진 문제가 보고되었다는 사실뿐입니다. 이것만으로는 앱이 침해된 사실이나, 사용자의 입력으로부터 문제 기능에 도달할 수 있는지까지 확인할 수는 없습니다.
반면, 도달 경로를 조사하지 않은 상태에서 '사용하지 않으니 영향 없음'이라고 단정하는 것은 너무 성급합니다. 확인된 사실과 앞으로 조사해야 할 조건을 분리하여 생각해야 합니다.
예를 들어, 다음과 같이 메모를 나누어 기록하면 판단의 근거가 남습니다.
| 항목 | 확인할 내용 |
|---|
| 탐지 | 대상 패키지, 도입 버전, 영향을 받는 버전, Advisory 식별자 |
| ... | |
| 이 표는 조사용 틀입니다. 아직 조사하지 않은 항목은 '미확인'으로 기록합니다. | |
앱이 사용하는 라이브러리는 내부적으로 또 다른 라이브러리를 사용할 수 있습니다. 이것이 간접 의존(indirect dependency)입니다. 직접 이름으로 지정하지 않았더라도, 앱의 의존 관계에 포함될 가능성이 있습니다.
설치된 의존 관계에서 해당 대상이 왜 도입되었는지 조사하려면, npm explain을 사용할 수 있습니다. 다음 PACKAGE_NAME은 감사 결과에 있는 실제 패키지 이름으로 대체합니다.
같은 이름을 가진 여러 버전이 포함되어 있다면, 대상이 된 버전과 경로를 구분해야 합니다. 의존 경로를 확인한 후, 상위 라이브러리의 업데이트를 통해 수정된 버전으로 이동할 수 있는지까지 조사합니다.
간접 의존만 강제로 다른 버전으로 대체하면, 상위 라이브러리가 예상하는 API나 동작 방식과 맞지 않게 될 가능성이 있습니다. overrides 등을 사용할 경우에도, 경고가 사라지는 것과 호환성 검증은 별개로 생각해야 합니다.
개발용 라이브러리라도 개발 서버나 CI(Continuous Integration), 빌드 처리 과정에서는 실행됩니다. 문제가 운영 서버에만 국한되지 않고, 외부에서 가져온 파일이나 개발 중에 받는 입력으로도 발생할 수 있다고 고려해야 합니다.
또한, 브라우저에 배포되는 코드에 무엇이 포함될지는 dependencies와 devDependencies의 분류만으로는 판단할 수 없습니다. 실제 import 경로와 빌드/배포 경로를 확인해야 합니다.
조사에서는 전체를 대상으로 한 결과와 개발 의존을 제외한 결과를 구분할 수 있습니다.
npm audit --json
npm audit --omit=dev --json
후자는 감사 대상을 좁히는 지정입니다. 경고가 줄어들더라도, 제외된 개발 환경의 문제가 해결되었다는 의미는 아닙니다.
참고로, npm audit은 설정된 레지스트리로 의존 관계 정보를 전송합니다. 업무 환경에서 실행할 경우에는 사용하는 레지스트리와 조직의 운영 규칙을 확인해야 합니다.
대응 방안을 생각할 때는 먼저 수정 버전의 유무와, 그곳으로 업데이트하기 위한 조건을 조사하는 것이 우선입니다. 변경 이력이나 마이그레이션 가이드에서 API 변경 사항, 필요한 Node.js 버전, peer dependency 등을 확인합니다.
자동 수정 예정을 볼 수 있는 방법으로 다음 명령어가 있습니다.
npm audit fix --dry-run --json
이는 변경 예정을 확인할 뿐이며, 앱의 호환성을 검증하는 것은 아닙니다. 일반적인 npm audit fix는 의존 관계를 변경합니다. --force를 붙이면 지정한 의존 범위 밖의 업데이트나 메이저 업데이트도 허용합니다. 실행하기 전에 업데이트될 패키지와 버전을 확인해야 합니다.
업데이트할 때는, package.json
lockfile의 차이점을 확인하여 의도한 버전이 도입되었는지 점검합니다. 아울러, 해당 의존성을 사용하는 처리 과정과 CI(지속적 통합) 환경이나 컨테이너 등 실제로 의존성이 도입되는 경로를 확인해야 합니다.
수정된 버전이 없거나 즉시 마이그레이션할 수 없는 경우도 있습니다. 이럴 때는 제공처가 제시하는 회피책(workaround), 기능 중단, 라이브러리 대체 또는 삭제 등을 검토합니다. 임시 조치를 취한다면, 대상 취약점, 근거, 남아있는 과제, 담당자, 재확인일자를 기록해야 합니다. 이는 '조사 중' 상태가 기한 없는 방치로 이어지지 않도록 하기 위함입니다.
업데이트 후에는 최소한 다음 두 가지를 분리하여 확인합니다.
| 확인 항목 | 점검 내용 | 이로부터 알 수 없는 것 |
|---|
| 업데이트 후 감사(Audit) | 대상 버전과 Advisory가 어떻게 변경되었는지 | 알려지지 않은 취약점까지 존재하지 않는다는 사실 |
| 영향을 받는 기능 검증 | 테스트, 빌드, 실행, 주요 조작이 검증 조건 하에서 작동하는지 | 검증하지 않은 기능이나 환경도 모두 안전하다는 사실 |
건수(件数)가 같더라도 대상 문제가 바뀌어 있을 가능성이 있습니다. 업데이트 전후에는 건수 외에도 패키지, 버전, Advisory, 감사 대상을 비교해야 합니다. 취약점 정보 자체도 업데이트되기 때문에, 조회 일시와 Node.js 및 npm 버전을 남겨두면 비교하기 쉽습니다.
CI의 종료 코드(Exit Code)에도 주의가 필요합니다. --audit-level은 실패로 간주하는 심각도의 임계값을 변경하는 지정일 뿐, 리포트에서 낮은 심각도의 문제를 제거하는 지정이 아닙니다. 또한, 명령이 통신 등의 문제로 실패한 경우도 감사가 완료되어 0건이었던 경우와는 구별해야 합니다.
AI에게 업데이트를 맡길 때는 '경고가 사라졌다', '테스트가 통과했다'라는 결론뿐만 아니라 다음 정보들도 확인합니다.
- 대상 패키지 및 버전, 의존 경로, Advisory
- 문제 기능에 도달하는 경로와, 확인하지 못한 조건들
- 어떤 의존성을 어느 버전으로 업데이트했는지, 그리고 무엇이 변경되었는지
- 실행한 검증과 그 결과, 그리고 실행하지 않은 검증 목록
- 남아있는 과제와 담당자 및 재확인일자
심각도(Severity)는 우선순위를 생각하는 중요한 정보이지만, 그것만으로 모든 것이 결정되지는 않습니다. 실행 환경이나 공격 조건, 이미 악용이 확인되었는지 여부, 업데이트의 영향 등도 종합적으로 판단해야 합니다. 영향 조사(Impact Investigation)는 대응을 미루는 구실이 아니라, 필요한 조치를 구체화하기 위해 수행됩니다.
의존 라이브러리의 취약점 대응에서는 '탐지', '애플리케이션에 미치는 영향', '업데이트 후 동작'을 나누어 확인합니다. 직접 의존성인지 간접 의존성인지, 어떤 환경에서 무엇을 처리하는지를 추적함으로써, 업데이트 대상과 검증 범위를 설명하기가 쉬워집니다.
AI에게 조사나 업데이트를 도움 받더라도, 미확인 조건과 남아있는 리스크를 어떻게 다룰지는 인간이 판단합니다. 건수만으로 완료를 결정하지 않고, 무엇을 근거로 대응했는지, 어느 정도까지 검증했는지가 파악되는 보고서를 요구해야 합니다.