OSV (Open Source Vulnerabilities)
OSV ist ein offenes Datenformat für Schwachstellen-Advisories und eine kostenlose Datenbank, OSV.dev, die Advisories zu Open-Source-Paketen von GitHub, PyPI, RustSec, Go, Linux-Distributionen und anderen in diesem Format sammelt.
Zuletzt aktualisiert: 13. November 2026
OSV steht für Open Source Vulnerabilities. Der Name umfasst zwei Dinge: das OSV-Schema, ein offenes JSON-Format, das eine Schwachstelle anhand der betroffenen Pakete und Versionen beschreibt, und OSV.dev, eine kostenlose Datenbank mit API, die Advisories aus vielen Quellen in diesem Format sammelt. Während ein CVE-Eintrag eine Schwachstelle benennt, beantwortet ein OSV-Eintrag die Frage, die Entwickler tatsächlich stellen: Ist die Version dieses Pakets, die ich nutze, betroffen?
Wer OSV betreibt
Google hat OSV im Februar 2021 gestartet, zunächst mit Schwachstellen, die sein Fuzzing-Dienst OSS-Fuzz gefunden hatte. Das Schema wird heute im Repository osv-schema der Open Source Security Foundation gepflegt und heißt OpenSSF Vulnerability Format; die Datenbank und ihre Infrastruktur sind Open Source unter google/osv.dev.
Die meisten Advisories schreibt OSV.dev nicht selbst. Es aggregiert Datenbanken, die im OSV-Format veröffentlichen, etwa die GitHub Advisory Database, die Datenbanken von PyPI und der Python Software Foundation, die Go Vulnerability Database, RustSec, OpenSSF Malicious Packages, Ubuntu, Red Hat, Chainguard und Android. Für Debian, Alpine und NVD-CVEs zu Open-Source-Software konvertiert das OSV.dev-Team die Quelldaten selbst (Datenquellen).
OSV-ID-Präfixe
Jeder OSV-Eintrag hat eine ID der Form <DB>-<ENTRYID>, wobei das Präfix die Datenbank nennt, die ihn veröffentlicht hat. Einige der im Schema definierten Präfixe:
| Präfix | Datenbank | Beispiel-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 | Von OSV.dev konvertierte NVD-Einträge | CVE-2021-44228 |
| OSV | Von OSV.dev vergeben, derzeit nur für OSS-Fuzz | OSV-2020-111 |
Dieselbe Schwachstelle hat oft mehrere Einträge, einen pro Quelle. Das Feld aliases verknüpft sie: GHSA-jfh8-c2jp-5v3q, das GitHub-Advisory zu Log4Shell, führt CVE-2021-44228 als Alias, sodass Tools sie nur einmal zählen. MAL--Einträge sind von anderer Art: Sie beschreiben bösartige Pakete, für die es keine behobene Version gibt.
Wie ein OSV-Eintrag aussieht
Kern eines Eintrags ist die Liste affected: für jedes Paket sein Ökosystem, sein Name und die verwundbaren Versionsbereiche, mit Ereignissen, die angeben, wo ein Bereich introduced und wo er fixed wurde. Hier ist GHSA-jfh8-c2jp-5v3q, gekürzt auf einen seiner Bereiche:
{
"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" }]
}]
}]
}
Bereiche können vom Typ SEMVER, ECOSYSTEM (die eigene Versionsordnung des Ökosystems, etwa bei PyPI oder Debian) oder GIT sein, der Commit-Hashes angibt. Git-Bereiche erlauben es OSV.dev, eine Schwachstelle einem Commit in C- und C++-Code zuzuordnen, der gar keinen Paketmanager hat.
OSV vs. NVD und CVE
| Frage | CVE-Eintrag | NVD | OSV |
|---|---|---|---|
| Was es ist | ID und kurzer Eintrag | NIST-Datenbank, die CVEs anreichert | Format plus aggregierte Datenbank |
| Identifiziert Software über | Hersteller- und Produkttext | CPE-Namen | Ökosystem und Paketname oder ein Git-Repository |
| Betroffene Versionen | Wie die CNA sie angegeben hat | CPE-Versionsbereiche | Maschinenlesbare Bereiche im eigenen Versionsschema jedes Ökosystems |
| Enthält Advisories ohne CVE | Nein | Nein | Ja, etwa viele RUSTSEC-, PYSEC- und MAL-Einträge |
| Am besten für | Benennung einer Schwachstelle | Kommerzielle und proprietäre Produkte | Open-Source-Abhängigkeiten |
Weil OSV nach Ökosystem und Paket aufgebaut ist, passt es direkt zu einem Lockfile oder zur Package URL einer Komponente in einer SBOM, ohne das Rätselraten bei der Zuordnung eines Pakets zu einer CPE. Schwächer ist es bei proprietären Produkten und Appliances, die kein Paket-Ökosystem haben und in der NVD beschrieben werden.
Die OSV-API und osv-scanner
Die API unter https://api.osv.dev ist kostenlos, und ihre Dokumentation nennt keine Nutzungsgrenzen. Eine Abfrage nach Paket und Version:
curl -d '{"package": {"name": "nokogiri", "ecosystem": "RubyGems"}, "version": "1.18.2"}' \
"https://api.osv.dev/v1/query"
/v1/querybatch prüft viele Pakete in einer Anfrage, und /v1/vulns/{id} liefert einen einzelnen Eintrag. Die gesamte Datenbank lässt sich auch pro Ökosystem herunterladen.
OSV-Scanner, im Dezember 2022 angekündigt, ist Googles Kommandozeilen-Frontend für die Datenbank. Es scannt Lockfiles, SBOMs, Verzeichnisse und Container-Images und meldet die passenden OSV-Einträge.
Wie CRACI damit zusammenhängt
CRACI zeigt für die in jedem Build aufgezeichneten Komponenten die Advisories jedes Pakets, mit ihren CVE-, GHSA- und anderen IDs und ihrem Schweregrad. Was eine SBOM enthalten muss, bevor eine Datenbank sie abgleichen kann, erfahren Sie unter Build-Time-SBOMs.