SBOM
Mida avatud lähtekoodiga SBOM-i generaatorid märkamata jätavad
Syft, Trivy ja cdxgen on võimekad, tasuta ja laialt kasutatud. Kõik kolm koostavad SBOM-i failidest, millele need suunate: lukufailidest (lockfile), manifestidest või installitud pakettidest. Seepärast annavad need samast repositooriumist eri tulemuse ja ükski neist ei näe, mida build nendest failidest väljaspool alla laadis.
Uuendatud
Kuidas iga tööriistaga SBOM-i genereerida
Iga tööriist vajab lähtekoodi kausta või konteineritõmmise jaoks üht käsku ning väljund on CycloneDX- või SPDX-vormingus:
# Syft: a source directory or a container image
syft ./my-project -o cyclonedx-json=sbom.cdx.json
syft my-image:latest -o spdx-json=sbom.spdx.json
# Trivy: a filesystem or a container image
trivy fs --format cyclonedx --output sbom.cdx.json .
trivy image --format spdx-json --output sbom.spdx.json my-image:latest
# cdxgen: the current directory, optionally with a project type
cdxgen -o bom.json .
cdxgen -t js -o bom.json . Käsud on lihtne osa. See, mis faili jõuab, sõltub sellest, mida iga tööriist loeb, ja need ei loe samu asju.
Mida iga tööriist loeb
| Tööriist | Lähtekoodi kaust | Konteineritõmmis | Tasub teada |
|---|---|---|---|
| Syft | Kaustade vaikimisi kataloogijate komplekt, mis loeb deklareeritud sõltuvusi | Tõmmiste vaikimisi kataloogijate komplekt, mis loeb installitud pakette | Kataloogijad valitakse skannimise tüübi järgi. syft cataloger list näitab, millised töötavad, ja --select-catalogers lisab või eemaldab neid. |
| Trivy | Lukufailid, Node.js-i puhul package-lock.json, yarn.lock, pnpm-lock.yaml ja bun.lock |
Node.js-i puhul package.json failid kaustas node_modules |
Jätab arendussõltuvused välja, kui te ei anna lippu --include-dev-deps. |
| cdxgen | Esmalt lukufailid, mis sisaldavad arendussõltuvusi; Node.js-i puhul parsib see ka koodi importe | Toetatud | Määrake projekti tüüp lipuga -t, et piirata, mida see otsib. |
Miks need samast repositooriumist eri tulemuse annavad
Suunake kõik kolm samale commitile ja saate kolm erinevat loendit. Ükski neist pole katki. Igaüks järgib oma dokumenteeritud reegleid:
- Pole lukufaili, pole sõltuvusi. Express 5.2.1 ei commiti lukufaili. Puhtal väljavõttel pole tööriistal, mis lahendab sõltuvused lukufailidest või installitud pakettidest, kumbagi, nii et
package.jsonfailis deklareeritud npm-i sõltuvused ei jõua kunagi SBOM-i. See kirjutab ikkagi kehtiva dokumendi kõigega, mida muul viisil ära tundis. - Installitud või deklareeritud. See, kas käivitasite enne skannimist installi, võib olla olulisem kui see, millist tööriista kasutate. Sama repositooriumi installitud koopia puhul otsustab üks Syfti kataloogija seadistus, kas installitud npm-i paketid üldse ilmuvad.
- Arendussõltuvused. Trivy jätab need vaikimisi välja ja cdxgen kaasab, nii et sama lukufail annab küsimusele „mis selles projektis on“ kaks vastust.
- Nimed ja versioonid. Tööriistad tuvastavad mõningaid komponente erinevat tüüpi paketi-URL-ide all või kinnitavad GitHubi Actioni commiti SHA-le, kui teine teatab sildi. Valele identifikaatorile tuginev haavatavuste päring annab enesekindla vale vastuse.
- Manifest puudub üldse. Repositooriumil anthropics/claude-code pole sõltuvuste manifesti ja selle npm-i pakett ümbritseb valmiskompileeritud binaarfaili. See, mida iga tööriist tagastab, ütleb rohkem tööriista kui projekti kohta.
Mida kõik märkamata jätavad: varjatud sõltuvused
Sügavam piirang on ühine. Skanner loeb lukufaili või buildi väljundit ja tuletab sellest tagantjärele, mis sinna läks. Mida build nendest failidest väljaspool alla laadis, ei jõua kunagi SBOM-i. Need on varjatud sõltuvused:
- Installikonksud. npm-i
preinstalljapostinstallskriptid töötavad installi ajal ja võivad alla laadida rohkem koodi. Nii töötas Shai-Huludi uss. - Buildiskriptid, näiteks Rusti buildiskriptid, mis laadivad vajaliku alla buildi ajal.
- Baastõmmised ja nende operatsioonisüsteemi kihid konteineri buildis, mida ükski keele lukufail ei loetle.
- CI vahemäludest taastatud paketid, mis ei pruugi praeguse lukufailiga kokku langeda. Vaadake mida GitHub Actionsi vahemälu varjab.
- Buildi tööriistad, mille seadistussammud installivad, koos oma sõltuvuspuudega.
- Buildi ajal lahendatud transitiivsed versioonid, kui lukufail puudub, on aegunud või külmutatud install seda ei kasuta. Vaadake transitiivsed sõltuvused.
Väljundi hilisem skannimine lünka ei sulge. Valmis binaarfaili puhul, eriti kompileeritud koodi nagu Rust puhul, jääb skannerile üle vaid oletada, mis sinna läks. Kommertslikud SCA-skannerid töötavad sama tüüpi failidega ja jagavad samu pimealasid. CRACI on leidnud haavatavaid pakette, millest Snyk ja Aikido ei teatanud, sest komponendid ei olnud kunagi selles, mida nad skannisid.
Sama probleemi kohta Yocto buildides vaadake miks SBOM-i skannerid ei näe, mis Yocto buildides on.
Ka tööriistad on osa teie tarneahelast
Skanner töötab teie CI-s ja pääseb ligi teie koodile ning sageli ka saladustele. 2026. aasta märtsis kirjeldas Aqua Security turvateade (CVE-2026-33634) pahatahtlikku Trivy v0.69.4 väljalaset ning mürgitatud trivy-action ja setup-trivy silte, mis varastasid CI runneritelt mandaate. Kinnitage skanneri actionid täielikele commiti SHA-dele ja kontrollige turvateatest, milliseid versioone käitate.
Kuidas oma SBOM-i kontrollida
- Käitage samal commitil kahte generaatorit ja võrrelge paketi-URL-e, millest need teatavad.
- Kontrollige, kas repositoorium commitib lukufaili ja kas CI installib sellest külmutatud installiga.
- Skannige nii enne kui ka pärast installisammu ja võrrelge.
- Võrrelge loendit sellega, mille allalaadimist teie buildi logi näitab, sealhulgas seadistussammud ja vahemälu taastamised.
Kui loendid erinevad, sõltub teie avaldatav SBOM sellest, millise tööriista juhtusite käivitama, mitte sellest, mida tarnisite.
Salvestage selle asemel build
CRACI näeb liiklust, skannerid mitte. See on GitHub Actionsi runner, mis näeb igasse buildi tulevat võrguliiklust, nii et selle SBOM salvestab iga paketi, mille töö kaasa tõi, sõltuvuspuu igal sügavusel, sealhulgas varjatud sõltuvused ja CI vahemäludest taastatud paketid. Pole kausta, millele suunata, ega kataloogijat, mida valida. Kui salvestus ei näinud kõike, näiteks kuna töö lubas jälgimata liiklust, ütleb SBOM seda oma täielikkuse olekuga.
Salvestamine on oluline ka seetõttu, et buildid on harva reprodutseeritavad. Ehitage sama commit kaks korda järjest ja paketihaldur võib lahendada ja installida teises järjekorras, nii et teine build võib sisaldada teisi pakette. Ainult väljalaske loonud buildi ajal salvestatud SBOM tõendab, mida see väljalase sisaldab.
Jätke Syft või Trivy kolmanda osapoole tõmmiste ja binaarfailide jaoks, mida te ise ei ehitanud. Oma väljalasete jaoks vaadake buildi ajal salvestatud SBOM-id või broneerige demo, et võrrelda salvestatud SBOM-i oma praeguse tööriista omaga ühes oma repositooriumis.
Avatud lähtekoodiga SBOM-i generaatorid: korduma kippuvad küsimused
Kumb on SBOM-ide jaoks parem, Syft või Trivy?
Need on ehitatud eri ülesanneteks. Syft on spetsiaalne SBOM-i generaator paljude kataloogijate ja allkirjastatud kinnitustega; Trivy on turvaskanner, mis kirjutab SBOM-e ühe oma väljundina. Mõlemad loevad neid faile, mis on nende ees, nii et sama repositooriumi puhul on suurem erinevus tavaliselt selles, kas lukufail on commititud ja kas sõltuvused installiti enne skannimist.
Miks minu SBOM ei näita ühtegi sõltuvust?
Enamasti seetõttu, et repositoorium ei commiti lukufaili ja enne skannimist ei installitud midagi. Generaatoril, mis loeb lukufaile või installitud pakette, pole siis midagi lugeda, ja see kirjutab ikkagi kehtiva SBOM-i. Commitige lukufail või skannige pärast installisammu.
Kas Trivy kaasab arendussõltuvused SBOM-i?
Vaikimisi mitte. Trivy Node.js-i dokumentatsioon ütleb, et see ei teata arendussõltuvustest, kui te ei anna lippu --include-dev-deps. cdxgen seevastu parsib lukufaile ja kaasab arendussõltuvused. Juba ainuüksi sel põhjusel võivad kaks tööriista samas projektis eri tulemuse anda.
Kas avatud lähtekoodiga generaatori SBOM-i võib usaldada?
Selle osas, mida see luges, jah. Küsimus on selles, mida see ei lugenud: vahemälud, buildi tööriistad, allalaadimised, installiskriptid ja paketi metaandmeteta binaarfailid. Käsitlege skannitud SBOM-i kui kirjeldust failidest, millele tööriista suunasite, mitte buildist, mis teie väljalaske lõi.
Mis on parim SBOM-i tööriist?
Tarkvara puhul, mida ehitate ise, tuleb kõige täielikum SBOM buildi salvestamisest, mitte failide skannimisest. CRACI salvestab iga paketi, mille iga GitHub Actionsi töö alla laadib, sealhulgas vahemäludest, ja on leidnud haavatavaid pakette, millest Snyk ja Aikido ei teatanud. Kolmanda osapoole tõmmiste ja binaarfailide puhul, mida te ise ei ehitanud, on skanner nagu Syft või Trivy endiselt praktiline valik.
Pange salvestatud SBOM oma skanneri SBOM-i kõrvale
Käitage üht GitHub Actionsi töövoogu CRACI-s ja võrrelge selle allalaaditud pakettide SBOM-i sellega, mida Syft, Trivy või cdxgen teatasid.
Broneerige demo