OSV (Open Source Vulnerabilities)
OSV è un formato di dati aperto per gli advisory di vulnerabilità e un database gratuito, OSV.dev, che raccoglie in quel formato gli advisory per i pacchetti open source da GitHub, PyPI, RustSec, Go, distribuzioni Linux e altre fonti.
Ultimo aggiornamento: 13 novembre 2026
OSV sta per Open Source Vulnerabilities. Il nome indica due cose: lo schema OSV, un formato JSON aperto per descrivere una vulnerabilità in termini di pacchetti e versioni colpiti, e OSV.dev, un database e un'API gratuiti che raccolgono in quel formato gli advisory di molte fonti. Mentre una scheda CVE dà un nome a una vulnerabilità, una voce OSV risponde alla domanda che uno sviluppatore si pone davvero: la versione di questo pacchetto che uso è colpita?
Chi gestisce OSV
Google ha lanciato OSV a febbraio 2021, partendo dalle vulnerabilità trovate dal suo servizio di fuzzing OSS-Fuzz. Lo schema è ora mantenuto nel repository osv-schema della Open Source Security Foundation e si chiama OpenSSF vulnerability format; il database e la sua infrastruttura sono open source in google/osv.dev.
OSV.dev non scrive la maggior parte dei suoi advisory. Aggrega database che pubblicano nel formato OSV, come il GitHub Advisory Database, i database di PyPI e della Python Software Foundation, il Go Vulnerability Database, RustSec, OpenSSF Malicious Packages, Ubuntu, Red Hat, Chainguard e Android. Per Debian, Alpine e le CVE della NVD relative a software open source, il team di OSV.dev converte direttamente i dati di origine (fonti dei dati).
Prefissi degli ID OSV
Ogni voce OSV ha un ID della forma <DB>-<ENTRYID>, in cui il prefisso indica il database che l'ha pubblicata. Alcuni dei prefissi definiti nello schema:
| Prefisso | Database | ID di esempio |
|---|---|---|
| GHSA | GitHub Advisory Database | GHSA-jfh8-c2jp-5v3q |
| PYSEC | PyPI Vulnerability Database | PYSEC-2021-123 |
| RUSTSEC | RustSec Advisory Database (crates.io) | RUSTSEC-2021-0001 |
| GO | Go Vulnerability Database | GO-2022-0236 |
| MAL | OpenSSF Malicious Packages | MAL-2025-1234 |
| CVE | Schede NVD convertite da OSV.dev | CVE-2021-44228 |
| OSV | Assegnati da OSV.dev, attualmente solo per OSS-Fuzz | OSV-2020-111 |
La stessa vulnerabilità ha spesso più voci, una per fonte. Il campo aliases le collega: GHSA-jfh8-c2jp-5v3q, l'advisory GitHub per Log4Shell, elenca CVE-2021-44228 come suo alias, così gli strumenti possono contarla una sola volta. Le voci MAL- sono di natura diversa: descrivono pacchetti malevoli, che non hanno una versione corretta.
Com'è fatta una voce OSV
Il cuore di una voce è l'elenco affected: per ogni pacchetto, il suo ecosistema, il suo nome e gli intervalli di versioni vulnerabili, con eventi che indicano dove un intervallo è stato introduced e dove è stato fixed. Ecco GHSA-jfh8-c2jp-5v3q, ridotta a uno dei suoi intervalli:
{
"schema_version": "1.9.0",
"id": "GHSA-jfh8-c2jp-5v3q",
"aliases": ["CVE-2021-44228"],
"summary": "Remote code injection in Log4j",
"published": "2021-12-10T00:40:56Z",
"affected": [{
"package": {
"ecosystem": "Maven",
"name": "org.apache.logging.log4j:log4j-core",
"purl": "pkg:maven/org.apache.logging.log4j/log4j-core"
},
"ranges": [{
"type": "ECOSYSTEM",
"events": [{ "introduced": "2.13.0" }, { "fixed": "2.15.0" }]
}]
}]
}
Gli intervalli possono essere SEMVER, ECOSYSTEM (l'ordinamento delle versioni proprio dell'ecosistema, come per PyPI o Debian) oppure GIT, che indica hash di commit. Gli intervalli Git permettono a OSV.dev di associare una vulnerabilità a un commit nel codice C e C++ che non ha alcun package manager.
OSV, NVD e CVE a confronto
| Domanda | Scheda CVE | NVD | OSV |
|---|---|---|---|
| Che cos'è | ID e breve scheda | Database del NIST che arricchisce le CVE | Formato più database aggregato |
| Identifica il software tramite | Testo con vendor e prodotto | Nomi CPE | Ecosistema e nome del pacchetto, oppure un repository Git |
| Versioni colpite | Come le ha scritte la CNA | Intervalli di versioni CPE | Intervalli leggibili dalle macchine nello schema di versioni di ogni ecosistema |
| Copre advisory senza CVE | No | No | Sì, come molte voci RUSTSEC, PYSEC e MAL |
| Ideale per | Dare un nome a una vulnerabilità | Prodotti commerciali e closed source | Dipendenze open source |
Poiché OSV è indicizzato per ecosistema e pacchetto, si allinea direttamente con un lockfile o con il package URL di un componente in una SBOM, senza dover indovinare la corrispondenza tra un pacchetto e un CPE. È più debole per i prodotti closed source e le appliance, che non hanno un ecosistema di pacchetti e sono descritti nella NVD.
L'API OSV e osv-scanner
L'API su https://api.osv.dev è gratuita, e la sua documentazione non indica limiti di utilizzo. Una query per pacchetto e versione:
curl -d '{"package": {"name": "nokogiri", "ecosystem": "RubyGems"}, "version": "1.18.2"}' \
"https://api.osv.dev/v1/query"
/v1/querybatch verifica molti pacchetti in una sola richiesta, e /v1/vulns/{id} restituisce una singola voce. L'intero database si può anche scaricare per ecosistema.
OSV-Scanner, annunciato a dicembre 2022, è il front end a riga di comando di Google per il database. Scansiona lockfile, SBOM, directory e immagini di container e riporta le voci OSV corrispondenti.
Il rapporto con CRACI
CRACI mostra gli advisory di ogni pacchetto, con i relativi ID CVE, GHSA e altri e la loro gravità, per i componenti registrati in ogni build. Per sapere che cosa deve contenere una SBOM prima che un database possa trovarvi corrispondenze, si veda SBOM generate in fase di build.