OSV (Open Source Vulnerabilities)
OSV to otwarty format danych dla biuletynów o podatnościach oraz bezpłatna baza OSV.dev, która zbiera w tym formacie biuletyny dla pakietów open source z GitHuba, PyPI, RustSec, Go, dystrybucji Linuksa i innych źródeł.
Ostatnia aktualizacja: 13 listopada 2026
OSV oznacza Open Source Vulnerabilities. Nazwa obejmuje dwie rzeczy: schemat OSV, otwarty format JSON opisujący podatność przez pakiety i wersje, których dotyczy, oraz OSV.dev, bezpłatną bazę danych i API, które zbierają w tym formacie biuletyny z wielu źródeł. Rekord CVE nazywa podatność, a rekord OSV odpowiada na pytanie, które faktycznie zadaje programista: czy używana przeze mnie wersja tego pakietu jest podatna?
Kto prowadzi OSV
Google uruchomił OSV w lutym 2021, zaczynając od podatności wykrytych przez swoją usługę fuzzingu OSS-Fuzz. Schemat jest obecnie utrzymywany w repozytorium osv-schema fundacji Open Source Security Foundation i nosi nazwę OpenSSF vulnerability format; baza danych i jej infrastruktura są dostępne jako open source w google/osv.dev.
OSV.dev nie pisze większości swoich biuletynów. Agreguje bazy publikujące w formacie OSV, takie jak GitHub Advisory Database, bazy PyPI i Python Software Foundation, Go Vulnerability Database, RustSec, OpenSSF Malicious Packages, Ubuntu, Red Hat, Chainguard i Android. W przypadku Debiana, Alpine oraz CVE z NVD dotyczących oprogramowania open source zespół OSV.dev sam konwertuje dane źródłowe (źródła danych).
Prefiksy identyfikatorów OSV
Każdy rekord OSV ma identyfikator w postaci <DB>-<ENTRYID>, gdzie prefiks wskazuje bazę, która go opublikowała. Niektóre prefiksy zdefiniowane w schemacie:
| Prefiks | Baza danych | Przykładowy identyfikator |
|---|---|---|
| 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 | Rekordy NVD konwertowane przez OSV.dev | CVE-2021-44228 |
| OSV | Nadawane przez OSV.dev, obecnie tylko dla OSS-Fuzz | OSV-2020-111 |
Ta sama podatność często ma kilka rekordów, po jednym na źródło. Łączy je pole aliases: GHSA-jfh8-c2jp-5v3q, biuletyn GitHuba dotyczący Log4Shell, podaje CVE-2021-44228 jako alias, dzięki czemu narzędzia mogą policzyć go raz. Rekordy MAL- są innego rodzaju: opisują złośliwe pakiety, które nie mają wersji z poprawką.
Jak wygląda rekord OSV
Rdzeniem rekordu jest lista affected: dla każdego pakietu jego ekosystem, nazwa i podatne zakresy wersji, ze zdarzeniami wskazującymi, gdzie zakres został wprowadzony (introduced) i gdzie naprawiony (fixed). Oto GHSA-jfh8-c2jp-5v3q, skrócony do jednego z zakresów:
{
"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" }]
}]
}]
}
Zakresy mogą być typu SEMVER, ECOSYSTEM (własny porządek wersji ekosystemu, jak w PyPI czy Debianie) lub GIT, który podaje skróty commitów. Zakresy Git pozwalają OSV.dev dopasować podatność do commita w kodzie C i C++, który w ogóle nie ma menedżera pakietów.
OSV a NVD i CVE
| Pytanie | Rekord CVE | NVD | OSV |
|---|---|---|---|
| Czym jest | Identyfikator i krótki rekord | Baza NIST wzbogacająca CVE | Format oraz zagregowana baza danych |
| Identyfikuje oprogramowanie przez | Tekst: dostawca i produkt | Nazwy CPE | Ekosystem i nazwę pakietu albo repozytorium Git |
| Wersje, których dotyczy | Tak, jak zapisała je CNA | Zakresy wersji CPE | Zakresy do odczytu maszynowego we własnym schemacie wersji ekosystemu |
| Obejmuje biuletyny bez CVE | Nie | Nie | Tak, np. wiele rekordów RUSTSEC, PYSEC i MAL |
| Najlepszy do | Nazwania jednej podatności | Produktów komercyjnych i zamkniętych | Zależności open source |
Ponieważ OSV jest indeksowany według ekosystemu i pakietu, bezpośrednio odpowiada lockfile'owi lub package URL komponentu w SBOM, bez zgadywania przy mapowaniu pakietu na CPE. Gorzej sprawdza się dla produktów o zamkniętym kodzie i urządzeń typu appliance, które nie mają ekosystemu pakietów i są opisywane w NVD.
API OSV i osv-scanner
API pod adresem https://api.osv.dev jest bezpłatne, a jego dokumentacja nie podaje limitów użycia. Zapytanie według pakietu i wersji:
curl -d '{"package": {"name": "nokogiri", "ecosystem": "RubyGems"}, "version": "1.18.2"}' \
"https://api.osv.dev/v1/query"
/v1/querybatch sprawdza wiele pakietów w jednym zapytaniu, a /v1/vulns/{id} zwraca jeden rekord. Całą bazę można też pobrać dla każdego ekosystemu osobno.
OSV-Scanner, ogłoszony w grudniu 2022, to narzędzie wiersza poleceń Google do korzystania z bazy. Skanuje lockfile'e, SBOM-y, katalogi i obrazy kontenerów i raportuje pasujące rekordy OSV.
Związek z CRACI
CRACI pokazuje biuletyny każdego pakietu, z identyfikatorami CVE, GHSA i innymi oraz wagą, dla komponentów zarejestrowanych w każdym buildzie. Co musi zawierać SBOM, zanim jakakolwiek baza danych będzie mogła go dopasować, opisuje strona SBOM-y z czasu buildu.