Sõltuvused
Mis on transitiivne sõltuvus?
Transitiivne sõltuvus on pakett, mida teie tarkvara kasutab, sest mõni teine pakett vajab seda. Te ei deklareerinud seda kunagi, kuid see on selles, mida tarnite, oma haavatavuste ja litsentsiga. Siin on kirjas, kuidas neid näha, parandada ja tõendada, millised neist igasse väljalaskesse jõudsid.
Uuendatud
Otsesed ja transitiivsed sõltuvused
Otsene sõltuvus on see, mille deklareerite oma manifestis. Transitiivne sõltuvus on see, mille deklareerivad teie sõltuvused ja omakorda nende sõltuvused, nii sügavale, kui puu ulatub. Paketihaldur lahendab installimisel kogu puu ja salvestab tulemuse tavaliselt lukufaili (lockfile).
Võtame rakenduse, mis deklareerib ühe paketi, express. Käsk npm ls --all näitab, mida see üks rida endaga kaasa toob:
my-app
└─┬ express ← otsene: teie deklareerisite selle
├─┬ body-parser ← transitiivne, sügavus 1
│ └── raw-body ← transitiivne, sügavus 2
├── cookie ← transitiivne, sügavus 1
└─┬ send ← transitiivne, sügavus 1
└── mime-types ← transitiivne, sügavus 2 Tegelik puu on pikem. Enamik tüüpilise rakenduse pakette jõuab sinna just nii, mis tähendab, et suurema osa tarnitavast koodist valis paketihaldur, mitte teie.
| Otsene sõltuvus | Transitiivne sõltuvus | |
|---|---|---|
| Kes selle valis | Teie meeskond, manifestis | Paketihaldur, teie sõltuvuste manifestide põhjal |
| Kus see on loetletud | Manifestis ja lukufailis | Lukufailis, kui see on olemas |
| Kes versiooni kontrollib | Teie | Vanempaketi versioonivahemik, kui te seda üle ei kirjuta |
| Kuidas haavatavust parandada | Uuendage seda | Uuendage vanempaketti või kirjutage versioon üle |
Miks transitiivsed sõltuvused on olulised
Neil on samad riskid kui otsestel sõltuvustel, kuid vähema nähtavuse ja kontrolliga.
- Haavatavused. Kui avalikustati Log4Shell, log4j nullpäeva haavatavus, leidis Google'i Open Source Insightsi meeskond 35 863 Maven Centrali artefakti, mis sõltusid mõjutatud log4j koodist. Umbes 7000 sõltus sellest otse. Enamik tõi selle kaasa transitiivse sõltuvusena ja paljusid ei saanud parandada enne, kui vahepealne pakett oli ise paranduse välja andnud.
- Tarneahela rünnakud. xz utilsi tagauks (CVE-2024-3094) jõudis OpenSSH-sse, ilma et OpenSSH oleks xz-st sõltunud. Mitu Linuxi distributsiooni paikab OpenSSH-d systemd teavituste toetamiseks ja libsystemd sõltub liblzmast, teegist, mida xz pakub.
- Litsentsid. Igal transitiivsel paketil on oma litsents. Kolm taset sügavamal olev copyleft-litsents on sama siduv kui see, mille lisasite ise.
- Ühildumatud muudatused. Vanempakett, mis aktsepteerib versioonivahemikku, laseb järgmisel puhtal installimisel sisse uue transitiivse väljalaske, isegi kui teie manifestis midagi ei muutunud.
Kuidas oma transitiivseid sõltuvusi loetleda
Iga suurem paketihaldur oskab lahendatud puu välja printida:
| Ökosüsteem | Käsk |
|---|---|
| npm | npm ls --all |
| pnpm | pnpm list --depth Infinity |
| Python (uv) | uv tree |
| Python (pip) | pipdeptree |
| Go | go mod graph |
| Rust | cargo tree |
| Maven | mvn dependency:tree |
| Gradle | gradle dependencies |
Et teada saada, miks üks konkreetne pakett seal on, küsige selleni viivat teed: npm explain <package>, pnpm why, yarn why või cargo tree -i <crate>. Kui soovite teedega töötada, mitte neid lihtsalt välja printida, vaadake sõltuvusgraafe.
Kuidas parandada haavatavat transitiivset sõltuvust
- Uuendage vanempaketti. Leidke otsene sõltuvus, mis paketi kaasa toob, ja minge üle väljalaskele, mis nõuab parandatud versiooni. See on kõige puhtam parandus, sest vanempaketi hooldajad on seda testinud.
- Värskendage lukufaili. Kui vanempaketi versioonivahemik juba lubab parandatud versiooni, piisab lukufaili kirje uuendamisest, näiteks käsuga
cargo update -p <crate>või värskenpm updateabil. - Kirjutage versioon üle. Kui vanempakett pole parandust välja andnud, sundige versioon ise peale: npm-is ja pnpm-is
overrides, Yarnisresolutions, pip-iga piirangute fail või kõrgem nõue failisgo.mod. Testige seda, sest vanempaketti pole kunagi selle versiooniga välja antud. - Asendage või eemaldage vanempakett. Kui kumbki ei aita, ei pruugi paketi kaasa toonud sõltuvust enam tasuda alles hoida.
Mõned tarkvara koostise analüüsi tööriistad lisavad reachability-analüüsi, mis kontrollib, kas teie kood saab haavatavat funktsiooni üldse välja kutsuda, et otsustada, milline neist parandustest tuleb esimesena. Valikud leiate lehelt SCA tööriistad võrdluses.
Miks lukufail ei räägi kogu lugu
Enamik tööriistu koostab oma pildi transitiivsetest sõltuvustest lukufaili põhjal. See toimib, kui lukufail on olemas, ajakohane ja ainus, mille põhjal build installib. CI-s ei ole see sageli nii:
- Lukufail puudub. Versioonivahemikega
requirements.txtvõi projekt, mis pole oma lukufaili kunagi commit'inud, lahendatakse igal buildil uuesti, nii et transitiivsed versioonid võivad buildide vahel muutuda. - Vahemälud. CI vahemälud taastavad pakette varasematest käivitustest, selle asemel et neid alla laadida, ja nende sisu ei ole alati see, mida praegune lukufail ütleb. Vaadake mida GitHub Actionsi vahemälu peidab.
- Buildi tööriistad. Linterid, kompilaatorid, koodigeneraatorid ja seadistusetapid toovad buildi oma sõltuvuspuud. Neid pole teie rakenduse manifestis, kuid need töötavad juurdepääsuga teie lähtekoodile ja saladustele.
- Installiskriptid ja allalaadimised. Paketi installiskript võib alla laadida lisakoodi ja buildi etapp võib binaarfaili otse alla laadida. Kumbki ei jäta lukufaili kirjet.
Ainus täielik kirje sellest, millised transitiivsed sõltuvused väljalaskesse jõudsid, on see, mis tehakse selle väljalaske ehitamise ajal. Buildi ajal salvestatud SBOM-id selgitab, mis vahe on buildi salvestamisel ja selle failide hilisemal skannimisel.
Transitiivsed sõltuvused ja CRA
ELi küberkerksuse määrus (Cyber Resilience Act, CRA) nõuab tootjatelt tarkvara koostenimekirja koostamist, milles käsitletakse "vähemalt toodete kõrgema taseme sõltuvusi" (I lisa II osa punkt 1). Transitiivseid sõltuvusi ei nimetata, nii et õiguslik miinimum on madalam, kui paljud juhendid väidavad. Kuid CRA nõuab ka, et teeksite kindlaks ja käsitleksite haavatavusi komponentides, mida teie toode sisaldab, ja haavatav transitiivne pakett on üks neist. SBOM, mis piirdub esimese tasemega, jätab suurema osa teie sõltuvuspuust sellest protsessist välja. Üksikasjad leiate lehelt CRA SBOM-i nõuded.
Kuidas CRACI transitiivseid sõltuvusi jälgib
CRACI on GitHub Actionsi runner, mis salvestab buildi selle skannimise asemel. Iga töö ajal salvestab pakette tundev puhverserver iga paketi, mille töö alla laadib, puu igal sügavusel, sealhulgas CI vahemäludest taastatud paketid. See annab kasutatavatest sõltuvustest täielikuma pildi kui skanneripõhised tööriistad.
- Iga sügavus, ausalt välja öeldud. Iga töö SBOM-il on täielikkuse olek, nii et teate, millal salvestus kõike näha ei saanud.
- Puu nähtavaks. Sõltuvusgraaf näitab SBOM-i sõltuvuskihte mitmes vaates.
- Ekspordid, mis need hõlmavad. CycloneDX- ja SPDX-ekspordid sisaldavad transitiivseid sõltuvusi, igaüks oma deklareeritud litsentsiga.
- Millised buildid olid mõjutatud. Kui ilmub uus haavatavus, näitab buildide ajalugu, millised varasemad buildid sisaldasid haavatavat paketti, kas otsese või transitiivsena, nii et teate, millisel perioodil te seda tarnisite (vaadake kas CVE mõjutab meid?). Ajalugu järgib teie säilitusaega, vaikimisi 180 päeva.
- Poliitikakontrollid. Buildi, mis sisaldab konkreetset CVE-d, saab enne tarnimist blokeerida.
CRACI ei tee reachability-analüüsi. Kui peate teadma, kas teie kood kutsub välja haavatava funktsiooni, kasutage selle kõrval SCA tööriista, mis seda teeb. Vaadake SBOM-i genereerimine CRACI-s või broneerige demo, et salvestada üks oma buildidest.
Transitiivsed sõltuvused: korduma kippuvad küsimused
Mis on transitiivne sõltuvus?
Transitiivne sõltuvus on pakett, mida teie tarkvara kasutab, sest mõni teine pakett vajab seda. Kui teie rakendus sõltub teegist A ja A sõltub teegist B, on B teie rakenduse transitiivne ehk kaudne sõltuvus. Te ei deklareerinud seda kunagi, kuid see tarnitakse koos teie tarkvaraga.
Mis vahe on otsesel ja transitiivsel sõltuvusel?
Otsene sõltuvus on see, mille deklareerite oma manifestis, näiteks package.json-is, pyproject.toml-is või go.mod-is. Transitiivne sõltuvus on see, mille deklareerivad teie otsesed sõltuvused, ükskõik millisel sügavusel. Otsesed sõltuvused valite teie; transitiivsed valib paketihaldur puud lahendades.
Kas transient dependency on sama mis transitiivne sõltuvus?
Praktikas jah. "Transient dependency" on levinud eksitus väljendi "transitive dependency" asemel. Õige termin on transitiivne, transitiivse seose järgi: kui A sõltub B-st ja B sõltub C-st, siis A sõltub C-st.
Kuidas parandada haavatavust transitiivses sõltuvuses?
Kõigepealt uuendage otsest sõltuvust, mis selle kaasa toob, kui parandatud versiooniga väljalase on olemas. Kui ei ole, sundige parandatud versioon peale oma paketihalduri ülekirjutamismehhanismiga, näiteks npm overrides, Yarn resolutions või pip-i piirangute fail, ja testige, kas vanempakett töötab sellega endiselt.
Kuidas loetleda kõik transitiivsed sõltuvused?
Iga paketihaldur oskab lahendatud puu välja printida: npm ls --all, pnpm list --depth Infinity, uv tree või pipdeptree, go mod graph, cargo tree, mvn dependency:tree või gradle dependencies. Et teada, mida tootmisbuild tegelikult installis, salvestage build ise.
Kas ELi küberkerksuse määrus nõuab SBOM-is transitiivseid sõltuvusi?
Määrus seab miinimumiks "vähemalt toodete kõrgema taseme sõltuvused" (I lisa II osa punkt 1). Transitiivseid sõltuvusi ei nimetata, kuid haavatav transitiivne pakett on ikkagi teie tootes ja CRA nõuab, et käsitleksite haavatavusi komponentides, mida tarnite.
Vaadake iga sõltuvust, mille teie build kaasa tõi
Käitage üht GitHub Actionsi töövoogu CRACI-s ja saate salvestatud SBOM-i igast paketist, mille see alla laadis, puu igal sügavusel.
Broneerige demo