vet v1.19.0 — Protect against malicious open source packages 🤖

악성 패키지, 취약점, 위험한 CI 워크플로를 프로덕션에 도달하기 전에 찾아냅니다.

[!NOTE] 이 브랜치는 알파 단계의 vet v2입니다. vet v1은 main에 있으며 최신 릴리스로 유지됩니다. v2.0.0 릴리스 노트에서 각 v1 명령과 플래그가 v2에서 어떻게 대응되는지 확인할 수 있습니다.

vet을 사용하는 이유

여러분의 의존성, GitHub Actions 워크플로, AI 에이전트 설정은 여러분이 작성하지 않은 코드를 실행합니다. vet은 그 안에서 위험을 찾아냅니다.

악성 패키지. vet은 각 패키지를 SafeDep Threat Intel과 대조하여 검사합니다. Threat Intel은 레지스트리가 새 패키지 버전을 게시할 때 해당 버전을 분석합니다.
알려진 취약점, 그리고 업그레이드해야 할 수정 버전.
위험한 워크플로. 위험한 트리거, 템플릿 인젝션, 노출된 시크릿, 커밋 SHA가 고정되지 않은 액션.
락파일 변조 및 최신 버전. 신뢰할 수 없는 레지스트리에서 온 항목과 쿨다운 기간 내에 있는 버전.
코드로서의 정책. CEL 규칙이 스캔 실패 여부를 결정합니다. 저장된 스캔에 대해 규칙을 테스트할 수 있습니다.
AI 및 암호화 인벤토리. vet은 여러분의 코드가 호출하는 AI 라이브러리와 암호화 알고리즘을 나열하고, CycloneDX xBOM 및 CBOM을 작성합니다.

vet은 계정이 필요 없으며 소스 코드를 전송하지 않습니다.

빠른 시작

brew install --cask safedep/tap/vet@edge
vet scan

vet scan이 악성 패키지, 취약점 및 워크플로 인젝션을 탐지합니다

vet scan --fail-on high                         # exit 1 on a high or critical finding
vet scan --base-ref origin/main --fail-on high  # report only what a pull request changes
vet report show --report sarif=vet.sarif        # write SARIF from the saved scan, with no new scan

설치

채널	명령
Homebrew	`brew install --cask safedep/tap/vet@edge`
mise	`mise use -g 'github:safedep/vet[prerelease=true]@2'`
Go	`go install github.com/safedep/vet/v2/cmd/vet@latest`
컨테이너	`docker run --rm -v "$PWD:/src" -w /src ghcr.io/safedep/vet:v2-latest scan`

mise는 릴리스가 게시된 후 하루 뒤에 설치합니다. install.md에는 최신 빌드, 릴리스 바이너리 및 빌드 증명(attestation)을 위한 명령이 있습니다.

vet이 스캔하는 대상

대상	예시
디렉터리 (기본값)	`vet scan`, `vet scan ./service`
git 저장소	`vet scan https://github.com/safedep/vet`
컨테이너 이미지	`vet scan oci://alpine:3.20`, `vet scan image.tar`
SBOM (CycloneDX 또는 SPDX)	`vet scan sbom.cdx.json`
단일 패키지	`vet scan pkg:npm/[email protected]`
이 머신의 도구들	`vet endpoint audit`

vet은 npm, PyPI, Go, Maven, Gradle, Cargo, RubyGems, NuGet, Packagist, Pub 등의 lockfile과 manifest를 읽습니다. 또한 대상의 GitHub Actions 워크플로와 AI 에이전트 설정도 읽습니다. 이들 중 어느 것도 설치하거나 실행하지 않습니다. 컨트롤(control)이 이 데이터를 발견 사항(finding)으로 전환합니다. controls.md를 참조하세요.

정책

정책은 스캔이 실패하는 시점을 결정합니다. 이 파일을 vet-policy.yml로 저장하세요:

version: 2
rules:
  - id: no-malware
    description: A malicious or suspicious package fails the build.
    when: finding.family == "malware"
    action: fail
  - id: no-workflow-injection
    when: finding.control_id in ["dangerous-trigger", "template-injection"]
    action: fail
  - id: no-critical-vulnerability
    when: finding.control_id == "vulnerability" && finding.severity == "critical"
    action: fail
  - id: new-dependency-age
    description: A pull request cannot add a version that is less than 14 days old.
    when: package.change == "ADDED" && has(package.days_since_publish) && package.days_since_publish < 14
    action: fail
suppressions:
  - purl: pkg:npm/[email protected]
    reason: The upgrade to 4.18.1 is in pull request 42.
    expires: 2026-12-31

마지막 스캔에서 새 스캔 없이 테스트하세요. 그런 다음 풀 리퀘스트에 적용하세요:

vet report show last --policy vet-policy.yml
vet scan --base-ref origin/main --policy vet-policy.yml

만료일이 지나면 해당 억제는 더 이상 발견 사항을 숨기지 않습니다. 규칙 필드, 더 많은 규칙, 그리고 정책 작성을 대신해 주는 Agent Skill에 대해서는 policy.md를 참고하세요.

사용 사례

풀 리퀘스트 검사. vet GitHub Action은 패키지, 워크플로 또는 발견 사항을 추가하는 풀 리퀘스트에 댓글을 달고, 공격이 있으면 검사를 실패시킵니다. vet ci init이 이를 저장소에 추가합니다.
CI 게이트. 종료 코드, GitHub 코드 스캐닝용 SARIF, GitLab 및 Bitbucket 보고서. ci.md를 참고하세요.
풀 리퀘스트 리뷰. --base-ref는 변경 사항이 추가한 패키지와 워크플로만 보고합니다.
xBOM 및 CBOM. 코드에서 사용하는 AI 라이브러리와 암호화에 대한 CycloneDX 1.7 인벤토리. inventory.md를 참고하세요.
AI 에이전트. vet은 Claude Code 및 기타 에이전트를 찾아낸 뒤 JSON을 작성하며 프롬프트를 표시하지 않습니다.
엔드포인트 감사. vet endpoint audit는 개발자 머신에 있는 AI 도구, MCP 서버, 편집기 확장 및 전역 npm 패키지를 나열하고 악성코드 여부를 검사합니다.

문서

페이지	참고 용도
설치	모든 채널과 릴리스 검증 방법
명령어	모든 명령어, 해당 플래그 및 종료 코드
컨트롤	컨트롤과 해당 옵션
정책	규칙, 억제 및 게이트
출력	보고서 형식, 저장된 스캔 및 구성
CI 및 AI 에이전트	GitHub Actions, GitLab, Bitbucket 및 에이전트 모드
인벤토리	코드 사용, AI 및 암호화, xBOM 및 CBOM

개인정보

vet은 각 패키지의 식별 정보(생태계, 이름 및 버전)를 SafeDep에 전송하여 해당 패키지에 대한 데이터를 받습니다. vet은 소스 코드나 파일 내용을 전송하지 않습니다.

자격 증명이 있는 경우, vet endpoint audit는 머신의 인벤토리도 SafeDep Cloud에 전송합니다. 여기에는 AI 도구, MCP 서버, 스킬 및 확장, 해당 구성 경로, 그리고 각 홈 디렉터리의 사용자 이름이 포함됩니다. macOS 및 Linux에서 vet은 각 홈 디렉터리의 uid도 전송합니다. MCP 서버 레코드에는 명령, 인수, 알려진 비밀이 마스킹된 URL, 그리고 변수 및 헤더의 이름이 포함되며, 값은 절대 포함되지 않습니다. plugins.cloud-inventory.enabled: false로 이 기능을 끌 수 있습니다.

커뮤니티

Discord 또는 GitHub Discussions에서 질문하고 아이디어를 공유하세요.
버그는 이슈 트래커에 보고하세요.
풀 리퀘스트를 열기 전에 기여 가이드를 읽어 보세요.

vet은 클라우드에서도 실행됩니다. SafeDep Cloud는 관리할 인프라 없이 저장소에서 vet을 실행합니다. 자격 증명이 있는 경우, vet endpoint audit는 각 머신의 AI 도구, MCP 서버 및 확장을 SafeDep Cloud에 전송합니다.