OSV (Open Source Vulnerabilities)
OSV on avatud andmevorming haavatavuste turvateadete jaoks ja tasuta andmebaas OSV.dev, mis kogub avatud lähtekoodiga pakettide turvateateid GitHubist, PyPI-st, RustSecist, Go-st, Linuxi distributsioonidest ja mujalt selles vormingus.
Viimati uuendatud: 13. november 2026
OSV tähendab Open Source Vulnerabilities (avatud lähtekoodi haavatavused). Nimi hõlmab kahte asja: OSV skeemi, avatud JSON-vormingut, mis kirjeldab haavatavust selle järgi, milliseid pakette ja versioone see mõjutab, ning OSV.dev-i, tasuta andmebaasi ja API-t, mis kogub paljudest allikatest turvateateid selles vormingus. Kui CVE kirje annab haavatavusele nime, siis OSV kirje vastab küsimusele, mida arendaja tegelikult küsib: kas minu kasutatav selle paketi versioon on mõjutatud?
Kes OSV-d haldab
Google käivitas OSV veebruaris 2021, alustades haavatavustest, mille oli leidnud tema fuzzing-teenus OSS-Fuzz. Skeemi haldab nüüd Open Source Security Foundation oma osv-schema repositooriumis ja seda nimetatakse OpenSSF-i haavatavusvorminguks; andmebaas ja selle taristu on avatud lähtekoodiga repositooriumis google/osv.dev.
OSV.dev ei kirjuta enamikku oma turvateadetest ise. See koondab andmebaase, mis avaldavad OSV vormingus, näiteks GitHub Advisory Database, PyPI ja Python Software Foundationi andmebaasid, Go Vulnerability Database, RustSec, OpenSSF Malicious Packages, Ubuntu, Red Hat, Chainguard ja Android. Debiani, Alpine'i ja avatud lähtekoodiga tarkvara puudutavate NVD CVE-de puhul teisendab OSV.dev-i meeskond lähteandmed ise (andmeallikad).
OSV ID-eesliited
Igal OSV kirjel on ID kujul <DB>-<ENTRYID>, kus eesliide nimetab andmebaasi, mis kirje avaldas. Mõned skeemis määratletud eesliited:
| Eesliide | Andmebaas | Näide-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 | OSV.dev-i teisendatud NVD kirjed | CVE-2021-44228 |
| OSV | OSV.dev-i antud, praegu ainult OSS-Fuzzi jaoks | OSV-2020-111 |
Samal haavatavusel on sageli mitu kirjet, üks iga allika kohta. Väli aliases seob need: GHSA-jfh8-c2jp-5v3q, GitHubi turvateade Log4Shelli kohta, loetleb oma aliasena CVE-2021-44228, nii et tööriistad saavad seda lugeda üks kord. MAL- kirjed on teist laadi: need kirjeldavad pahatahtlikke pakette, millel ei ole parandatud versiooni.
Milline näeb välja OSV kirje
Kirje tuum on loend affected: iga paketi kohta selle ökosüsteem, nimi ja haavatavad versioonivahemikud koos sündmustega, mis ütlevad, kus vahemik introduced (algas) ja kus fixed (parandati). Siin on GHSA-jfh8-c2jp-5v3q, lühendatud ühele vahemikule:
{
"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" }]
}]
}]
}
Vahemikud võivad olla tüüpi SEMVER, ECOSYSTEM (ökosüsteemi enda versioonijärjestus, nagu PyPI või Debiani puhul) või GIT, mis annab commit'ide räsid. Git-vahemikud võimaldavad OSV.dev-il seostada haavatavuse commit'iga C- ja C++-koodis, millel ei ole üldse paketihaldurit.
OSV vs NVD ja CVE
| Küsimus | CVE kirje | NVD | OSV |
|---|---|---|---|
| Mis see on | ID ja lühike kirje | NIST-i andmebaas, mis rikastab CVE-sid | Vorming pluss koondandmebaas |
| Tuvastab tarkvara | Tarnija ja toote teksti järgi | CPE nimede järgi | Ökosüsteemi ja paketi nime või Git-repositooriumi järgi |
| Mõjutatud versioonid | Nii, nagu CNA need kirja pani | CPE versioonivahemikud | Masinloetavad vahemikud iga ökosüsteemi enda versiooniskeemis |
| Hõlmab turvateateid ilma CVE-ta | Ei | Ei | Jah, näiteks paljud RUSTSEC-, PYSEC- ja MAL-kirjed |
| Sobib kõige paremini | Ühe haavatavuse nimetamiseks | Kommerts- ja suletud toodetele | Avatud lähtekoodiga sõltuvustele |
Kuna OSV on võtmestatud ökosüsteemi ja paketi järgi, sobitub see otse lukufailiga (lockfile) või SBOM-i komponendi package URL-iga, ilma et peaks paketti CPE-ga vastendama ära arvama. Nõrgem on see suletud lähtekoodiga toodete ja seadmete puhul, millel paketiökosüsteemi pole ja mida kirjeldatakse NVD-s.
OSV API ja osv-scanner
API aadressil https://api.osv.dev on tasuta ja selle dokumentatsioon ei nimeta kasutuspiiranguid. Päring paketi ja versiooni järgi:
curl -d '{"package": {"name": "nokogiri", "ecosystem": "RubyGems"}, "version": "1.18.2"}' \
"https://api.osv.dev/v1/query"
/v1/querybatch kontrollib ühe päringuga paljusid pakette ja /v1/vulns/{id} tagastab ühe kirje. Kogu andmebaasi saab alla laadida ka ökosüsteemide kaupa.
OSV-Scanner, mis kuulutati välja detsembris 2022, on Google'i käsureaga kasutajaliides andmebaasile. See skannib lukufaile, SBOM-e, katalooge ja konteineritõmmiseid ning raporteerib sobivad OSV kirjed.
Kuidas CRACI sellega seostub
CRACI näitab iga buildi kohta salvestatud komponentide puhul iga paketi turvateateid koos nende CVE-, GHSA- ja muude ID-de ning raskusastmega. Mida SBOM peab sisaldama, enne kui ükski andmebaas saab sellega vastet leida, lugege artiklist buildi ajal loodud SBOM-id.