OSV (Open Source Vulnerabilities)
OSV je otevřený datový formát pro bezpečnostní oznámení o zranitelnostech a bezplatná databáze OSV.dev, která v tomto formátu shromažďuje oznámení k open source balíčkům z GitHubu, PyPI, RustSec, Go, linuxových distribucí a dalších zdrojů.
Poslední aktualizace: 13. listopadu 2026
OSV znamená Open Source Vulnerabilities. Název zahrnuje dvě věci: schéma OSV, otevřený formát JSON pro popis zranitelnosti z hlediska balíčků a verzí, kterých se týká, a OSV.dev, bezplatnou databázi a API, které v tomto formátu shromažďují bezpečnostní oznámení z mnoha zdrojů. Zatímco záznam CVE zranitelnost pojmenovává, záznam OSV odpovídá na otázku, kterou si vývojář skutečně klade: týká se to verze tohoto balíčku, kterou používám?
Kdo OSV provozuje
Google spustil OSV v únoru 2021, nejprve se zranitelnostmi nalezenými jeho fuzzingovou službou OSS-Fuzz. Schéma se dnes udržuje v repozitáři osv-schema nadace Open Source Security Foundation a nazývá se OpenSSF vulnerability format; databáze a její infrastruktura jsou open source v repozitáři google/osv.dev.
Většinu svých oznámení OSV.dev nepíše. Agreguje databáze, které publikují ve formátu OSV, například GitHub Advisory Database, databáze PyPI a Python Software Foundation, Go Vulnerability Database, RustSec, OpenSSF Malicious Packages, Ubuntu, Red Hat, Chainguard a Android. U Debianu, Alpine a CVE z NVD týkajících se open source softwaru převádí zdrojová data sám tým OSV.dev (zdroje dat).
Prefixy ID v OSV
Každý záznam OSV má ID ve tvaru <DB>-<ENTRYID>, kde prefix označuje databázi, která ho publikovala. Některé z prefixů definovaných ve schématu:
| Prefix | Databáze | Příklad 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 | Záznamy NVD převedené službou OSV.dev | CVE-2021-44228 |
| OSV | Přiděluje OSV.dev, v současnosti jen pro OSS-Fuzz | OSV-2020-111 |
Stejná zranitelnost má často několik záznamů, jeden pro každý zdroj. Propojuje je pole aliases: GHSA-jfh8-c2jp-5v3q, oznámení GitHubu k Log4Shell, uvádí jako alias CVE-2021-44228, takže ji nástroje mohou započítat jen jednou. Záznamy MAL- jsou jiného druhu: popisují škodlivé balíčky, které nemají žádnou opravenou verzi.
Jak vypadá záznam OSV
Jádrem záznamu je seznam affected: pro každý balíček jeho ekosystém, název a zranitelné rozsahy verzí, s událostmi, které říkají, kde byl rozsah zaveden (introduced) a kde opraven (fixed). Zde je GHSA-jfh8-c2jp-5v3q, zkrácený na jeden z rozsahů:
{
"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" }]
}]
}]
}
Rozsahy mohou být typu SEMVER, ECOSYSTEM (vlastní řazení verzí daného ekosystému, například u PyPI nebo Debianu) nebo GIT, který uvádí hashe commitů. Rozsahy Git umožňují OSV.dev přiřadit zranitelnost ke commitu v kódu C a C++, který vůbec nemá správce balíčků.
OSV vs NVD a CVE
| Otázka | Záznam CVE | NVD | OSV |
|---|---|---|---|
| Co to je | ID a krátký záznam | Databáze NIST, která obohacuje CVE | Formát plus agregovaná databáze |
| Identifikuje software podle | Textu dodavatele a produktu | Názvů CPE | Ekosystému a názvu balíčku nebo repozitáře Git |
| Dotčené verze | Jak je zapsala CNA | Rozsahy verzí CPE | Strojově čitelné rozsahy ve vlastním schématu verzí ekosystému |
| Pokrývá oznámení bez CVE | Ne | Ne | Ano, například mnoho záznamů RUSTSEC, PYSEC a MAL |
| Nejvhodnější pro | Pojmenování jedné zranitelnosti | Komerční a uzavřené produkty | Open source závislosti |
Protože je OSV klíčované podle ekosystému a balíčku, odpovídá přímo lockfilu nebo package URL komponenty v SBOM, bez dohadů při přiřazování balíčku k CPE. Slabší je u produktů s uzavřeným kódem a zařízení, které nemají ekosystém balíčků a popisuje je NVD.
API OSV a osv-scanner
API na adrese https://api.osv.dev je zdarma a jeho dokumentace neuvádí žádné limity používání. Dotaz podle balíčku a verze:
curl -d '{"package": {"name": "nokogiri", "ecosystem": "RubyGems"}, "version": "1.18.2"}' \
"https://api.osv.dev/v1/query"
/v1/querybatch zkontroluje mnoho balíčků v jednom požadavku a /v1/vulns/{id} vrátí jeden záznam. Celou databázi lze také stáhnout po jednotlivých ekosystémech.
OSV-Scanner, oznámený v prosinci 2022, je rozhraní příkazového řádku Googlu k databázi. Skenuje lockfily, SBOM, adresáře a obrazy kontejnerů a hlásí odpovídající záznamy OSV.
Jak s tím souvisí CRACI
CRACI zobrazuje u komponent zaznamenaných v každém buildu bezpečnostní oznámení každého balíčku s jejich ID CVE, GHSA a dalšími a se závažností. Co musí SBOM obsahovat, aby ji vůbec nějaká databáze mohla porovnat, popisuje stránka SBOM z doby buildu.