
Schutz vor bösartigen Open-Source-Paketen 🤖
Finden Sie bösartige Pakete, Schwachstellen und riskante CI-Workflows, bevor sie die Produktion erreichen.
[!NOTE] Dieser Branch ist vet v2, in der Alpha-Phase. vet v1 befindet sich auf
mainund bleibt die neueste Version. Die v2.0.0-Versionshinweise ordnen jeden v1-Befehl und jedes Flag der v2 zu.
Ihre Abhängigkeiten, Ihre GitHub Actions-Workflows und Ihre KI-Agent-Konfigurationen führen Code aus, den Sie nicht geschrieben haben. vet findet die Risiken darin.
vet benötigt kein Konto und sendet keinen Quellcode.
brew install --cask safedep/tap/vet@edge
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
| Kanal | Befehl |
|---|---|
| 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 |
| Container | docker run --rm -v "$PWD:/src" -w /src ghcr.io/safedep/vet:v2-latest scan |
mise installiert ein Release einen Tag nach dessen Veröffentlichung. install.md enthält den Befehl für den neuesten Build, die Release-Binaries und die Build-Attestierungen.
| Ziel | Beispiel |
|---|---|
| Ein Verzeichnis (der Standard) | vet scan, vet scan ./service |
| Ein Git-Repository | vet scan https://github.com/safedep/vet |
| Ein Container-Image | vet scan oci://alpine:3.20, vet scan image.tar |
| Eine SBOM (CycloneDX oder SPDX) | vet scan sbom.cdx.json |
| Ein Paket | vet scan pkg:npm/[email protected] |
| Die Tools auf dieser Maschine | vet endpoint audit |
vet liest die Lockfiles und Manifeste von npm, PyPI, Go, Maven, Gradle, Cargo, RubyGems, NuGet, Packagist, Pub und weiteren. Es liest außerdem die GitHub Actions Workflows und die AI-Agent-Konfigurationen des Ziels. Es installiert oder führt keines davon aus. Controls verwandeln diese Daten in Findings. Siehe controls.md.
Eine Policy entscheidet, wann ein Scan fehlschlägt. Speichern Sie diese Datei als 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
Testen Sie es mit dem letzten Scan, ohne einen neuen Scan. Wenden Sie es dann auf einen Pull Request an:
vet report show last --policy vet-policy.yml
vet scan --base-ref origin/main --policy vet-policy.yml
Nach Ablauf des Gültigkeitsdatums verbirgt die Unterdrückung den Fund nicht mehr. Lies policy.md für die Regelfelder, weitere Regeln und den Agent Skill, der eine Policy für dich schreibt.
vet ci init fügt sie einem Repository hinzu.--base-ref meldet nur die Pakete und Workflows, die eine Änderung hinzufügt.vet endpoint audit listet die KI-Tools, MCP-Server, Editor-Erweiterungen und
globalen npm-Pakete auf einem Entwicklerrechner auf und prüft sie auf Malware.