OSV (Open Source Vulnerabilities)
OSV est un format de données ouvert pour les avis de vulnérabilités et une base gratuite, OSV.dev, qui rassemble dans ce format les avis des paquets open source issus de GitHub, PyPI, RustSec, Go, des distributions Linux et d'autres.
Dernière mise à jour : 13 novembre 2026
OSV signifie Open Source Vulnerabilities. Le nom recouvre deux choses : le schéma OSV, un format JSON ouvert qui décrit une vulnérabilité en fonction des paquets et des versions qu'elle touche, et OSV.dev, une base de données et une API gratuites qui rassemblent dans ce format les avis de nombreuses sources. Là où une fiche CVE nomme une vulnérabilité, une fiche OSV répond à la question que se pose réellement un développeur : la version de ce paquet que j'utilise est-elle touchée ?
Qui gère OSV
Google a lancé OSV en février 2021, en commençant par les vulnérabilités trouvées par son service de fuzzing OSS-Fuzz. Le schéma est désormais maintenu dans le dépôt osv-schema de l'Open Source Security Foundation et s'appelle l'OpenSSF vulnerability format ; la base de données et son infrastructure sont open source dans google/osv.dev.
OSV.dev ne rédige pas la plupart de ses avis. Il agrège des bases qui publient au format OSV, comme la GitHub Advisory Database, les bases de PyPI et de la Python Software Foundation, la Go Vulnerability Database, RustSec, OpenSSF Malicious Packages, Ubuntu, Red Hat, Chainguard et Android. Pour Debian, Alpine et les CVE de la NVD concernant des logiciels open source, l'équipe d'OSV.dev convertit elle-même les données sources (sources de données).
Les préfixes d'ID OSV
Chaque fiche OSV a un ID de la forme <DB>-<ENTRYID>, où le préfixe désigne la base qui l'a publiée. Quelques-uns des préfixes définis dans le schéma :
| Préfixe | Base de données | Exemple d'ID |
|---|---|---|
| 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 | Fiches de la NVD converties par OSV.dev | CVE-2021-44228 |
| OSV | Attribués par OSV.dev, actuellement pour OSS-Fuzz uniquement | OSV-2020-111 |
Une même vulnérabilité a souvent plusieurs fiches, une par source. Le champ aliases les relie : GHSA-jfh8-c2jp-5v3q, l'avis GitHub pour Log4Shell, indique CVE-2021-44228 comme alias, si bien que les outils peuvent ne la compter qu'une fois. Les fiches MAL- sont d'une autre nature : elles décrivent des paquets malveillants, qui n'ont pas de version corrigée.
À quoi ressemble une fiche OSV
Le cœur d'une fiche est la liste affected : pour chaque paquet, son écosystème, son nom et les plages de versions vulnérables, avec des événements qui indiquent où une plage a été introduced et où elle a été fixed. Voici GHSA-jfh8-c2jp-5v3q, réduite à l'une de ses plages :
{
"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" }]
}]
}]
}
Les plages peuvent être de type SEMVER, ECOSYSTEM (l'ordre de versions propre à l'écosystème, comme pour PyPI ou Debian) ou GIT, qui donne des hashs de commit. Les plages Git permettent à OSV.dev de rattacher une vulnérabilité à un commit dans du code C et C++ qui n'a aucun gestionnaire de paquets.
OSV, NVD et CVE
| Question | Fiche CVE | NVD | OSV |
|---|---|---|---|
| Ce que c'est | ID et fiche courte | Base du NIST qui enrichit les CVE | Format plus base de données agrégée |
| Identifie le logiciel par | Texte libre éditeur et produit | Noms CPE | Écosystème et nom du paquet, ou un dépôt Git |
| Versions touchées | Telles que la CNA les a rédigées | Plages de versions CPE | Plages lisibles par machine dans le schéma de versions propre à chaque écosystème |
| Couvre des avis sans CVE | Non | Non | Oui, comme de nombreuses fiches RUSTSEC, PYSEC et MAL |
| Idéal pour | Nommer une vulnérabilité | Produits commerciaux et propriétaires | Dépendances open source |
Comme OSV est indexé par écosystème et par paquet, il correspond directement à un lockfile ou au package URL d'un composant dans un SBOM, sans les approximations qu'implique la mise en correspondance d'un paquet avec un CPE. Il est moins adapté aux produits propriétaires et aux appliances, qui n'ont pas d'écosystème de paquets et sont décrits dans la NVD.
L'API OSV et osv-scanner
L'API à l'adresse https://api.osv.dev est gratuite, et sa documentation n'indique aucune limite d'utilisation. Une requête par paquet et version :
curl -d '{"package": {"name": "nokogiri", "ecosystem": "RubyGems"}, "version": "1.18.2"}' \
"https://api.osv.dev/v1/query"
/v1/querybatch vérifie de nombreux paquets en une seule requête, et /v1/vulns/{id} renvoie une fiche. La base complète peut aussi être téléchargée par écosystème.
OSV-Scanner, annoncé en décembre 2022, est l'interface en ligne de commande de Google pour la base. Il analyse les lockfiles, les SBOM, les répertoires et les images de conteneurs, et signale les fiches OSV correspondantes.
Le rapport avec CRACI
CRACI affiche les avis de chaque paquet, avec leurs identifiants CVE, GHSA et autres et leur gravité, pour les composants enregistrés dans chaque build. Pour ce qu'un SBOM doit contenir avant qu'une base puisse le rapprocher, voir SBOM au moment du build.