OSV (Open Source Vulnerabilities)
OSV on avoin tietomuoto haavoittuvuustiedotteille sekä maksuton tietokanta, OSV.dev, joka kokoaa avoimen lähdekoodin pakettien tiedotteet GitHubista, PyPI:stä, RustSecistä, Go:sta, Linux-jakeluista ja muualta tässä muodossa.
Päivitetty viimeksi: 13. marraskuuta 2026
OSV on lyhenne sanoista Open Source Vulnerabilities. Nimi kattaa kaksi asiaa: OSV-skeeman, avoimen JSON-muodon, joka kuvaa haavoittuvuuden niiden pakettien ja versioiden kautta, joihin se vaikuttaa, sekä OSV.devin, maksuttoman tietokannan ja API:n, joka kokoaa tiedotteita monista lähteistä tässä muodossa. Siinä missä CVE-tietue nimeää haavoittuvuuden, OSV-tietue vastaa kysymykseen, jota kehittäjä todella kysyy: koskeeko haavoittuvuus käyttämääni paketin versiota?
Kuka ylläpitää OSV:tä
Google julkaisi OSV:n helmikuussa 2021 aloittaen OSS-Fuzz-fuzzauspalvelunsa löytämistä haavoittuvuuksista. Skeemaa ylläpidetään nykyään Open Source Security Foundationin osv-schema-repositoriossa, ja sitä kutsutaan nimellä OpenSSF vulnerability format; tietokanta ja sen infrastruktuuri ovat avointa lähdekoodia repositoriossa google/osv.dev.
OSV.dev ei kirjoita suurinta osaa tiedotteistaan. Se kokoaa tietokantoja, jotka julkaisevat OSV-muodossa, kuten GitHub Advisory Database, PyPI:n ja Python Software Foundationin tietokannat, Go Vulnerability Database, RustSec, OpenSSF Malicious Packages, Ubuntu, Red Hat, Chainguard ja Android. Debianin, Alpinen ja avoimen lähdekoodin ohjelmistoja koskevien NVD:n CVE:iden osalta OSV.dev-tiimi muuntaa lähdedatan itse (tietolähteet).
OSV-tunnisteiden etuliitteet
Jokaisella OSV-tietueella on tunniste muodossa <DB>-<ENTRYID>, jossa etuliite nimeää tietueen julkaisseen tietokannan. Joitakin skeemassa määriteltyjä etuliitteitä:
| Etuliite | Tietokanta | Esimerkkitunniste |
|---|---|---|
| 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.devin muuntamat NVD-tietueet | CVE-2021-44228 |
| OSV | OSV.devin myöntämät, tällä hetkellä vain OSS-Fuzzille | OSV-2020-111 |
Samalla haavoittuvuudella on usein useita tietueita, yksi kustakin lähteestä. Kenttä aliases yhdistää ne: GHSA-jfh8-c2jp-5v3q, Log4Shellin GitHub-tiedote, luettelee aliaksenaan CVE-2021-44228:n, joten työkalut voivat laskea sen kerran. MAL--tietueet ovat luonteeltaan erilaisia: ne kuvaavat haitallisia paketteja, joilla ei ole korjattua versiota.
Miltä OSV-tietue näyttää
Tietueen ydin on affected-luettelo: jokaisen paketin ekosysteemi, nimi ja haavoittuvat versiovälit, joissa tapahtumat kertovat, mistä väli alkoi (introduced) ja missä se korjattiin (fixed). Tässä on GHSA-jfh8-c2jp-5v3q lyhennettynä yhteen väliinsä:
{
"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" }]
}]
}]
}
Välit voivat olla tyyppiä SEMVER, ECOSYSTEM (ekosysteemin oma versiojärjestys, kuten PyPI:ssä tai Debianissa) tai GIT, joka antaa commit-tiivisteet. Git-välien avulla OSV.dev voi kohdistaa haavoittuvuuden commitiin C- ja C++-koodissa, jolla ei ole paketinhallintaa lainkaan.
OSV vs. NVD ja CVE
| Kysymys | CVE-tietue | NVD | OSV |
|---|---|---|---|
| Mikä se on | Tunniste ja lyhyt tietue | NISTin tietokanta, joka rikastaa CVE:itä | Muoto sekä koostettu tietokanta |
| Tunnistaa ohjelmiston | Toimittajan ja tuotteen tekstinä | CPE-nimillä | Ekosysteemin ja paketin nimellä tai Git-repositoriolla |
| Haavoittuvat versiot | Kuten CNA ne kirjoitti | CPE-versiovälit | Koneluettavat välit kunkin ekosysteemin omassa versiojärjestelmässä |
| Kattaa tiedotteet, joilla ei ole CVE:tä | Ei | Ei | Kyllä, kuten monet RUSTSEC-, PYSEC- ja MAL-tietueet |
| Sopii parhaiten | Yhden haavoittuvuuden nimeämiseen | Kaupallisiin ja suljettuihin tuotteisiin | Avoimen lähdekoodin riippuvuuksiin |
Koska OSV on avainnettu ekosysteemin ja paketin mukaan, se vastaa suoraan lukitustiedostoa tai SBOMin komponentin package URL -tunnistetta ilman arvailua, jota paketin kohdistaminen CPE:hen vaatii. Se on heikompi suljetun lähdekoodin tuotteissa ja laitteissa, joilla ei ole pakettiekosysteemiä ja jotka kuvataan NVD:ssä.
OSV:n API ja osv-scanner
API osoitteessa https://api.osv.dev on maksuton, eikä sen dokumentaatio mainitse käyttörajoja. Kysely paketin ja version perusteella:
curl -d '{"package": {"name": "nokogiri", "ecosystem": "RubyGems"}, "version": "1.18.2"}' \
"https://api.osv.dev/v1/query"
/v1/querybatch tarkistaa useita paketteja yhdellä pyynnöllä, ja /v1/vulns/{id} palauttaa yhden tietueen. Koko tietokannan voi myös ladata ekosysteemeittäin.
Joulukuussa 2022 julkistettu OSV-Scanner on Googlen komentorivikäyttöliittymä tietokantaan. Se skannaa lukitustiedostoja, SBOMeja, hakemistoja ja konttikuvia ja raportoi vastaavat OSV-tietueet.
Miten CRACI liittyy tähän
CRACI näyttää jokaisen paketin tietoturvatiedotteet CVE-, GHSA- ja muine tunnisteineen sekä vakavuuksineen jokaisessa buildissa tallennetuille komponenteille. Siitä, mitä SBOMin on sisällettävä, ennen kuin mikään tietokanta voi löytää sille osumia, kerrotaan sivulla build-aikaiset SBOMit.