
Schutz vor bösartigen Open-Source-Paketen 🤖
<p align="center">
<a href="https://safedep.io">
<picture>
<source srcset="docs/assets/vet-banner-dark.svg" media="(prefers-color-scheme: dark)">
<source srcset="docs/assets/vet-banner-light.svg" media="(prefers-color-scheme: light)">
<img src="https://raw.githubusercontent.com/safedep/vet/HEAD/docs/assets/vet-banner-light.svg" alt="SafeDep vet" width="100%">
</picture>
</a>
</p>
<p align="center">
<strong>Finden Sie bösartige Pakete, Schwachstellen und riskante CI-Workflows, bevor sie die Produktion erreichen.</strong>
</p>
<div align="center">
[](https://github.com/safedep/vet/releases)
[](https://github.com/safedep/vet/actions/workflows/release-edge.yml)
[](https://scorecard.dev/viewer/?uri=github.com/safedep/vet)
[](LICENSE)
[](https://discord.gg/kAGEj25dCn)
[Installation](https://github.com/safedep/vet/blob/v2/docs/install.md) • [Dokumentation](https://github.com/safedep/vet/blob/v2/docs/README.md) • [Befehle](https://github.com/safedep/vet/blob/v2/docs/cmd/README.md) • [Richtlinien](https://github.com/safedep/vet/blob/v2/docs/policy.md) • [Discord](https://discord.gg/kAGEj25dCn)
</div>
> [!NOTE]
> Dieser Branch ist vet v2, in der Alpha-Phase. vet v1 befindet sich auf [`main`](https://github.com/safedep/vet/tree/main)
> und bleibt die neueste Version. Die [v2.0.0-Versionshinweise](https://github.com/safedep/vet/blob/v2/docs/release-notes/v2.0.0.md) ordnen jeden
> v1-Befehl und jedes Flag der v2 zu.
## Warum vet
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.
- **Bösartige Pakete.** vet prüft jedes Paket gegen SafeDep Threat Intel. Threat Intel
analysiert neue Paketversionen, sobald die Registries sie veröffentlichen.
- **Bekannte Schwachstellen**, mit der festen Version, auf die aktualisiert werden sollte.
- **Riskante Workflows.** Gefährliche Trigger, Template-Injection, offengelegte Secrets und Actions ohne
angehefteten Commit-SHA.
- **Manipulierte Lockfiles und frische Versionen.** Einträge aus einer nicht vertrauenswürdigen Registry und Versionen
innerhalb des Cooldown-Fensters.
- **Policy as Code.** Regeln in CEL entscheiden, wann ein Scan fehlschlägt. Sie können eine Regel an einem gespeicherten Scan testen.
- **KI- und Krypto-Inventar.** vet listet die KI-Bibliotheken und die Krypto-Algorithmen auf, die Ihr Code
aufruft, und schreibt ein CycloneDX xBOM und CBOM.
vet benötigt kein Konto und sendet keinen Quellcode.
## Schnellstart
```bash
brew install --cask safedep/tap/vet@edge
vet scan
```
<p align="center">
<img src="https://assets.kitploit.com/production/public/readmes/9305/e78ce751ceea5661932de2ddd8ed52dd2b1d1b0f1f79441b15800ea643294aef/f126560b445a95d013a838cb90493b21597a57d917fef6c3b1fb82f8c60f4e9d-display-v1.webp" alt="vet scan findet ein bösartiges Paket, Schwachstellen und Workflow-Injection" width="100%">
</p>
```bash
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
```
## Installation
| 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](https://github.com/safedep/vet/blob/v2/docs/install.md) enthält den
Befehl für den neuesten Build, die Release-Binaries und die Build-Attestierungen.
## Was vet scannt
| 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](https://github.com/safedep/vet/blob/v2/docs/controls.md).
## Policy
Eine Policy entscheidet, wann ein Scan fehlschlägt. Speichern Sie diese Datei als `vet-policy.yml`:
```yaml
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:
```bash
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](https://github.com/safedep/vet/blob/v2/docs/policy.md) für die Regelfelder, weitere Regeln und den
[Agent Skill](https://github.com/safedep/vet/blob/v2/.claude/skills/vet-policy-authoring/SKILL.md), der eine Policy für dich schreibt.
## Anwendungsfälle
- **Pull-Request-Prüfung.** Die [vet GitHub Action](https://github.com/safedep/vet/blob/v2/docs/github-action.md) kommentiert einen Pull
Request, der ein Paket, einen Workflow oder einen Fund hinzufügt, und lässt die Prüfung bei einem Angriff fehlschlagen. `vet ci init` fügt sie einem Repository hinzu.
- **CI-Gate.** Exit-Codes, SARIF für GitHub Code Scanning, GitLab- und Bitbucket-Berichte. Siehe
[ci.md](https://github.com/safedep/vet/blob/v2/docs/ci.md).
- **Pull-Request-Review.** `--base-ref` meldet nur die Pakete und Workflows, die eine Änderung hinzufügt.
- **xBOM und CBOM.** Ein CycloneDX-1.7-Inventar der KI-Bibliotheken und der Kryptografie, die dein Code
verwendet. Siehe [inventory.md](https://github.com/safedep/vet/blob/v2/docs/inventory.md).
- **KI-Agenten.** vet findet Claude Code und andere Agenten und schreibt dann JSON und fragt nie nach.
- **Endpoint-Audit.** `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.
## Dokumentation
| Seite | Wofür du sie liest |
| --- | --- |
| [Install](https://github.com/safedep/vet/blob/v2/docs/install.md) | Alle Kanäle und wie du ein Release verifizierst |
| [Commands](https://github.com/safedep/vet/blob/v2/docs/cmd/README.md) | Jeder Befehl, seine Flags und seine Exit-Codes |
| [Controls](https://github.com/safedep/vet/blob/v2/docs/controls.md) | Die Controls und ihre Optionen |
| [Policy](https://github.com/safedep/vet/blob/v2/docs/policy.md) | Regeln, Unterdrückungen und das Gate |
| [Output](https://github.com/safedep/vet/blob/v2/docs/output.md) | Berichtsformate, gespeicherte Scans und Konfiguration |
| [CI and AI agents](https://github.com/safedep/vet/blob/v2/docs/ci.md) | GitHub Actions, GitLab, Bitbucket und Agent-Modus |
| [Inventory](https://github.com/safedep/vet/blob/v2/docs/inventory.md) | Code-Nutzung, KI und Kryptografie, xBOM und CBOM |
## Datenschutz
vet sendet die Identität jedes Pakets (sein Ökosystem, seinen Namen und seine Version) an SafeDep, um die Daten
dazu zu erhalten. vet sendet keinen Quellcode und keinen Dateiinhalt.
Mit Anmeldedaten sendet `vet endpoint audit` außerdem das Inventar der Maschine an SafeDep Cloud: die
KI-Tools, MCP-Server, Skills und Erweiterungen, ihre Konfigurationspfade und den Benutzernamen jedes Home-
Verzeichnisses. Unter macOS und Linux sendet vet außerdem die uid jedes Home-Verzeichnisses. Ein MCP-Server-Datensatz
enthält seinen Befehl, seine Argumente und seine URL mit geschwärzten bekannten Geheimnissen sowie die Namen seiner
Variablen und Header, niemals deren Werte.
`plugins.cloud-inventory.enabled: false` schaltet dies ab.
## Community
- Stelle Fragen und teile Ideen auf [Discord](https://discord.gg/kAGEj25dCn) oder in
[GitHub Discussions](https://github.com/safedep/vet/discussions).
- Melde einen Fehler im [Issue-Tracker](https://github.com/safedep/vet/issues).
- Lies den [Contributing-Leitfaden](https://github.com/safedep/vet/blob/v2/CONTRIBUTING.md), bevor du einen Pull Request öffnest.
vet läuft auch in der Cloud. [SafeDep Cloud](https://safedep.io/) führt vet auf deinen Repositories aus, ohne
dass du Infrastruktur verwalten musst. Mit Anmeldedaten sendet `vet endpoint audit` die KI-Tools, MCP-Server
und Erweiterungen jeder Maschine an SafeDep Cloud.
<a href="https://github.com/safedep/vet/graphs/contributors">
<img src="https://contrib.rocks/image?repo=safedep/vet" alt="Contributors to vet" />
</a>