SBOM-i täielikkus
SBOM-i täielikkus tähendab, kas SBOM loetleb kõik komponendid, mis kirjeldatud tarkvarasse läksid, igal sügavusel, mitte ainult seda, kas fail on kehtiv.
Viimati uuendatud: 11. november 2026
SBOM on täielik, kui see loetleb kõik komponendid, mis kirjeldatud tarkvarasse läksid, sõltuvuspuu igal sügavusel, sh komponendid, mida ükski lukufail (lockfile) ega manifest ei loetle. SBOM-i täielikkus on just see omadus. CISA 2026 Minimum Elements palub SBOM-i koostajatel selgesõnaliselt märkida, kui teave on teadmata, ja märgib, et saajad võivad pidada SBOM-i mittetäielikuks, kui olulised komponendiandmed on varjatud.
Täielikkus, kehtivus ja kvaliteet on erinevad asjad
| Küsimus | Mida see tähendab | Mis seda kontrollib | Mida see öelda ei saa |
|---|---|---|---|
| Kehtiv | Fail vastab CycloneDX-i või SPDX-i skeemile | Skeemivalideerija | Kas komponente puudub |
| Väljade kvaliteet | Igal komponendil on nimi, versioon, tarnija, identifikaator, litsents ja räsi | Kvaliteedihindaja | Kas komponente puudub |
| Täielik | Midagi, mis tarkvarasse läks, ei puudu | Võrdlus sellega, mida build tegelikult sisse võttis | Sisendeid, mida võrdlus ei näinud |
Teise rea identifikaator on tavaliselt package URL või CPE. Fail võib kaks esimest kontrolli suurepäraselt läbida ja ikkagi pool tarkvarast välja jätta.
Miks täielikkust on hiljem raske mõõta
Skanner töötab lukufailide, manifestide või valmis väljundi põhjal. See ei saa teada paketist, mille installijärgne skript alla laadis, crate'ist, mis kompileeriti binaari, ega baastõmmise kihist, mida talle kunagi ei näidatud. Igaüks neist on varjatud sõltuvus.
Võtame Node.js teenuse, mille lukufail loetleb 400 paketti. Ühel neist on postinstall skript, mis laadib npm ci ajal alla eelkompileeritud binaari. Failist package-lock.json genereeritud SBOM on kehtiv, igal komponendil on versioon ja package URL ning binaari selles ei ole. Ükski kvaliteediskoor seda ei märgi, sest miski failis ei osuta sellele, mis puudub.
Hilisem uuesti ehitamine ei lahenda küsimust samuti: kui build ei ole reprodutseeritav build, võib teine build võtta sisse midagi muud kui esimene.
Kuidas täielikkusest ausalt teatada
- Märkige genereerimise kontekst: kas SBOM tehti lähtekoodist enne buildi, salvestati buildi ajal või loodi väljundit hiljem analüüsides.
- Loetlege teadaolevad lüngad: tarkvara osad, mida tööriist ei näinud, näiteks kaasatud (vendored) kood, eelkompileeritud binaarid või väljaspool paketihaldurit installitud komponendid.
- Eelistage skoorile põhjendustega olekut. Täielikkuse protsent vajab kogusummat ja just kogusummat ei tea keegi. Väide nagu „mittetäielik: töö lubas jälgimata liiklust“ on midagi, mille põhjal saab tegutseda.
SBOM-i parimad tavad käsitlevad laiemalt seda, kuidas öelda, mida SBOM ei näinud.
Täielikkuse olekud CRACI-s
CRACI annab iga töö SBOM-ile täielikkuse oleku ja ka vahemäludele. Olekud, nagu CRACI dokumentatsioon need määratleb:
- Complete: „CRACI jälgis töö täielikke tõendeid ja iga taastatud vahemälu oli täielik.“
- Complete with connections: „Nõuded täideti, kuid töö kasutas üht või mitut kohandatud võrguühendust.“
- Incomplete: „CRACI tuvastas tingimuse, mis võis jätta sõltuvusi SBOM-ist välja.“
- Unavailable: „CRACI ei saanud tõendite hindamist lõpetada.“
- Not recorded: „Töö on vanem kui täielikkuse raporteerimine.“
CRACI saab seda väita, sest see näeb iga töö liiklust paketiallikatesse, nii et see teab, millal midagi võis temast mööda minna: liiklus, mida see ei jälginud, või taastatud vahemälu, mille enda SBOM oli mittetäielik. Kui töö on mittetäielik, näitab töö põhjust, näiteks „Unmonitored traffic was allowed“. Vaadake SBOM-i genereerimine.
Need olekud kehtivad buildidele, mis jooksevad CRACI runneritel. Tarnijalt saadud SBOM-i või konveieri puhul, mis CRACI-s ei jookse, kasutage ülaltoodud võrdlusi ja raporteerimise reegleid.