OSV (Open Source Vulnerabilities)
OSV is een open dataformaat voor kwetsbaarheidsadvisories en een gratis database, OSV.dev, die advisories voor open-sourcepackages van GitHub, PyPI, RustSec, Go, Linux-distributies en anderen in dat formaat verzamelt.
Laatst bijgewerkt: 13 november 2026
OSV staat voor Open Source Vulnerabilities. De naam dekt twee dingen: het OSV-schema, een open JSON-formaat om een kwetsbaarheid te beschrijven in termen van de packages en versies die ze treft, en OSV.dev, een gratis database en API die advisories uit veel bronnen in dat formaat verzamelt. Waar een CVE-record een kwetsbaarheid benoemt, beantwoordt een OSV-record de vraag die een ontwikkelaar echt stelt: is de versie van dit package die ik gebruik getroffen?
Wie OSV beheert
Google lanceerde OSV in februari 2021, te beginnen met kwetsbaarheden die zijn fuzzingdienst OSS-Fuzz had gevonden. Het schema wordt nu onderhouden in de repository osv-schema van de Open Source Security Foundation en heet het OpenSSF vulnerability format; de database en de infrastructuur erachter zijn open source in google/osv.dev.
OSV.dev schrijft de meeste advisories niet zelf. Het verzamelt databases die in het OSV-formaat publiceren, zoals de GitHub Advisory Database, de databases van PyPI en de Python Software Foundation, de Go Vulnerability Database, RustSec, OpenSSF Malicious Packages, Ubuntu, Red Hat, Chainguard en Android. Voor Debian, Alpine en NVD-CVE's over open-sourcesoftware zet het OSV.dev-team de brondata zelf om (databronnen).
OSV-ID-voorvoegsels
Elk OSV-record heeft een ID van de vorm <DB>-<ENTRYID>, waarbij het voorvoegsel de database noemt die het heeft gepubliceerd. Enkele van de voorvoegsels die in het schema zijn gedefinieerd:
| Voorvoegsel | Database | Voorbeeld-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 | NVD-records omgezet door OSV.dev | CVE-2021-44228 |
| OSV | Toegekend door OSV.dev, momenteel alleen voor OSS-Fuzz | OSV-2020-111 |
Dezelfde kwetsbaarheid heeft vaak meerdere records, één per bron. Het veld aliases koppelt ze: GHSA-jfh8-c2jp-5v3q, de GitHub-advisory voor Log4Shell, vermeldt CVE-2021-44228 als alias, zodat tools haar één keer tellen. MAL--records zijn van een andere soort: ze beschrijven kwaadaardige packages, die geen gerepareerde versie hebben.
Hoe een OSV-record eruitziet
De kern van een record is de lijst affected: voor elk package het ecosysteem, de naam en de kwetsbare versiebereiken, met events die zeggen waar een bereik werd introduced en waar het werd fixed. Hier is GHSA-jfh8-c2jp-5v3q, ingekort tot één van de bereiken:
{
"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" }]
}]
}]
}
Bereiken kunnen SEMVER, ECOSYSTEM (de eigen versievolgorde van het ecosysteem, zoals bij PyPI of Debian) of GIT zijn, dat commithashes geeft. Met Git-bereiken kan OSV.dev een kwetsbaarheid koppelen aan een commit in C- en C++-code die helemaal geen package manager heeft.
OSV vs NVD en CVE
| Vraag | CVE-record | NVD | OSV |
|---|---|---|---|
| Wat het is | ID en kort record | NIST-database die CVE's verrijkt | Formaat plus verzameldatabase |
| Identificeert software aan de hand van | Leverancier- en producttekst | CPE-namen | Ecosysteem en packagenaam, of een Git-repo |
| Getroffen versies | Zoals de CNA ze schreef | CPE-versiebereiken | Machineleesbare bereiken in het eigen versieschema van elk ecosysteem |
| Dekt advisories zonder CVE | Nee | Nee | Ja, zoals veel RUSTSEC-, PYSEC- en MAL-records |
| Het best voor | Eén kwetsbaarheid benoemen | Commerciële en closed-sourceproducten | Open-sourceafhankelijkheden |
Omdat OSV is ingedeeld op ecosysteem en package, sluit het direct aan op een lockfile of op de package URL van een component in een SBOM, zonder het giswerk van een package aan een CPE koppelen. Het is zwakker voor closed-sourceproducten en appliances, die geen package-ecosysteem hebben en in de NVD worden beschreven.
De OSV-API en osv-scanner
De API op https://api.osv.dev is gratis, en de documentatie noemt geen gebruikslimieten. Een query op package en versie:
curl -d '{"package": {"name": "nokogiri", "ecosystem": "RubyGems"}, "version": "1.18.2"}' \
"https://api.osv.dev/v1/query"
/v1/querybatch controleert veel packages in één verzoek, en /v1/vulns/{id} geeft één record terug. De hele database is ook per ecosysteem te downloaden.
OSV-Scanner, aangekondigd in december 2022, is de commandlinefrontend van Google voor de database. Hij scant lockfiles, SBOM's, directory's en containerimages en meldt de OSV-records die overeenkomen.
Hoe CRACI zich ertoe verhoudt
CRACI toont de advisories van elk package, met hun CVE-, GHSA- en andere ID's en hun ernst, voor de componenten die in elke build zijn vastgelegd. Voor wat een SBOM moet bevatten voordat een database ermee kan matchen, zie build-time SBOMs.