
Proteggiti da pacchetti open source dannosi 🤖
<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>Individua pacchetti malevoli, vulnerabilità e workflow CI rischiosi prima che raggiungano la produzione.</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)
[Installazione](https://github.com/safedep/vet/blob/v2/docs/install.md) • [Documentazione](https://github.com/safedep/vet/blob/v2/docs/README.md) • [Comandi](https://github.com/safedep/vet/blob/v2/docs/cmd/README.md) • [Policy](https://github.com/safedep/vet/blob/v2/docs/policy.md) • [Discord](https://discord.gg/kAGEj25dCn)
</div>
> [!NOTE]
> Questo branch è vet v2, in alpha. vet v1 si trova su [`main`](https://github.com/safedep/vet/tree/main)
> e rimane l'ultima release. Le [note di rilascio v2.0.0](https://github.com/safedep/vet/blob/v2/docs/release-notes/v2.0.0.md) mappano ogni
> comando e flag di v1 su v2.
## Perché vet
Le tue dipendenze, i tuoi workflow GitHub Actions e le configurazioni dei tuoi agenti AI eseguono codice che
non hai scritto. vet individua il rischio in essi.
- **Pacchetti malevoli.** vet verifica ogni pacchetto rispetto a SafeDep Threat Intel. Threat Intel
analizza le nuove versioni dei pacchetti quando i registry le pubblicano.
- **Vulnerabilità note**, con la versione corretta a cui aggiornare.
- **Workflow rischiosi.** Trigger pericolosi, template injection, segreti esposti e action senza
commit SHA fissato.
- **Manomissione dei lockfile e versioni recenti.** Voci provenienti da un registry non attendibile e versioni
all'interno della finestra di cooldown.
- **Policy as code.** Regole in CEL decidono quando una scansione fallisce. Puoi testare una regola su una scansione salvata.
- **Inventario AI e crypto.** vet elenca le librerie AI e gli algoritmi crittografici che il tuo codice
richiama, e scrive un CycloneDX xBOM e CBOM.
vet non richiede alcun account e non invia codice sorgente.
## Avvio rapido
```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 rileva un pacchetto malevolo, vulnerabilità e injection nel workflow" 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
```
## Installazione
| Canale | Comando |
| --- | --- |
| 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 installa una release un giorno dopo la sua pubblicazione. [install.md](https://github.com/safedep/vet/blob/v2/docs/install.md) contiene il
comando per la build più recente, i binari di release e le attestazioni di build.
## Cosa analizza vet
| Target | Esempio |
| --- | --- |
| Una directory (l'impostazione predefinita) | `vet scan`, `vet scan ./service` |
| Un repository git | `vet scan https://github.com/safedep/vet` |
| Un'immagine container | `vet scan oci://alpine:3.20`, `vet scan image.tar` |
| Un SBOM (CycloneDX o SPDX) | `vet scan sbom.cdx.json` |
| Un singolo pacchetto | `vet scan pkg:npm/[email protected]` |
| Gli strumenti presenti su questa macchina | `vet endpoint audit` |
vet legge i lockfile e i manifest di npm, PyPI, Go, Maven, Gradle, Cargo, RubyGems, NuGet,
Packagist, Pub e altri ancora. Legge inoltre i workflow di GitHub Actions e le configurazioni degli agenti AI del
target. Non ne installa né ne esegue alcuno. I controlli trasformano questi dati in risultati. Vedi
[controls.md](https://github.com/safedep/vet/blob/v2/docs/controls.md).
## Policy
Una policy stabilisce quando una scansione fallisce. Salva questo file come `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
```
Testalo sull'ultima scansione, senza una nuova scansione. Poi applicalo a una pull request:
```bash
vet report show last --policy vet-policy.yml
vet scan --base-ref origin/main --policy vet-policy.yml
```
Dopo la data di scadenza, la soppressione non nasconde più il finding. Leggi
[policy.md](https://github.com/safedep/vet/blob/v2/docs/policy.md) per i campi delle regole, ulteriori regole e la
[Agent Skill](https://github.com/safedep/vet/blob/v2/.claude/skills/vet-policy-authoring/SKILL.md) che scrive una policy per te.
## Casi d'uso
- **Controllo delle pull request.** La [vet GitHub Action](https://github.com/safedep/vet/blob/v2/docs/github-action.md) commenta su una pull
request che aggiunge un pacchetto, un workflow o un finding, e fa fallire il controllo in caso di attacco. `vet ci init` la aggiunge a un repository.
- **Gate CI.** Codici di uscita, SARIF per GitHub code scanning, report GitLab e Bitbucket. Vedi
[ci.md](https://github.com/safedep/vet/blob/v2/docs/ci.md).
- **Revisione delle pull request.** `--base-ref` segnala solo i pacchetti e i workflow che una modifica aggiunge.
- **xBOM e CBOM.** Un inventario CycloneDX 1.7 delle librerie AI e della crittografia che il tuo codice
utilizza. Vedi [inventory.md](https://github.com/safedep/vet/blob/v2/docs/inventory.md).
- **Agenti AI.** vet rileva Claude Code e altri agenti, poi scrive JSON e non chiede mai input.
- **Audit degli endpoint.** `vet endpoint audit` elenca gli strumenti AI, i server MCP, le estensioni dell'editor e
i pacchetti npm globali su una macchina dello sviluppatore, e li controlla alla ricerca di malware.
## Documentazione
| Pagina | Leggila per |
| --- | --- |
| [Install](https://github.com/safedep/vet/blob/v2/docs/install.md) | Tutti i canali e come verificare una release |
| [Commands](https://github.com/safedep/vet/blob/v2/docs/cmd/README.md) | Ogni comando, i suoi flag e i suoi codici di uscita |
| [Controls](https://github.com/safedep/vet/blob/v2/docs/controls.md) | I controlli e le loro opzioni |
| [Policy](https://github.com/safedep/vet/blob/v2/docs/policy.md) | Regole, soppressioni e il gate |
| [Output](https://github.com/safedep/vet/blob/v2/docs/output.md) | Formati dei report, scansioni salvate e configurazione |
| [CI and AI agents](https://github.com/safedep/vet/blob/v2/docs/ci.md) | GitHub Actions, GitLab, Bitbucket e modalità agente |
| [Inventory](https://github.com/safedep/vet/blob/v2/docs/inventory.md) | Utilizzo del codice, AI e crittografia, xBOM e CBOM |
## Privacy
vet invia l'identità di ciascun pacchetto (il suo ecosistema, nome e versione) a SafeDep per ottenere i dati
che lo riguardano. vet non invia codice sorgente né contenuto dei file.
Con le credenziali, `vet endpoint audit` invia anche l'inventario della macchina a SafeDep Cloud: gli
strumenti AI, i server MCP, le skill e le estensioni, i loro percorsi di configurazione e il nome utente di ciascuna
home directory. Su macOS e Linux, vet invia anche l'uid di ciascuna home directory. Il record di un server MCP
contiene il suo comando, i suoi argomenti e il suo URL con i segreti noti oscurati, e i nomi delle sue
variabili e header, mai i loro valori.
`plugins.cloud-inventory.enabled: false` disattiva questa funzione.
## Community
- Fai domande e condividi idee su [Discord](https://discord.gg/kAGEj25dCn) o nelle
[GitHub Discussions](https://github.com/safedep/vet/discussions).
- Segnala un bug nell'[issue tracker](https://github.com/safedep/vet/issues).
- Leggi la [guida alla contribuzione](https://github.com/safedep/vet/blob/v2/CONTRIBUTING.md) prima di aprire una pull request.
vet funziona anche nel cloud. [SafeDep Cloud](https://safedep.io/) esegue vet sui tuoi repository, senza
infrastruttura da gestire. Con le credenziali, `vet endpoint audit` invia gli strumenti AI, i server MCP
e le estensioni di ciascuna macchina a 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>