의존성 감사 어시스턴트
이 스킬은 프로젝트 의존성에 대한 보안 취약점, 오래된 패키지, 라이선스 호환성 문제를 감사하는 데 도움을 줍니다.
이 스킬을 사용해야 할 때
- 사용자가 의존성 감사 또는 보안 점검을 요청할 때
- 주요 릴리스 또는 배포 전
- 사용자가 오래된 패키지나 취약점에 대해 물을 때
- 라이선스 호환성 검토가 필요할 때
- 사용자가 "npm audit", "security", "dependencies", "vulnerabilities"를 언급할 때
지침
1. 패키지 매니저 감지
프로젝트가 사용하는 패키지 매니저를 식별합니다.
JavaScript/Node.js:
- npm:
package.json+package-lock.json - Yarn:
package.json+yarn.lock - pnpm:
package.json+pnpm-lock.yaml
Python:
- pip:
requirements.txt또는setup.py - Poetry:
pyproject.toml+poetry.lock - Pipenv:
Pipfile+Pipfile.lock
Ruby:
- Bundler:
Gemfile+Gemfile.lock
Java:
- Maven:
pom.xml - Gradle:
build.gradle또는build.gradle.kts
Go:
- Go 모듈:
go.mod+go.sum
Rust:
- Cargo:
Cargo.toml+Cargo.lock
PHP:
- Composer:
composer.json+composer.lock
Glob을 사용하여 이러한 파일을 찾습니다.
2. 보안 감사 실행
패키지 매니저에 따라 적절한 감사 명령어를 실행합니다.
npm: npm audit --json 또는 npm audit
Yarn: yarn audit --json 또는 yarn audit
pnpm: pnpm audit --json
pip: pip-audit 또는 safety check
Poetry: poetry check
Bundler: bundle audit check --update
Maven: mvn dependency:tree + OWASP Dependency Check
Go: go list -m all + govulncheck
Cargo: cargo audit
Composer: composer audit
출력을 분석하여 다음을 식별합니다:
- 심각도별 취약점 수 (치명적, 높음, 중간, 낮음)
- 영향을 받는 패키지 및 버전
- 사용 가능한 수정 사항 (업데이트 또는 패치)
- CVE 식별자
3. 오래된 패키지 확인
최신 버전이 있는 패키지를 식별합니다.
npm: npm outdated --json
Yarn: yarn outdated --json
pip: pip list --outdated
Poetry: poetry show --outdated
Bundler: bundle outdated
Cargo: cargo outdated
Go: go list -u -m all
업데이트를 분류합니다:
- 패치 업데이트 (1.0.0 → 1.0.1): 버그 수정, 업데이트 안전
- 마이너 업데이트 (1.0.0 → 1.1.0): 새 기능, 일반적으로 안전
- 메이저 업데이트 (1.0.0 → 2.0.0): 호환성 깨짐, 테스트 필요
4. 라이선스 호환성 검사
모든 의존성의 라이선스를 검토합니다.
단계:
- 패키지 메타데이터에서 라이선스 추출
- 라이선스 유형 식별 (MIT, Apache-2.0, GPL 등)
- 잠재적으로 문제가 되는 라이선스 플래그 지정 (상업 프로젝트의 GPL, AGPL)
- 라이선스 미지정 또는 알 수 없는 라이선스 확인
reference/licenses.md의 라이선스 호환성 매트릭스 참조
도구:
- npm:
npx license-checker --json또는npm-license-crawler - Python:
pip-licenses - Ruby:
license_finder - Go:
go-licenses
라이선스 범주:
- 허용적 (Permissive): MIT, Apache-2.0, BSD - 일반적으로 안전
- 약한 카피레프트 (Weak copyleft): LGPL, MPL - 검토 필요
- 강한 카피레프트 (Strong copyleft): GPL, AGPL - 상업적 사용 제한 가능
- 알 수 없음 (Unknown): 라이선스 누락 또는 사용자 정의 라이선스 - 조사 필요
5. 의존성 트리 분석
의존성 구조 이해:
직접 vs 전이:
- 직접: package.json/requirements.txt에 나열된 것
- 전이: 의존성의 의존성
문제 식별:
- 다른 버전의 중복 패키지
- 깊은 의존성 트리 (충돌 가능성)
- 유지보수되지 않는 패키지 (2년 이상 업데이트 없음)
- 고위험 전이 의존성
명령어:
- npm:
npm ls --all - Yarn:
yarn why <package> - pip:
pipdeptree - Maven:
mvn dependency:tree
6. 취약점 우선순위 지정
다음 기준에 따라 취약점 우선순위를 지정합니다:
심각도 수준:
- 치명적 (Critical): 원격 코드 실행, 권한 상승
- 높음 (High): SQL 인젝션, XSS, 인증 우회
- 중간 (Moderate): DoS, 정보 노출
- 낮음 (Low): 사소한 문제, 엣지 케이스
악용 가능성:
- 알려진 악용 사례 존재
- PoC (Proof of Concept) 사용 가능
- 특수 조건 필요
노출:
- 프로덕션 의존성 vs 개발 의존성
- 직접 의존성 vs 깊은 전이 의존성
- 애플리케이션에서 실제로 사용되는 코드 경로
7. 권장 사항 생성
발견된 각 문제에 대해 다음을 제공합니다:
취약점:
패키지: [email protected]
심각도: 높음
CVE: CVE-2020-8203
문제: 프로토타입 오염
권장: [email protected] 이상으로 업그레이드
명령어: npm install [email protected]
오래된 패키지:
패키지: [email protected]
현재: 16.14.0
최신: 18.2.0
유형: 메이저 업데이트
권장: 업그레이드 전 충분히 테스트 (호환성 깨짐)
참고: https://react.dev/blog/2022/03/08/react-18-upgrade-guide 마이그레이션 가이드 확인
라이선스 문제:
패키지: [email protected]
라이선스: GPL-3.0
문제: GPL 라이선스가 독점 코드와 충돌할 수 있음
권장: 허용적 라이선스가 있는 대안 찾기 또는 법률 검토
대안: [MIT/Apache 라이선스를 가진 유사 패키지 목록]
8. 업데이트 전략
업데이트 접근 방식을 제안합니다:
안전한 업데이트 (자동화):
- 호환성 깨짐이 없는 패치 업데이트
- 취약점에 대한 보안 수정
- 업데이트:
npm update또는npm audit fix
주의 깊은 업데이트 (수동 테스트):
- 마이너 버전 범프
- 잘 관리되는 패키지의 메이저 업데이트
- 개별 업데이트 및 테스트
조사 필요:
- 주요 호환성 깨짐
- 유지보수 중단 패키지 (대안 찾기)
- 라이선스 충돌
9. 요약 보고서 생성
포괄적인 감사 요약을 제공합니다:
의존성 감사 보고서
===================
개요:
- 전체 의존성: 150개 (120개 직접, 30개 전이)
- 취약점: 5개 (1개 높음, 3개 중간, 1개 낮음)
- 오래된 패키지: 23개
- 라이선스 문제: 2개
보안 취약점:
[심각도별 목록 및 수정 권장 사항]
오래된 패키지:
[업데이트 유형별 분류: 패치/마이너/메이저]
라이선스 호환성:
[라이선스 목록 및 우려 사항]
권장 조치:
1. [즉시] 높은 심각도 취약점 수정
2. [곧] 중간 심각도 취약점이 있는 패키지 업데이트
3. [검토] 라이선스 호환성 문제 해결
4. [선택 사항] 오래된 패키지를 최신 버전으로 업데이트
실행할 명령어:
npm audit fix # 취약점 자동 수정
npm update # 최신 호환 버전으로 업데이트
10. 지속적 모니터링
지속적인 관행 제안:
- 자동 감사: CI/CD 파이프라인에서 실행
- Dependabot/Renovate: 업데이트에 대한 PR 자동 생성
- 정기 검토: 월별 또는 분기별 감사
- 보안 알림: GitHub/GitLab 보안 알림 활성화
- 잠금 파일: 재현 가능한 빌드를 위해 잠금 파일 커밋
모범 사례
- 취약점 신속히 수정: 특히 높음/치명적 심각도
- 업데이트 테스트: 패치 업데이트도 문제를 일으킬 수 있음
- 변경 로그 읽기: 업데이트 전 변경 사항 이해
- 잠금 파일 사용: 환경 간 일관된 설치 보장
- 의존성 최소화: 적은 의존성 = 더 작은 공격 표면
- 새 추가 사항 검토: 새 의존성 추가 전 감사
- 최신 상태 유지: 정기적인 업데이트가 큰 점프보다 쉬움
- 결정 사항 문서화: 특정 패키지를 고정하거나 업데이트하지 않는 이유
보안 모범 사례
- 의존성 또는 환경 파일에 비밀을 커밋하지 않음
- 인기/중요 패키지의 의존성 소스 코드 검토
- 내부 패키지에 개인 레지스트리 사용
- 패키지 레지스트리 계정에 2FA 활성화
- CDN 리소스에 SRI (Subresource Integrity) 사용
- Docker 사용 시 컨테이너 이미지 스캔
지원 파일
scripts/check-licenses.sh: 라이선스 정보 추출 및 확인reference/licenses.md: 라이선스 호환성 매트릭스reference/common-vulnerabilities.md: 일반적인 취약점 패턴
일반 명령어 참조
npm:
npm audit # 취약점 표시
npm audit fix # 취약점 자동 수정
npm audit fix --force # 강제 메이저 업데이트
npm outdated # 오래된 패키지 확인
npm update # 최신 호환 버전으로 업데이트
Yarn:
yarn audit # 취약점 표시
yarn upgrade-interactive # 대화형 업그레이드
yarn outdated # 오래된 패키지 확인
pip:
pip-audit # 취약점 감사
pip list --outdated # 오래된 패키지 확인
pip install --upgrade # 패키지 업데이트
Poetry:
poetry check # 잠금 파일 확인
poetry show --outdated # 오래된 패키지 표시
poetry update # 패키지 업데이트
Cargo:
cargo audit # 취약점 감사
cargo outdated # 오래된 패키지 확인
cargo update # 패키지 업데이트