2026. aastal teatati päevas 138% rohkem CVE-sid kui eelmisel aastal.Uus: alati töös olevad Fixboxid. Haavatavad sõltuvused, parandatud ja kontrollitud.

Sõltuvused

Mis on sõltuvusgraaf?

Sõltuvusgraaf kaardistab iga paketi, millest teie tarkvara sõltub, ja selle, milline pakett selle kaasa tõi. Loend ütleb, mis teie tarkvaras on. Graaf ütleb, miks see seal on ja mida veel see puudutab, ning just see küsimus tekib, kui avaldatakse uus haavatavus.

Uuendatud

The same dependencies as a tree and as a graph As a tree, express leads to body-parser and send, and debug appears twice, once under each. As a graph, debug is a single node with an edge from body-parser and an edge from send, forming a diamond. Tree shared packages repeat express body-parser send debug debug Graph one node, two parents express body-parser send debug

Sõlmed, servad ja teed

Sõltuvusgraafis on iga pakett sõlm ja iga „sõltub“-seos serv ühest paketist teise. Teie projekt on tipus. Selle otsesed sõltuvused on ühe serva kaugusel ja selle transitiivsed sõltuvused on kõik, mis jääb allapoole. Tee teie projektist mis tahes paketini on selle sõltuvustee ja ühel paketil võib neid olla mitu.

Graaf, puu või loend

Samu sõltuvusi saab näidata kolmel viisil ja igaüks vastab erinevale küsimusele.

Vaade Mida see näitab Mis kaotsi läheb
Lame loend Iga paketti üks kord koos versiooniga Miks iga pakett seal on
Puu Iga teed teie projektist, nagu paketihaldurid selle prindivad Jagatud paketid korduvad, nii et puu paisutab suurust
Graaf Iga paketti üks kord, servaga igast vanemast Ilma vaaturita raskem silmaga lugeda

Jagatud paketid on põhjus, miks graafid on olulised. Kui kaks teie sõltuvust vajavad sama paketti, moodustub teemant: üks sõlm kahe vanemaga. Selles oleva haavatavuse parandamiseks tuleb teada mõlemat teed, sest kumbki vanem võib vana versiooni lukustada.

Milleks sõltuvusgraafi kasutatakse

  • Parandustee leidmine. Haavatav transitiivne pakett parandatakse, uuendades või asendades midagi selle teel. Graaf näitab, millist otsest sõltuvust liigutada.
  • Mõjuala mõõtmine. Kui avaldatakse turvateade, näitab graaf, millised teie otsesed sõltuvused, teenused ja tooted viivad mõjutatud paketini.
  • Litsentside ülevaatus. Copyleft-litsents graafi sügavuses kehtib sama palju kui tipus olev ja tee ütleb, milline sõltuvus selle sisse tõi.
  • Uuenduste planeerimine. Ühe paketi suur versiooniuuendus muudab kõike selle all. Graaf näitab, kui suur osa teie puust liigub.
  • Riskikoondumise märkamine. Väike, hooldamata pakett, millest paljud teed läbi lähevad, on üksik tõrkepunkt.

Kuidas sõltuvusgraafi saada

Paketihaldurist. Iga paketihaldur prindib lahendatud puu ja enamik oskab selgitada, miks üks konkreetne pakett seal on. Leht Transitiivsed sõltuvused loetleb käsud npm-i, pnpm-i, Pythoni, Go, Rusti, Maveni ja Gradle'i jaoks.

GitHubist. Repositooriumi Insights-vahekaardi all olev sõltuvusgraaf on kokkuvõte repositooriumi manifestidest ja lukufailidest ning dependency submission API kaudu esitatud sõltuvustest. Seda toetavate ökosüsteemide puhul näitab GitHub transitiivset teed, mis iga sõltuvuse kaasa tõi, ja oskab graafi SBOM-ina eksportida.

SBOM-ist. CycloneDX salvestab graafi jaotisesse dependencies, kus iga komponent loetleb, millest see sõltub. SPDX kasutab pakettide vahel DEPENDS_ON seoseid. Express-rakenduse osa CycloneDX-graaf näeb välja selline:

"dependencies": [
  { "ref": "my-app", "dependsOn": ["express"] },
  { "ref": "express", "dependsOn": ["body-parser", "send"] },
  { "ref": "body-parser", "dependsOn": ["raw-body", "debug"] },
  { "ref": "send", "dependsOn": ["mime-types", "debug"] }
]

Siin on debug kahe vanema all: teemant. Paljud SBOM-id jätavad seosed välja ja loetlevad ainult komponendid, mis säilitab inventari, kuid kaotab kõik teed.

Graaf on täpselt nii hea kui selle allikas

Enamik sõltuvusgraafe ehitatakse manifestidest ja lukufailidest, nii et need näitavad puud, mille paketihaldur kavandas. Need ei näita CI vahemäludest taastatud pakette, seadistusetappides installitud buildi tööriistu ega installiskriptide ja allalaadimistega toodud koodi ning ei oska öelda, kas build installis täpselt lukufaili sisu. Vaadake, miks lukufail ei ole kirje sellest, mis tarniti.

Sõltuvusgraafid CRACI-s

CRACI ehitab oma graafi buildist endast. See on GitHub Actionsi runner, mis salvestab iga paketi, mille iga töö alla laadib, puu igal sügavusel ja koos CI vahemäludest taastatud pakettidega, SBOM-i, mis ütleb oma täielikkuse ise.

  • SBOM-i graafivaade. Sõltuvuste vaade näitab SBOM-i sõltuvuskihte vaadetes Pivot, Graph, Blob, Chord ja Sunburst, koos filtritega sügavuse ja raskusastme järgi.
  • Ekspordid kogu puuga. CycloneDX- ja SPDX-ekspordid sisaldavad transitiivseid sõltuvusi, igaüks koos deklareeritud litsentsiga.
  • Mõjutatud buildid ajas. Kui avaldatakse uus haavatavus, näitab buildide ajalugu, millised varasemad buildid sisaldasid haavatavat paketti, otsese või transitiivsena.

Vaadake SBOM-i genereerimine CRACI-s või broneerige demo, et uurida mõne oma buildi graafi.

Sõltuvusgraafid: korduma kippuvad küsimused

Mis on sõltuvusgraaf?

Sõltuvusgraaf on kaart igast paketist, millest teie tarkvara sõltub, kus igast paketist viib nool pakettideni, mida see vajab. See ei näita ainult seda, mis teie tarkvaras on, vaid ka seda, miks: teed teie koodist iga transitiivse sõltuvuseni.

Mis vahe on sõltuvuspuul ja sõltuvusgraafil?

Puu näitab iga teed eraldi, nii et kahe vanema vajatud pakett ilmub kaks korda. Graaf näitab iga paketti üks kord, servaga igast vanemast, mis seda vajab. Paketihaldurid prindivad puid, sest neid on lihtne lugeda; mõju analüüsivad tööriistad töötavad graafiga.

Kas SBOM sisaldab sõltuvusgraafi?

Võib sisaldada. CycloneDX-il on sõltuvuste jaotis, kus iga komponent loetleb komponendid, millest see sõltub, ja SPDX väljendab sama DEPENDS_ON seostega. Paljud SBOM-id jätavad seosed välja ja loetlevad ainult komponendid, mis kaotab teed.

Kuidas näha GitHubi repositooriumi sõltuvusgraafi?

Avage repositooriumi Insights-vahekaart ja valige Dependency graph. GitHub ehitab selle repositooriumi manifestidest ja lukufailidest ning sellest, mis on esitatud tema dependency submission API kaudu, ja seda toetavate ökosüsteemide puhul näitab teed, mis iga transitiivse sõltuvuse kaasa tõi.

Mis on teemantsõltuvus?

Kaks teie sõltuvust sõltuvad mõlemad samast paketist, nii et graaf moodustab teemandi. Kui need vajavad sellest omavahel ühildumatuid versioone, peab paketihaldur installima kaks koopiat või ebaõnnestuma, mis on üks põhjustest, miks graafi haldamine on keerulisem, kui paistab.

Vaadake graafi sellest, mida teie build kaasa tõi

Käitage üht GitHub Actionsi töövoogu CRACI-s ja uurige selle salvestatud SBOM-i sõltuvusgraafi puu igal sügavusel.

Broneerige demo