SBOM
SBOM-i genereerimine arendusmeeskondades: üks poliitika, iga konveier
Enamikul organisatsioonidel ei ole SBOM-i probleemi; neil on kuus SBOM-i protsessi. Lukustage kõigepealt väljund: üks vorming, üks väljade komplekt, üks genereerimise hetk, üks hoidla. Seejärel viige iga meeskonna konveier sellega vastavusse, eelistades genereerimist väljalaske buildi sees. Kliendid, audiitorid ja regulaatorid, näiteks ELi küberkerksuse määrus (Cyber Resilience Act, CRA), vaatavad SBOM-i ja selle taga olevat protsessi, mitte seda, millise skanneri te ostsite.
Uuendatud
Miks meeskondade eraldi skannerid ei moodusta SBOM-i programmi
Suunake viis tööriista samale tootele ja saate viis SBOM-i. Erinevused on struktuursed, mitte vead:
- Erinevad sisendid, loetud eri ajal. Üks tööriist loeb lukufaili (lockfile), teine installitud sõltuvuspuud, kolmas konteineritõmmist, neljas binaarfaili. Igaüks näeb tootest erinevat lõiku.
- Samale asjale erinevad nimed. Üks tuvastab komponente package URL-i järgi, teine CPE järgi, kolmas ainult failinime järgi. Kaht SBOM-i, mis kirjeldavad sama teeki, ei saa ühise võtme alusel ühendada.
- Erinev sügavus. Mõni loetleb ainult otsesed sõltuvused, mõni kogu transitiivse puu ja mõni ka buildi tööriistad. Miks generaatorid sama repositooriumi puhul eri tulemuse annavad, näitab avatud lähtekoodiga SBOM-i generaatorid.
- Mõni tööriist vastab teisele küsimusele. Taristu haavatavusskannerid teatavad, mis on töötavatesse hostidesse installitud. See on käituse jaoks kasulik, kuid see ei kirjelda toodet, mida te tarnite.
Tagajärg: SBOM-e ei saa toodete lõikes ühendada, duplikaatidest puhastada ega võrrelda ning audiitorile ei saa näidata üht protsessi, sest seda pole.
| Meetod | Sisend, mida see loeb | Millal | Mis jääb märkamata | Tüüpiline identifikaator |
|---|---|---|---|---|
| Lukufaili või manifesti skanner | Lukufailid ja manifestid väljavõttes | Enne või pärast buildi | Kõik, mida ükski lukufail ei loetle: installikonksud, buildiskriptide allalaadimised, baastõmmised | Package URL |
| Konteineritõmmise skanner | Paketiandmebaasid ja failid tõmmises | Pärast buildi | Ainult buildi ajal kasutatavad tööriistad, sissekompileeritud kood, kõik, millel pole paketikirjet | Package URL operatsioonisüsteemi ja keelte pakettidele |
| Binaarfaili või püsivara skanner | Stringid ja signatuurid binaarfailis | Pärast buildi | Kindlus: versioonid ja komponendid on tuletatud | CPE või tuletatud nimi |
| Hostide haavatavusskanner | Töötavatesse serveritesse installitud tarkvara | Käituse ajal | Toode sellisena, nagu see klientidele tarnitakse | CPE või tarnija tootenimi |
| Buildi ajal salvestamine | Mida väljalaske build alla laadis | Buildi ajal | Tarkvara, mida te ise ei ehitanud; mida see ei näinud, märgitakse mittetäielikuks | Package URL |
SBOM-i poliitika: mida ühtlustada
Ühtlustage SBOM, mitte skanner. Poliitika lukustab väljundi ja protsessi; iga konveier täidab selle parima generaatoriga, mida ta käitada saab. Iga allolev rida on midagi, mida saate kontrollida.
| Nõue | Reegel | Miks | Kuidas kontrollida |
|---|---|---|---|
| Ulatus | Iga toote väljalase, mis tarnitakse kliendile, sealhulgas püsivara ja konteineritõmmised. Sisemised tööriistad vabatahtlikult. | Kliendid ja regulaatorid küsivad selle kohta, mida te tarnite. | Igal väljalaskeregistri väljalaskel on SBOM. |
| Vorming ja versioon | Üks põhivorming, CycloneDX või SPDX, koos miinimumversiooniga. Teist aktsepteeritakse soovi korral. | Üks vorming tähendab üht parserit, üht validaatorit ja üht hoidlat. BSI TR-03183-2 nõuab CycloneDX 1.6 või uuemat või SPDX 3.0.1 või uuemat, mõistlik alampiir ELi klientide jaoks. | Skeemi valideerimine näitab vormingut ja versiooni. |
| Minimaalsed väljad | Package URL igal komponendil, millel see on, CPE ainult seal, kus seda pole, tarnija, versioon, deklareeritud litsents, sõltuvussuhted, tööriista nimi ja versioon, ajatempel ja genereerimise kontekst. | Neid kasutavad sobitamine, litsentside ülevaatus ja auditid. Viige need kooskõlla miinimumelementidega lehel mis on SBOM. | Konveieri väljakontroll loendab puuduvad väärtused. |
| Millal genereeritakse | Väljalaset tootvas CI buildis, iga kord. Mitte auditi ajal, mitte sülearvutis. | Uus build ei ole sama build; vaadake buildi ajal salvestatud SBOM-id. | SBOM-i buildi ID vastab väljalaske buildi ID-le. |
| Sügavus | Kogu transitiivne puu, mitte ainult ülemine tase. | CRA miinimum on kõrgema taseme sõltuvused; haavatavused ja kliendid lähevad sügavamale. | Sõltuvussuhted on olemas ka esimesest tasemest allpool. |
| Kus hoitakse | Koos väljalaske artefaktiga, leitav toote ja versiooni järgi. | SBOM, mida keegi turvateate saabudes ei leia, ei ole tõend. | Hankige juhusliku väljalaske SBOM toote ja versiooni järgi. |
| Säilitamine | Vähemalt toote tugiperiood pluss dokumentatsiooni säilitamise aeg, mida teie regulatsioonid nõuavad. | CRA määrab tehnilise dokumentatsiooni säilitamise aja ja SBOM on selle osa. | Võrrelge poliitika perioodi iga tööriista säilitamisajaga. |
| Valideerimine | Iga SBOM valideeritakse konveieris skeemi vastu; vigane SBOM nurjab buildi või väljalaskevärava. | Vigased SBOM-id ebaõnnestuvad kliendi tööriistades vaikselt. | Väljalaskevärava logis on valideerimise samm. |
| Vastutus | Genereerimise eest vastutab tootemeeskond; tooteturvalisus vastutab poliitika, valideerimisreeglite ja katvusaruandluse eest. | Genereerimiseks on vaja konveieri omanikku; järjepidevuseks on vaja reeglitele üht omanikku. | Iga konveieri juures on nimetatud omanik. |
| Erandid | Nimeline, ajaliselt piiratud erandite register: meeskond, põhjus, lõppkuupäev. | Poliitika peab vastu ka meeskondade puhul, kes ei saa seda veel täita. | Ükski erand ei ole lõppkuupäeva ületanud. |
Kontrollnimekiri lehel SBOM-i parimad tavad katab ühe SBOM-i reeglid; see poliitika on nende kohal olev kiht. Iga meeskond kirjeldab, kuidas tema konveier poliitikat täidab, konveieri kõrval olevas failis:
# sbom-policy.yaml, one per release pipeline
product: gateway-firmware
owner: team-gateway
format: cyclonedx
spec_version: "1.6"
generated_in: release-build
generator: build-time-recording
store: artifact-registry
validation: schema, fail-on-errors
exception: none
Genereerige buildis, mitte meeskonniti tagantjärele
Buildi ajal genereerimine on standard, mille poole püüelda. See kirjeldab tarnitud buildi, sisaldab varjatud sõltuvusi, mida ükski lukufail ei loetle, ja üks mehhanism annab selle konveieri igale meeskonnale sama kujuga SBOM-i. Erinevust on kõige lihtsam selgitada köögi näitel: skanner maitseb suppi ja arvab retsepti ära; salvestaja jälgib, mis kööki sisse tuuakse.
Skanner on endiselt õige tööriist tõmmiste jaoks, mida te ise ei ehitanud, kolmandate osapoolte binaarfailide jaoks ja vanade toodete jaoks, millel pole CI-d. Öelge seda poliitikas ja salvestage genereerimise kontekst, et lugeja teaks, mida iga SBOM nägi.
| Olukord | Genereerimise meetod | Salvestatav genereerimise kontekst |
|---|---|---|
| Väljalase ehitatakse teie hallatavas CI-s | Salvestage build või käitage generaatorit väljalaske töö sees | „Salvestatud buildi ajal“ või „pärast installi, failidest“ |
| Konteineritõmmis ehitatakse CI-s | Salvestage tõmmise build; skannige tulemust operatsioonisüsteemi pakettide suhtes, kui salvestaja neid ei kata | Buildi ID ja tõmmise räsi (digest) |
| Kolmanda osapoole tõmmis või seade | Tõmmise skanner, lisaks tarnija SBOM, kui see on olemas | „Skannitud väljund, mitte meie ehitatud“ |
| Tarnija binaarfail | Küsige tarnija buildi SBOM-i; binaaranalüüs kontrolliks | Tarnija, versioon, kuidas see saadi |
| Vana toode ilma konveierita | Skannige tarnitud artefakti; planeerige konveier | „Skannitud väljund“ ja lõppkuupäevaga erand |
Segatud CI: GitHub Actions, GitLab ja Jenkins ühes organisatsioonis
Poliitika on oma olemuselt CI-st sõltumatu: see määratleb väljundi, nii et GitLabi või Jenkinsi konveier saab selle täita generaatori sammuga ja GitHub Actionsi konveier saab kasutada buildi ajal salvestamist. Generaatori sammu reeglid:
- Käitage seda väljalaske töös pärast installisammu, mitte eraldi töös, mis installib uuesti.
- Kinnitage generaatori versioon ja kinnitage CI actionid commitile, mitte sildile. Miks see eriti skannerite puhul oluline on, selgitab avatud lähtekoodiga SBOM-i generaatorid.
- Salvestage genereerimise kontekstiks „pärast installi, failidest“, et lugejad teaksid, mida see nägi.
- Valideerige väljundit sama skeemi vastu nagu kõigis teistes konveierites.
Avatud lähtekoodiga generaatorid, nagu Syft, Trivy ja cdxgen, oskavad kõik kirjutada CycloneDX- ja SPDX-vormingut, nii et vormingureegel ei sunni tööriista valima. Nende võrdlemiseks vaadake SBOM-i tööriistad võrdluses.
CRACI toetab täna GitHub Actionsit; GitLab CI ja Jenkins on arenduskavas, kuupäevata. Juurutamise tagajärg: alustage buildi ajal salvestamist seal, kus kasutatakse GitHub Actionsit, jätke mujal generaatori sammud alles ja jälgige mõlemat samas katvusaruandes.
Kui klient soovib kindlat vormingu versiooni
Klient küsib CycloneDX 1.6, aga teie tööriistad kirjutavad 1.7. See juhtub, sest tema sisselugemise tööriist või tema enda poliitika on versioonile kinnitatud; BSI alampiir on 1.6, nii et ELi kliendid nimetavad sageli seda. Teie võimalused:
- Küsige, kas uuem versioon sobib. Sageli sobib.
- Teisendage CycloneDX CLI-ga, seejärel valideerige sihtversiooni vastu ja kontrollige, mis kaduma läks: väljad, mis on olemas ainult uuemas spetsifikatsioonis, jäetakse välja.
- SPDX-i soovi korral teisendab sama CLI SPDX JSON 2.3-sse ja sealt tagasi. Selle dokumentatsioon hoiatab, et SPDX-i ja CycloneDX-i vaheline teisendamine „võib põhjustada osa teabe kadumise“.
cyclonedx convert --input-file bom.cdx.json --input-format json \
--output-file bom-1.6.cdx.json --output-format json --output-version v1_6
cyclonedx validate --input-file bom-1.6.cdx.json --input-format json \
--input-version v1_6 --fail-on-errors
Validaator kontrollib CycloneDX 1.7 vastu, kui te ei anna parameetrit --input-version. Poliitika reegel:
hoidke algne SBOM kirjena alles. Teisendatud koopia on tuletatud tarne; hoidke selle tuletamise andmed (tööriist,
versioon, kuupäev) koos sellega. Lisateavet selliste soovide täitmise kohta leiate lehelt
klientide SBOM-i päringud ja kahe vormingu kohta lehelt
CycloneDX vs SPDX.
Litsentsiandmed juristidele
Sama SBOM võib teenida ka õigusmeeskonda, kui poliitika nõuab õigeid välju. Juristid vajavad iga komponendi litsentsi, vahet deklareeritud litsentsi (mida pakett ütleb) ja tuvastatud litsentsi (mida keegi kontrollis) vahel, copyleft-kohustusi ning loendit litsentsita komponentidest. CycloneDX 1.6 märgib litsentsid deklareerituks või tuvastatuks ja SPDX-is on mõlema jaoks eraldi väljad.
- Nõudke SPDX-i litsentsiidentifikaatoreid või -avaldisi, näiteks
MITvõiApache-2.0 OR MIT. -
Märkige
NOASSERTIONja puuduvad litsentsid ülevaatamiseks. SPDX-is tähendabNOASSERTION, et otsust ei tehtud või teavet ei antud; see ei ole litsents. - Suunake copyleft-litsentsid juristidele enne väljalaset, mitte pärast.
SBOM sisaldab deklareeritud litsentse. Litsentsivastavuse ülevaatus koos tuvastatud litsentside, teadete ja kohustustega on juristide töö või spetsialiseeritud tööriista ülesanne; vaadake avatud lähtekoodi litsentsivastavus.
Juurutamine meeskonna kaupa
| Etapp | Omanik | Lõpetamise kriteerium | Tüüpiline takistus |
|---|---|---|---|
| 1. Inventuur: tooted, konveierid, CI-süsteemid ja praegused generaatorid, üks rida väljalaske konveieri kohta | Tooteturvalisus | Igal tarnitud tootel on rida | Keegi ei tea, milline konveier väljalaske ehitab |
| 2. Avaldage poliitika koos erandite registriga | Tooteturvalisus | Poliitika on kinnitatud ja avaldatud | Vaidlus selle üle, millist tööriista kohustuslikuks teha (poliitika ei tee ühtegi kohustuslikuks) |
| 3. Pilootprojekt ühe või kahe meeskonnaga, kellel on põhjus: kliendi soov, tähtaeg, toode, millega praegune tööriist toime ei tule | Pilootmeeskonnad | Piloodi väljalasked tarnitakse nõuetele vastavate SBOM-idega | Meeskonnad, kellel pole pakilist põhjust, lükkavad selle tahaplaanile |
| 4. Lisage pilootkonveieritesse valideerimisväravad | Pilootmeeskonnad | Vigane SBOM nurjab väljalaske | Hirm väljalasete blokeerimise ees; alustage hoiatusest |
| 5. Laiendage CI-süsteemi kaupa; loobuge meeskonna skannerist alles siis, kui asendus täidab poliitika | Tootemeeskonnad | Katvuse siht on iga CI-süsteemi kohta täidetud | Konveierid, millel pole omanikku |
| 6. Raporteerige katvust igakuiselt | Tooteturvalisus | Aruanne läheb juhtkonnale iga kuu | Käsitsi arvutatud mõõdikud |
1. etapi inventuuri tabel peaks olema viimane; tabelitest loobumist käsitleb SBOM-i automatiseerimine. Yoctol põhinev toode on levinud pilootprojekt, sest üldotstarbelised skannerid jäävad sellega hätta; vaadake miks SBOM-i skannerid Yocto buildidest mööda vaatavad.
Katvuse mõõtmine
Numbrid, mida juhtkond ja audiitorid küsivad, igaüks määratletud suhtarvuna:
- Väljalasete katvus: poliitikale vastava SBOM-iga tarnitud väljalasked ÷ tarnitud väljalasked.
- Toodete katvus: tooted, millel on praeguses tugiperioodis vähemalt üks nõuetele vastav SBOM ÷ toetatavad tooted.
- Valideerimise läbimise määr: valideerimise läbinud SBOM-id ÷ genereeritud SBOM-id.
- Identifikaatorite katvus: package URL-iga (või CPE-ga) komponendid ÷ komponendid.
- Litsentside katvus: deklareeritud litsentsiga komponendid ÷ komponendid.
- Täielikkus: SBOM-id, mille generaator märgib täielikuks ÷ SBOM-id. Võimalik ainult seal, kus tööriist sellest teatab.
- Aeg SBOM-ini: aeg väljalaskest SBOM-i kättesaadavuseni.
Igakuise aruande näidis (illustratiivsed arvud):
| Mõõdik | GitHub Actionsi konveierid | GitLabi ja Jenkinsi konveierid | Kõik |
|---|---|---|---|
| Väljalasete katvus | 46 / 48 | 19 / 27 | 65 / 75 |
| Valideerimise läbimise määr | 100% | 92% | 97% |
| Identifikaatorite katvus | 99% | 88% | 95% |
| Avatud erandid | 1 | 4 | 5 |
Tõendina regulaatorile või audiitorile koosneb komplekt poliitikast, erandite registrist, katvusaruandest ja mõnest näidis-SBOM-ist. See näitab üht protsessi, mida rakendatakse ja mõõdetakse. CRA poole kohta vaadake CRA juhendit.
Kuidas CRACI sobitub
GitHub Actionsi konveierites on CRACI runner: määrate runs-on: craci ja iga töö saab salvestatud SBOM-i
ilma generaatori sammuta. Igal SBOM-il on täielikkuse olek, transitiivsed sõltuvused, package URL iga paketi kohta ja
iga komponendi deklareeritud litsents ning seda saab eksportida CycloneDX- või SPDX-vormingus. Litsentsipoliitika
reeglid võivad buildi blokeerida, jälgitavaid SBOM-e hinnatakse pidevalt uuesti ja buildide ajalugu näitab, millised
buildid sisaldasid haavatavat sõltuvust. See annab neile meeskondadele vaikimisi poliitika read „genereeritud
väljalaske buildis“, „identifikaator“ ja „litsents“. Kolmandate osapoolte SBOM-e saab lisada, nii et ostetud
komponente jälgitakse teie buildide kõrval.
Vaadake SBOM-i genereerimine CRACI-s ja SBOM-id GitHub Actionsis.
Millal CRACI ei ole lahendus
- GitLab CI-d või Jenkinsit kasutavad meeskonnad: täna mitte, see on arenduskavas. Kasutage poliitikale vastavat generaatori sammu.
- GitHub Enterprise Server: täna ei toetata.
- Taristu ja hostide skannimine ehk see, mis on serveritesse installitud, ja väärkonfiguratsioonid: teine ülesanne; jätke need tööriistad alles.
- Tarnijate tõmmiste binaar- või püsivaraanalüüs, kui te neid ise ei ehita: CRACI salvestab builde ega skanni binaarfaile.
- Pikk säilitamine: CRACI hoiab buildi andmeid vaikimisi 180 päeva, Enterprise-plaanis kohandatud säilitamisajaga. Kui teie poliitika nõuab SBOM-e kauem, eksportige need oma hoidlasse.
SBOM-i genereerimine meeskondades: korduma kippuvad küsimused
Kuidas ühtlustada SBOM-i genereerimist meeskondades, kes kasutavad eri tööriistu?
Ühtlustage väljund, mitte tööriist. Kirjutage üks poliitika, mis lukustab vormingu ja versiooni, minimaalsed väljad, millal SBOM genereeritakse, kus seda hoitakse, kui kaua seda säilitatakse ja kes seda valideerib. Laske igal konveieril täita see parima generaatoriga, mida ta käitada saab, ja mõõtke katvust poliitika suhtes.
Mida peaks SBOM-i poliitika sisaldama?
Ulatus, vorming ja miinimumversioon, minimaalsed väljad (package URL, tarnija, versioon, deklareeritud litsents, sõltuvused, tööriist, ajatempel, genereerimise kontekst), genereerimine väljalaske buildis, täielik transitiivne sügavus, hoidmine koos väljalaskega, säilitamine, valideerimine konveieris, vastutus ja ajaliselt piiratud erandite register.
Kas iga meeskond peaks käitama oma skannerit või peaksid SBOM-id tulema buildist?
Buildist, kus võimalik. Buildi ajal salvestatud SBOM kirjeldab tarnitud buildi ja annab selle konveieri igale meeskonnale sama kujuga SBOM-i. Jätke skannerid selle jaoks, mida te ise ei ehitanud: kolmandate osapoolte tõmmised, tarnijate binaarfailid ja vanad tooted ilma konveierita.
Klient soovib meie SBOM-i vanemas CycloneDX-i versioonis. Mida teha?
Küsige kõigepealt, kas uuem versioon sobib. Kui ei, teisendage koopia CycloneDX CLI-ga (cyclonedx convert koos --output-version v1_6), valideerige see selle versiooni vastu ja kontrollige, millised väljad välja jäid. Hoidke originaal kirjena alles ja salvestage, kuidas koopia tuletati.
Kuidas saada SBOM-idest litsentsiandmed juristideni?
Nõudke poliitikas SPDX-i litsentsiidentifikaatoreid või -avaldisi, märkige NOASSERTION ja puuduvad litsentsid ülevaatamiseks ning suunake copyleft-litsentsid juristidele enne väljalaset. SBOM sisaldab deklareeritud litsentse; tuvastatud litsentsid, teated ja kohustused vajavad litsentsiülevaatust.
Kuidas mõõta SBOM-i katvust toodete lõikes?
Suhtarvudena: nõuetele vastava SBOM-iga tarnitud väljalasked, nõuetele vastava SBOM-iga toetatavad tooted, valideerimise läbimise määr, package URL-iga komponendid, deklareeritud litsentsiga komponendid, täielikud SBOM-id seal, kus tööriist sellest teatab, ja aeg väljalaskest SBOM-ini. Raporteerige neid igakuiselt CI-süsteemi kaupa.
Milliseid tõendeid on vaja, et näidata audiitorile SBOM-i genereerimise järjepidevust?
Poliitika, erandite register, igakuine katvusaruanne ja mõni näidis-SBOM koos genereerimise kontekstiga. Koos näitavad need üht protsessi, mida rakendatakse igale väljalaskele ja mõõdetakse, ning just seda audiitor või klient kontrollib.
Proovige seda ühel GitHub Actionsi konveieril
Broneerige demo ja käitage üht väljalaske konveierit CRACI-s. Saate buildist salvestatud SBOM-i ja saate seda oma poliitika järgi kontrollida.
Broneerige demo