Haavatavused
VEX: mida ütleb Vulnerability Exploitability eXchange'i dokument
Kui võrdlete SBOM-i haavatavuste andmebaasiga, saate pika CVE-de loendi, millest paljusid ei saa tootes ära kasutada. VEX on viis, kuidas tarnija ütleb, millised neist kehtivad: masinloetav väide iga haavatavuse kohta, kas toode on mõjutatud ja miks.
Uuendatud
Mis on VEX?
VEX (lühend sõnadest Vulnerability Exploitability eXchange) on masinloetav väide selle kohta, kas toodet mõjutab konkreetne teadaolev haavatavus. Tarnija avaldab selle, et toote kasutajad teaksid, millised haavatavused nõuavad tegutsemist ja millised mitte. Enamikus organisatsioonides tegeleb selle tarnijapoolse tööga tooteturvalisuse intsidentidele reageerimise meeskond (PSIRT).
CISA dokument Minimum Requirements for VEX (aprill 2023) määratleb selle failivormingust sõltumatult: VEX-dokument on konteiner ühe või mitme VEX-väite jaoks ning iga väide annab ühe oleku ühe haavatavuse kohta ühes või mitmes tootes. VEX on loodud töötama koos SBOM-ide, haavatavuste andmebaaside ja turvateadetega, kuid ei vaja ühtegi neist.
Miks VEX on olemas: SBOM-i müra
SBOM loetleb toote kõik komponendid, sealhulgas transitiivsed sõltuvused. Skanner võrdleb neid komponente turvateadetega ja teatab iga CVE igas leitud versioonis. Paljud neist leidudest ei kehti: haavatavat funktsiooni ei kutsuta kunagi välja, buildi seade jätab selle kompileerimisest välja või toote konfiguratsioon blokeerib rünnaku. Ilma VEX-ita peab iga klient selle ise välja selgitama või esitama tarnijale tugipileti.
VEX viib selle analüüsi osapoolele, kes saab seda teha üks kord kõigi jaoks: tarnijale. Kliendi skanner loeb VEX-dokumenti ja peidab leiud, mille kohta tarnija on märkinud, et need toodet ei mõjuta.
VEX on üks mitmest hoovast. Kuidas vähendada haavatavuste müra seab need järjekorda, alustades inventarist, mis vastab sellele, mida tarnite.
VEX-i neli olekut
Igal VEX-väitel on täpselt üks neljast olekust:
| Olek | Tähendus | Lisaks nõutav |
|---|---|---|
not_affected |
Parandamine ega leevendamine pole vajalik. Haavatavus ei mõjuta loetletud tooteid. | Põhjendus või mõjuselgitus, mis selgitab, miks |
affected |
Haavatavus mõjutab loetletud tooteid ja autor soovitab tegutseda. | Tegevusjuhis: mida kasutajad peaksid tegema |
fixed |
Loetletud tooteversioonid sisaldavad parandust. | Ei midagi lisaks |
under_investigation |
Autor uurib ja pole veel otsustanud. | Ei midagi lisaks; eeldatavasti muutub |
VEX-i põhjendused olekule not_affected
not_affected-väide peab ütlema, miks. CISA nõuete järgi SHOULD see kasutada ühte viiest põhjendusest
ja MUST anda vabatekstilise mõjuselgituse, kui see seda ei tee. OpenVEX ja CSAF kasutavad samu viit:
-
component_not_present: haavatavat komponenti tootes ei ole. -
vulnerable_code_not_present: komponent on olemas, kuid haavatav kood mitte, tavaliselt selle tõttu, kuidas see konfigureeriti või ehitati. -
vulnerable_code_not_in_execute_path: haavatav kood on olemas, kuid toode ei kutsu seda kunagi välja. -
vulnerable_code_cannot_be_controlled_by_adversary: kood on olemas ja kasutusel, kuid ründaja ei saa seda haavatavuse ärakasutamiseks juhtida. -
inline_mitigations_already_exist: sisseehitatud kaitsed, mida kasutajad ei saa välja lülitada, takistavad ärakasutamist.
Põhjendused erinevad selle poolest, milliseid tõendeid need vajavad. component_not_present vajab
täpset kirjet selle kohta, mida toode sisaldab. Keskmised kolm vajavad koodianalüüsi, näiteks reachability-analüüsi
või käsitsi ülevaatust, ja just neid seavad kliendid kõige sagedamini kahtluse alla.
Mida VEX-väide sisaldab
CISA miinimumnõuded loetlevad järgmised elemendid:
- Dokumendi metaandmed: dokumendi ID, iga muudatusega suurenev versioon, autor (inimene või organisatsioon, mitte tööriist) ning esmase väljaandmise ja viimase uuendamise aeg.
- Toote andmed: üks või mitu tootetunnust, ideaalis samad tunnused, mida kasutab toote SBOM, näiteks paketi URL (purl). Väide võib nimetada ka alamkomponendi, milles haavatavus asub.
- Haavatavuse andmed: üks haavatavuse ID väite kohta, tavaliselt CVE, ning kirjeldus või link kirjeldusele.
- Olek koos põhjenduse, mõjuselgituse või tegevusjuhisega, mida see nõuab.
- Väite metaandmed: väite enda ID, versioon ja ajatemplid.
VEX-dokumendi näide
See OpenVEX-dokument ütleb, et toode example-api 3.2.0 sisaldab log4j-core'i haavatavat versiooni,
kuid Log4Shell seda ei mõjuta, sest haavatav klass eemaldatakse buildi ajal:
{
"@context": "https://openvex.dev/ns/v0.2.0",
"@id": "https://example.com/vex/2026-0042",
"author": "Example Corp PSIRT",
"timestamp": "2026-10-02T09:00:00Z",
"version": 1,
"statements": [
{
"vulnerability": { "name": "CVE-2021-44228" },
"products": [
{
"@id": "pkg:generic/example/[email protected]",
"subcomponents": [
{ "@id": "pkg:maven/org.apache.logging.log4j/[email protected]" }
]
}
],
"status": "not_affected",
"justification": "vulnerable_code_not_present",
"impact_statement": "The JndiLookup class is removed from log4j-core at build time."
}
]
}
Toode ja selle alamkomponent on tuvastatud pakettide URL-idega, nii et skanner saab neid võrrelda toote SBOM-i komponentidega. Sama väide CycloneDX- või CSAF-vormingus kannab samu fakte teistsuguse struktuuriga.
VEX-i vormingud: OpenVEX, CycloneDX VEX ja CSAF VEX
VEX on nõuete kogum, mitte failivorming. CycloneDX-vormingu enda kohta vaadake lehte mis on CycloneDX. CISA nimetab kolm vormingut, mis seda kanda saavad, ja need ei ole omavahel vahetatavad:
| OpenVEX | CycloneDX VEX | CSAF VEX | |
|---|---|---|---|
| Mis see on | Väike JSON-vorming, mis on loodud ainult VEX-i jaoks | CycloneDX-dokumendi jaotis vulnerabilities |
CSAF-i turvateadete standardi profiil csaf_vex |
| Standard | Avatud spetsifikatsioon, v0.2.0 | ECMA-424 (CycloneDX 1.6 ja uuemad) | OASIS Standard (CSAF 2.0, 2022) |
| Olekud | VEX-i neli olekut |
Oma analüüsiolekud: not_affected, exploitable, in_triage,
resolved, resolved_with_pedigree, false_positive
|
Tooteolekute loendid: known_not_affected, known_affected, fixed,
under_investigation
|
| Põhjendused | CISA viis põhjendust |
Üheksa omaenda põhjendust, näiteks code_not_reachable ja requires_configuration
|
CISA viis põhjendust lippudena |
| Sobib meeskondadele, kes | Soovivad võimalikult väikest VEX-faili | Tarnivad juba CycloneDX-vormingus SBOM-e | Avaldavad juba CSAF-i turvateateid |
| Trivy loeb | Jah | Jah, SBOM-i skannimisel | Jah |
| Grype loeb | Jah | Pole loetletud | Jah |
OpenVEX on kõige kergem: dokument, millel on autor, ajatempel, versioon ja väidete loend. Selle spetsifikatsioon käsitleb VEX-i väidete jadana, kus iga väide kirjutab üle varasemaid või täiendab neid.
CycloneDX VEX kasutab sama vulnerabilities struktuuri, mida CycloneDX kasutab kõige
muu jaoks, ning objekt analysis sisaldab olekut, põhjendust, reageerimisväärtusi, nagu
update või will_not_fix, ja vabatekstilist selgitust. VEX-andmed võivad asuda SBOM-i sees
või eraldi CycloneDX-dokumendis, mis viitab SBOM-ile BOM-Linki abil. Pange tähele, et selle põhjenduste sõnavara ei
ole CISA oma, seega vajab teisendamine OpenVEX-iks või CSAF-iks või vastupidi vastavustabelit. SBOM-i poole kohta
vaadake CycloneDX vs SPDX.
CSAF VEX on täielik CSAF-dokument kategooriaga csaf_vex. See nõuab tootepuud, CVE-d või
muud ID-d, märkusi ning iga toote kohta mõjuselgitust (kui toode pole mõjutatud) või parandusviisi (kui on
mõjutatud). See on raskem kui OpenVEX, kuid sobib organisatsioonidele, mis juba levitavad
CSAF-i turvateateid CSAF-i pakkuja kaudu.
VEX vs VDR
Vulnerability Disclosure Report (VDR) loetleb haavatavused, mis toodet mõjutavad, koos nende analüüsi ja parandusviisiga. NIST SP 800-161 soovitab VDR-e tarneahela praktikana ning CycloneDX toetab mõlemat. Erinevus, nagu CycloneDX-i näidetes öeldakse:
- VDR ütleb, millised haavatavused toodet mõjutavad. See võib hõlmata ka teie enda koodist leitud haavatavusi, mida pole kunagi mujal avaldatud.
- VEX on peamiselt eitav väide: millised teadaolevad haavatavused toodet ei mõjuta ja miks. See hõlmab ainult teadaolevaid haavatavusi.
Paljud tarnijad avaldavad mõlemad: VDR vastab küsimusele „mida ma pean parandama“, VEX küsimusele „mida võin eirata“.
Kuidas skannerid VEX-i kasutavad
VEX-dokument säästab tööd ainult siis, kui kliendi tööriistad seda loevad. Kaks laialt kasutatavat avatud lähtekoodiga skannerit teevad seda:
-
Trivy võtab VEX-i vastu oma
--vexvalikuga (märgitud eksperimentaalseks) kohalikust failist, VEX-i repositooriumist, OCI kinnitusest (attestation) või SBOM-is olevast viitest. See loeb OpenVEX-i, SBOM-i skannimisel CycloneDX VEX-i ja CSAF VEX-i ning lõpetabnot_affected-märkega haavatavustest teatamise. -
Grype võtab OpenVEX-i ja CSAF VEX-i vastu valikuga
--vex. See viibnot_affected- jafixed-vasted eiratud loendisse, mida näidatakse valikuga--show-suppressed, ning võib soovi korral lisada tulemustesseaffected- jaunder_investigation-väited.
Vastavusse viimine sõltub tunnustest. Kui VEX nimetab toodet teistsuguse tunnusega kui SBOM, ei saa skanner neid siduda ja leid jääb alles.
Kes VEX-i avaldab
VEX tuleb tavaliselt tarnijalt: toodet tarnivalt müüjalt, avatud lähtekoodi distributsioonilt või seadme tootjalt. Tarnija sees on see PSIRT-i ülesanne, osa samast haavatavuste haldamise elutsüklist, mis toodab turvateateid ja parandusi. Näiteks Red Hat avaldab CSAF VEX-dokumente oma CSAF-voo eraldi kataloogis turvateadete kõrval. PSIRT-i inseneride igapäevatöö kohta vaadake PSIRT-i rolli.
Ka kliendid kirjutavad VEX-i enda tarbeks, salvestades triaažiotsuseid tarnija toote kohta, et nende skanner lõpetaks nende esile tõstmise. Sellised regulatsioonid nagu ELi küberkerksuse määrus (Cyber Resilience Act, CRA) nõuavad tootjatelt nende tarnitavate komponentide haavatavuste käsitlemist ning VEX on üks viis kasutajatele öelda, millised neist kehtivad.
VEX-i ajakohasena hoidmine
-
Olekud muutuvad. Väide algab tavaliselt olekuga
under_investigationja lõpeb olekuganot_affectedvõi olekugaaffectedja seejärelfixed. Avaldage iga muudatus; CISA nõuab, et versioon suureneks iga kord. -
Uued väljalasked vajavad uusi väiteid.
not_affected-otsus versiooni 3.2.0 kohta ei ütle midagi versiooni 3.3.0 kohta. Kontrollige seda uuesti alati, kui komponent, selle versioon või buildi konfiguratsioon muutub. - Hoidke VEX SBOM-ist eraldi. SBOM kirjeldab väljalaset ja jääb muutumatuks. VEX muutub pärast väljalaset edasi, nii et selle avaldamine eraldi dokumendina väldib SBOM-ide uuesti väljaandmist.
- Avaldage seal, kust tööriistad otsivad. SBOM-i kõrval, konteineritõmmise kinnitusena (attestation) või oma turvateadete voos, ning öelge oma avalikustamispoliitikas, kus. Vaadake koordineeritud haavatavuste avalikustamist.
VEX-i piirangud
-
See on väide, mitte tõend.
not_affected-väide on autori hinnang. CISA soovitab siduda autori identiteedi dokumendiga krüptograafiliselt, kuid enamik tarbijaid usaldab VEX-i endiselt seetõttu, et nad usaldavad tarnijat. - Vaikimine ei tähenda midagi. VEX ei eelda ühtegi vaikeolekut. Haavatavus, mille kohta väidet pole, on teadmata, mitte mõjutamata.
- Vormingud ei vasta üks-ühele. CycloneDX kasutab OpenVEX-ist ja CSAF-ist erinevaid olekuid ja põhjendusi, seega kaovad teisendamisel üksikasjad.
- See on vaid nii hea kui inventar. Väide, et komponenti pole, eeldab täpset teadmist, mida toode sisaldab, sealhulgas transitiivseid sõltuvusi ja kõike, mida build paketihaldurist mööda alla laadis.
VEX algab täpsest SBOM-ist
Iga VEX-väide osutab komponentidele ning kõige kergemini kaitstav põhjendus,
component_not_present, on tõene ainult siis, kui inventar on täielik. Lukufailide tagantjärele
skannimisega genereeritud SBOM võib loetleda arendussõltuvusi, mida kunagi ei tarnita, ja jätta märkamata paketid,
mille build muul viisil alla laadis.
CRACI käitab GitHub Actionsi builde oma runneritel ja salvestab paketid, mille iga töö tegelikult alla laadis, sealhulgas transitiivsed sõltuvused, vahemäludest taastatud paketid ja sõltuvused, mida ükski lukufail ei loetle. Igal SBOM-il on täielikkuse olek ning seda saab eksportida CycloneDX- või SPDX-vormingus. Jälgitavaid SBOM-e hinnatakse pidevalt uuesti, buildide ajalugu näitab, millised varasemad buildid sisaldasid haavatavat sõltuvust, ning CRACI toetab VEX-i. Vaadake SBOM-i genereerimist ja haavatavuste jälgimist.
VEX: korduma kippuvad küsimused
Mida tähendab lühend VEX?
VEX tähendab Vulnerability Exploitability eXchange. See on masinloetav väide selle kohta, kas toodet mõjutab konkreetne teadaolev haavatavus, ning see avaldatakse, et kasutajad teaksid, millised teatatud haavatavused nõuavad tegutsemist.
Mis vahe on SBOM-il ja VEX-il?
SBOM loetleb toote komponendid. VEX ütleb antud haavatavuse kohta, kas toode on mõjutatud. SBOM muutub pärast väljalaset harva; VEX-väited muutuvad, kui tarnija uurib ja parandab. Seepärast avaldatakse VEX tavaliselt eraldi dokumendina, mis viitab tootele, mitte ei lisata seda SBOM-i sisse.
Millised on VEX-i neli olekut?
not_affected, affected, fixed ja under_investigation. not_affected-väide vajab põhjendust või mõjuselgitust ning affected-väide tegevusjuhist, mis ütleb, mida kasutajad peaksid tegema.
Millist VEX-i vormingut peaksin kasutama?
Kasutage seda, mida teie tarbijad ja tööriistad loevad. OpenVEX on kõige väiksem ning töötab Trivy ja Grype'iga. CycloneDX VEX sobib meeskondadele, kes juba tarnivad CycloneDX-vormingus SBOM-e. CSAF VEX sobib organisatsioonidele, mis juba avaldavad CSAF-i turvateateid, mis on tavaline tööstus- ja ettevõttetarkvaras. Paljud tarnijad teisendavad lõpuks nende vahel.
Kas VEX on sama mis turvateade?
Ei. Turvateade selgitab haavatavust, keda see mõjutab ja kuidas seda parandada, peamiselt inimestele. VEX on kitsas masinloetav olek toote ja haavatavuse kohta, peamiselt tööriistadele. Need liiguvad sageli koos: CSAF-i standardis on nii turvateate profiil kui ka VEX-i profiil.
Kes VEX-dokumente kirjutab?
Tavaliselt toote tarnija, sageli selle tooteturvalisuse intsidentidele reageerimise meeskond (PSIRT), sest see teab, kuidas toode on ehitatud ja konfigureeritud. CISA miinimumnõuded lubavad VEX-i koostada ka kolmandatel osapooltel ning iga dokument peab nimetama oma autori.
Kas haavatavuste skannerid loevad VEX-i?
Mitu loevad. Trivy võtab OpenVEX-i, CycloneDX-i ja CSAF VEX-i vastu valikuga --vex ning jätab välja leiud märkega not_affected. Grype võtab OpenVEX-i ja CSAF VEX-i vastu valikuga --vex ning viib not_affected- ja fixed-leiud eiratud loendisse.
Teadke, milliseid haavatavaid pakette teie buildid sisaldavad
VEX-väide on vaid nii hea kui inventar selle taga. Broneerige demo, et näha pakette, mille iga GitHub Actionsi build tegelikult alla laadis.
Broneerige demo