Koodausagentit, kuten Copilot, Claude Code, Cursor, Devin ja Codex, avaavat nyt pull requesteja itse. Ihminen katselmoi ne yhä, ja hän lukee diffin: logiikan, testit ja nimeämisen. Se katselmointi kannattaa tehdä, mutta suurin osa toimitusketjun riskeistä ei näy siinä.
Eniten vahinkoa voivat tehdä ne muutokset, jotka diff näyttää huonoiten. Yhden rivin muutos manifestiin voi tuoda mukanaan paketin, josta kukaan ei ole kuullut. Lukitustiedoston muutos venyy satoihin riveihin, joita kukaan ei lue. Asennusskripti ei näy diffissä lainkaan, eikä myöskään tiedosto, jonka build lataa buildin aikana. Tämä kirjoitus käy läpi tarkistukset, jotka tiimi voi asettaa agentin pull requestin ja julkaisun väliin, ja sen, mitä kukin niistä havaitsee.
Diff on väärä paikka etsiä toimitusketjun riskejä
Koodikatselmointi luotiin koodille, jonka ihminen on kirjoittanut ja osaa selittää. Agentin kohdalla tekijä ei voi kertoa, miksi se valitsi paketin, ja katselmoijalla on houkutus hyväksyä muutos, joka kääntyy ja läpäisee omat testinsä. Neljä muutostyyppiä ansaitsee enemmän huomiota kuin ne saavat:
- Uudet tai muuttuneet riippuvuudet. Manifestin rivi on lyhyt; se, mitä se tuo mukanaan, ei ole.
- Lukitustiedoston vaihtuvuus. Satoja ratkaistuja versioita ja tiivisteitä, jotka katselmointinäkymä yleensä piilottaa oletuksena.
- Asiat, joita build tekee, eivät asiat, joita repositorio sisältää. Asennusskriptit, lataavat build-skriptit, peruskuvat,
curltyönkulun vaiheessa. - Työnkulkutiedostot. Muutos hakemistoon
.github/workflows/muuttaa sitä, mitä ajetaan salaisuuksiesi kanssa.
Mikään näistä ei edellytä, että agentti on vaarantunut. Malli, joka kirjoittaa uskottavaa koodia, kirjoittaa myös uskottavia pakettien nimiä, ja uskottava nimi on kaikki, mitä hyökkääjä tarvitsee.
Uudet riippuvuudet: tarkista, että paketti on aito
Kielimallit ehdottavat joskus paketteja, joita ei ole olemassa. USENIX Security 2025 -konferenssissa esitelty tutkimus tuotti 576 000 koodinäytettä 16 mallilla ja havaitsi, että vähintään 5,2 % kaupallisten mallien ja 21,7 % avoimen lähdekoodin mallien ehdottamista paketeista ei ollut olemassa, ja keksittyjä uniikkeja nimiä oli 205 474. Näiden nimien rekisteröintiä ja odottamista kutsutaan nimellä slopsquatting. Se on typosquattingia ilman kirjoitusvirhettä, ja agentti, joka asentaa paketteja itse, poistaa ketjusta ihmisen, joka olisi ehkä huomannut sen.
Ennen kuin yhdistät pull requestin, joka lisää riippuvuuden, tarkista:
- Että paketti on olemassa ja on se, jota tarkoitit. Vertaa nimeä merkki merkiltä siihen projektiin, jota agentti yritti käyttää.
- Kuinka vanha se on. Paketti tai versio, joka on julkaistu muutama päivä sitten, ansaitsee epäilyä. pnpm:n
minimumReleaseAge-asetus hylkää versiot, jotka on julkaistu alle asetetun minuuttimäärän sitten, myös transitiiviset. - Kuka sen takana on. Linkitetty lähdekoodirepositorio, julkaisuhistoria ja useampi kuin yksi ylläpitäjä eivät todista turvallisuutta, mutta niiden puuttuminen on varoitusmerkki.
- Tarvitsitko sitä. Agentit lisäävät paketteja asioihin, jotka standardikirjasto tai olemassa oleva riippuvuus jo hoitaa. Vähemmän riippuvuuksia on halvin kontrolli, mitä on olemassa.
GitHubin dependency review action ajetaan pull requesteissa, se listaa riippuvuusmuutokset ja voi hylätä tarkistuksen tunnettujen haavoittuvuuksien tai kiellettyjen lisenssien vuoksi. Se ei kuitenkaan tiedä eilen julkaistusta paketista, josta ei ole tietoturvatiedotetta, joten se täydentää yllä olevia tarkistuksia eikä korvaa niitä.
Lukitustiedoston muutokset: lue ne ja tiedä, mitä niistä puuttuu
Lukitustiedosto lukitsee tarkat versiot ja eheystiivisteet, jotka paketinhallinta ratkaisi. Agentin pull requestissa se on tarkin tallenne siitä, mikä muuttui, joten tee se näkyväksi: laajenna se katselmoinnissa ja anna buildin epäonnistua, kun lukitustiedosto ja manifesti ovat ristiriidassa (npm ci, pnpm install --frozen-lockfile).
Etsi kahta asiaa:
- Muuttunut lähde. Paketti, joka ennen ratkaistiin sisäisestä rekisteristäsi ja nyt julkisesta, on dependency confusion -hyökkäyksen taustalla oleva kuvio. Rajaa sisäiset paketit scopella omaan rekisteriisi, jotta julkiselta rekisteriltä ei koskaan kysytä.
- Transitiiviset hypyt. Pieni suoran riippuvuuden päivitys voi siirtää kymmeniä transitiivisia paketteja. Niitä versioita kukaan ei valinnut.
Lukitustiedosto kirjaa silti vain sen, minkä paketinhallinta ratkaisi. Se ei kerro mitään siitä, mitä asennusskripti lataa, mitä Rustin build-skripti hakee, minkä peruskuvan Dockerfile vetää tai mitä työnkulun vaihe hakee curl:lla. Nämä ovat piilotettuja riippuvuuksia, ja ne päätyvät tuotteeseen siitä huolimatta.
Asennusskriptit ajetaan ennen kuin kukaan on katselmoinut mitään
Tässä on epämukava osa: CI ajetaan pull requestissa. Heti kun agentin haara buildataan, sen uudet riippuvuudet asennetaan, ja niiden preinstall- ja postinstall-skriptit ajetaan kaiken sen kanssa, mihin jobi ylettää. Katselmointi tapahtuu vasta jälkeenpäin.
Nx:n vaarantuminen elokuussa 2025 osoitti, mihin tämä johtaa. npm:ssä olleet haitalliset Nx-versiot sisälsivät postinstall-skriptin, joka ylläpitäjien jälkiselvityksen mukaan yritti käyttää paikallisia tekoälytyökaluja, kuten Claudea ja Geminiä, arkaluonteisten tiedostojen etsimiseen koneelta.
Näin riskiä voi kaventaa:
- Älä aja elinkaariskriptejä oletuksena. pnpm käsittelee riippuvuuksien build-skriptejä katselmoimattomina, kunnes sallit ne; npm:ssä ne saa pois päältä valinnalla
--ignore-scripts. - Pidätä CI agenttien pull requesteissa, kunnes joku katsoo ne. GitHubin Copilot cloud agent tekee tämän oletuksena: työnkulkuja ei käynnistetä ennen kuin kirjoitusoikeudet omaava käyttäjä hyväksyy ajon.
- Pidä salaisuudet poissa pull requestien jobeista. Testijobi tarvitsee harvoin julkaisutokenia. Katso GitHub Actionsin salaisuudet: miten ne vuotavat ja miten ne suojataan.
Vertaa buildin hakemaa sisältöä edelliseen julkaisuun
Vahvin portti ei katso pull requestia lainkaan. Se katsoo, mitä build teki: mitkä paketit ja tiedostot jobi todella haki ja mistä. Buildin aikainen SBOM tallentaa tämän buildin ajon aikana, joten se sisältää myös piilotetut riippuvuudet, jotka lukitustiedostosta puuttuvat.
Vertaa sitä edellisen julkaisusi SBOM:iin, niin kysymykset muuttuvat konkreettisiksi:
- Mitkä komponentit ovat uusia, ja minkä versio muuttui?
- Alkoiko jokin paketti tulla eri lähteestä?
- Latasiko build jotain palvelimelta, johon se ei ole koskaan aiemmin ottanut yhteyttä?
Kaikelle uudelle pitäisi olla pull requestin kuvauksessa rivi, joka selittää sen. Komponentti, jota kukaan ei osaa selittää, on se, jonka kohdalla pysähdytään. SBOM:n tuottamisen tavoista CI:ssä kerrotaan kirjoituksessa Miten SBOM luodaan GitHub Actionsissa.
Työnkulkutiedostot tarvitsevat oman omistajansa
Agentti, joka muokkaa työnkulkua, voi muuttaa sitä, mitä ajetaan tokeniesi ja salaisuuksiesi kanssa. Käsittele hakemistoa .github/workflows/ tietoturvan kannalta herkkänä koodina, jolla on omat katselmoijansa. GitHubin turvallisen käytön ohje ehdottaa hakemiston lisäämistä CODEOWNERS-tiedostoon:
/.github/workflows/ @your-org/platform-security
Etsi näistä muutoksista:
- Laajempia oikeuksia. Uudelle
contents: write- taiid-token: write-oikeudelle pitäisi olla syy. Katso GITHUB_TOKEN-oikeudet. - Uusia käynnistimiä.
pull_request_targetajetaan luku- ja kirjoitusoikeudet omaavalla tokenilla ja repositorion salaisuuksilla, myös forkeista tulevissa pull requesteissa. - Lukitsemattomia actioneita. Uusi action, johon viitataan tagilla eikä täydellä commit-SHA:lla, voi muuttua huomaamattasi.
- Salaisuuksia uusissa paikoissa. Salaisuus, joka välitetään vaiheelle, joka ei aiemmin tarvinnut sitä.
Rajaa, mihin build voi ottaa yhteyttä
Jokainen yllä oleva tarkistus voi pettää. Upouudella haitallisella paketilla ei ole tietoturvatiedotetta, sillä on vakuuttava nimi ja puhdas diff. Se tarvitsee kuitenkin verkkoyhteyden: hakeakseen toisen vaiheensa tai lähettääkseen salaisuutesi jonnekin.
Egress-käytäntö sallii buildin ottaa yhteyttä vain tarvitsemiinsa rekistereihin ja palvelimiin eikä mihinkään muuhun. Se ei edellytä hyökkäyksen tuntemista, joten se toimii jo ensimmäisellä kerralla, kun uusi hyökkäys ajetaan putkessasi.
Pidä ihminen hyväksyntäpolulla
Agenttien ei pitäisi pystyä hyväksymään omaa työtään, eikä myöskään sen ihmisen, joka työtä pyysi. GitHubin Copilot cloud agent estää käyttäjää, joka pyysi sitä luomaan pull requestin, hyväksymästä sitä, ja olemassa olevat haarasuojaukset ja pakolliset tarkistukset ovat edelleen voimassa.
Tee sama todeksi jokaiselle agentille oletushaaran ruleseteillä:
- Vaadi pull request ja vähintään yksi hyväksyntä.
- Vaadi koodin omistajien katselmointi, jotta työnkulku- ja riippuvuusmuutokset päätyvät oikeille ihmisille.
- Hylkää vanhentuneet hyväksynnät, kun uudet commitit muuttavat diffiä, sillä agentit jatkavat pushaamista katselmoinnin jälkeenkin.
- Vaadi tilatarkistukset, mukaan lukien yllä kuvatut riippuvuus- ja SBOM-tarkistukset.
Jotkin työkalut siirtävät porttia aikaisemmaksi. Esimerkiksi AI CodeOps avaa pull requestin vasta, kun testisarja on mennyt läpi juuri sillä versiolla, tekoälyn katselmointi diffistä ei ole löytänyt huomautettavaa ja ihminen on hyväksynyt sen.
Valvo julkaisua, ei vain mergeä
Merge-portti näkee yhden muutoksen. Julkaisuportti näkee kaiken, mikä on muuttunut edellisen julkaisun jälkeen, myös riippuvuudet, jotka olivat kunnossa yhdistettäessä ja joista on sittemmin löytynyt haavoittuvuus. Ennen julkaisua:
- Tarkista julkaisun komponentit uudelleen ajantasaisia tietoturvatiedotteita vasten ja estä tunnetut kriittiset haavoittuvuudet ja tunnetut haitalliset julkaisut.
- Tarkista lisenssit kaikesta, mikä on tullut uutena edellisen julkaisun jälkeen.
- Säilytä tallenne siitä, mitä julkaisubuild haki, jotta voit myöhemmin vastata kysymykseen ”koskiko tämä meitä?”. Katso Koskeeko tämä meitä? Miten uusi CVE arvioidaan kaikissa buildeissa.
Mihin CRACI sopii
CRACI ei katselmoi koodia, jonka agentti kirjoittaa. Se ei myöskään tunnista uusia haitallisia paketteja, joten tarkista uudet riippuvuudet yllä kuvatuilla tarkistuksilla. CRACI kattaa buildin.
CRACI ajaa GitHub Actions -jobisi omilla runnereillaan, jotka ovat noin kaksi kertaa nopeampia kuin GitHubin ylläpitämät runnerit. Vaihdat runs-on-arvoksi craci, ja ajot näkyvät edelleen GitHubissa. Jokaisen jobin aikana CRACI tallentaa jokaisen paketin, jonka jobi todella haki, myös CI-välimuisteista palautetut paketit ja piilotetut riippuvuudet, kuten npm:n asennuskoukkujen lataaman koodin: tallennin, ei skanneri. Jokaisen jobin SBOM:ssa on täydellisyystila, joka kertoo, mitä CRACI ei nähnyt, ja sen voi viedä CycloneDX- tai SPDX-muodossa, joten voit verrata pull requestin buildia edelliseen julkaisuusi. Sisäänrakennettu julkaisujen vertailu on tiekartalla.
Runnerilla egress-käytäntö päättää, mihin palvelimiin jobi saa ottaa yhteyttä. Se validoidaan ennen jobin alkua, noudattaa fail closed -periaatetta ja voidaan asettaa default deny -tilaan, joten agentin pull requestissa oleva haitallinen riippuvuus ei pääse palvelimelle, jota build ei tarvitse, vaikka kukaan ei olisi nähnyt hyökkäystä aiemmin. Käytäntörikkomukset laukaisevat hälytyksiä. Käytäntöportit voivat estää buildin löydösten perusteella, myös buildit, jotka sisältävät tietyn CVE:n, ja lisenssikäytännön säännöt voivat estää buildin lisenssin perusteella. Julkaisun jälkeen CRACI arvioi valvomiaan SBOM:eja jatkuvasti uudelleen uusia tietoturvatiedotteita vasten, ja buildihistoria näyttää, mitkä buildit sisälsivät haavoittuvan riippuvuuden.
Varaa demo nähdäksesi tallenteen yhdestä omasta buildistasi.
