Agenti pro psaní kódu jako Copilot, Claude Code, Cursor, Devin a Codex dnes sami otevírají pull requesty. Kontroluje je stále člověk a ten čte diff: logiku, testy, pojmenování. Taková kontrola má smysl, ale většina rizik dodavatelského řetězce se v ní neukáže.

Nejvíc vám mohou ublížit změny, které diff ukazuje nejhůř. Jednořádková úprava manifestu může přitáhnout balíček, o kterém nikdo neslyšel. Změna lockfilu má stovky řádků, které nikdo nečte. Instalační skript se v diffu neobjeví vůbec, stejně jako soubor, který build stáhne během buildu. Tento článek popisuje kontroly, které může tým zařadit mezi pull request agenta a vydání, a co která z nich zachytí.

Diff je špatné místo pro hledání rizik dodavatelského řetězce

Code review vzniklo pro kód, který napsal člověk a umí ho vysvětlit. U agenta vám autor neřekne, proč zvolil daný balíček, a recenzent je v pokušení schválit změnu, která se zkompiluje a projde svými testy. Čtyři druhy změn si zaslouží víc pozornosti, než dostávají:

  • Nové nebo změněné závislosti. Řádek v manifestu je krátký; to, co přitáhne, už ne.
  • Změny v lockfilu. Stovky rozlišených verzí a hashů, v rozhraní pro review obvykle ve výchozím stavu sbalené.
  • To, co build dělá, ne to, co repozitář obsahuje. Instalační skripty, skripty buildu, které něco stahují, základní image, curl v kroku workflow.
  • Soubory workflow. Změna v .github/workflows/ mění to, co běží s vašimi secrets.

Nic z toho nevyžaduje, aby byl agent kompromitovaný. Model, který píše věrohodný kód, píše i věrohodné názvy balíčků, a věrohodný název je vše, co útočník potřebuje.

Nové závislosti: ověřte, že balíček skutečně existuje

Jazykové modely někdy navrhují balíčky, které neexistují. Studie představená na USENIX Security 2025 vygenerovala 576 000 ukázek kódu pomocí 16 modelů a zjistila, že nejméně 5,2 % balíčků navržených komerčními modely a 21,7 % balíčků navržených open source modely neexistovalo, přičemž unikátních vymyšlených názvů bylo 205 474. Registrace takových názvů a čekání se nazývá slopsquatting. Je to typosquatting bez překlepu a agent, který sám instaluje balíčky, odstraní člověka, který by si toho mohl všimnout.

Než sloučíte pull request, který přidává závislost, ověřte:

  • Že existuje a je to ten, který jste mysleli. Porovnejte název s projektem, který chtěl agent použít, znak po znaku.
  • Jak je starý. Balíček nebo verze zveřejněná před pár dny si zaslouží podezření. Nastavení minimumReleaseAge v pnpm odmítá verze zveřejněné před méně než nastaveným počtem minut, včetně tranzitivních.
  • Kdo za ním stojí. Propojený zdrojový repozitář, historie vydání a více než jeden správce nejsou důkazem bezpečnosti, ale jejich absence je varováním.
  • Zda jste ho potřebovali. Agenti přidávají balíčky na věci, které už zvládá standardní knihovna nebo existující závislost. Méně závislostí je ta nejlevnější kontrola, jaká existuje.

Dependency review action od GitHubu běží na pull requestech, vypíše změny závislostí a u známých zranitelností nebo nepovolených licencí může kontrolu shodit. O balíčku zveřejněném včera, ke kterému neexistuje žádné bezpečnostní upozornění, ale neví, takže kontroly výše doplňuje, nenahrazuje je.

Změny v lockfilu: čtěte je a vězte, co v nich chybí

Lockfile připíná přesné verze a hashe integrity, které rozlišil správce balíčků. V pull requestu od agenta je to nejpřesnější záznam toho, co se změnilo, proto ho zviditelněte: v review ho rozbalte a nechte build selhat, když se lockfile a manifest neshodují (npm ci, pnpm install --frozen-lockfile).

Hledejte dvě věci:

  • Změněný zdroj. Balíček, který se dřív rozlišoval z vašeho interního registru a teď z veřejného, je vzorec za útokem dependency confusion. Interní balíčky omezte scopem na svůj registr, aby se veřejného registru nikdy nikdo neptal.
  • Skoky v tranzitivních závislostech. Malý upgrade přímé závislosti může posunout desítky tranzitivních balíčků. To jsou verze, které nikdo nevybral.

Lockfile ale zaznamenává jen to, co rozlišil správce balíčků. Neříká nic o tom, co stáhne instalační skript, co si stáhne build skript v Rustu, jakou základní image stahuje Dockerfile ani co krok workflow stahuje pomocí curl. To jsou skryté závislosti a do produktu se dostanou stejně.

Instalační skripty běží dřív, než cokoli někdo zkontroluje

Tady je ta nepříjemná část: CI běží na pull requestu. Ve chvíli, kdy se větev agenta sestaví, se nainstalují její nové závislosti a jejich skripty preinstall a postinstall běží se vším, k čemu má job přístup. Review přijde až potom.

Kompromitace Nx v srpnu 2025 ukázala, kam to vede. Škodlivé verze Nx na npm obsahovaly skript postinstall, který se podle postmortemu správců pokoušel použít lokální AI nástroje jako Claude a Gemini k prohledání počítače kvůli citlivým souborům.

Jak riziko zúžit:

  • Ve výchozím stavu nespouštějte lifecycle skripty. pnpm považuje build skripty závislostí za nezkontrolované, dokud je nepovolíte; u npm je vypne --ignore-scripts.
  • Pozdržte CI u pull requestů od agentů, dokud se na ně někdo nepodívá. Copilot cloud agent od GitHubu to dělá ve výchozím nastavení: workflow se nespustí, dokud běh neschválí uživatel s právem zápisu.
  • Držte secrets mimo joby pull requestů. Testovací job jen zřídka potřebuje token pro publikování. Viz Secrets v GitHub Actions: jak unikají a jak je zabezpečit.

Porovnejte, co build stáhl, s posledním vydáním

Nejsilnější brána se na pull request vůbec nedívá. Dívá se na to, co build udělal: které balíčky a soubory job skutečně stáhl a odkud. SBOM z doby buildu to zaznamenává během buildu, takže zahrnuje i skryté závislosti, které lockfile vynechává.

Porovnejte ho se SBOM posledního vydání a otázky budou konkrétní:

  • Které komponenty jsou nové a které změnily verzi?
  • Začal některý balíček přicházet z jiného zdroje?
  • Stáhl build něco z hostitele, ke kterému se nikdy dřív nepřipojil?

Cokoli nového by mělo mít v popisu pull requestu řádek, který to vysvětluje. Komponenta, kterou nikdo nedokáže vysvětlit, je ta, u které je třeba se zastavit. Způsoby, jak vytvořit SBOM v CI, popisuje článek Jak generovat SBOM v GitHub Actions.

Soubory workflow potřebují vlastního vlastníka

Agent, který upraví workflow, může změnit, co běží s vašimi tokeny a secrets. Adresář .github/workflows/ berte jako bezpečnostně citlivý kód s vlastními recenzenty. Referenční příručka GitHubu k bezpečnému používání doporučuje zařadit tento adresář do CODEOWNERS:

/.github/workflows/ @your-org/platform-security

V těchto změnách hledejte:

  • Širší oprávnění. Nové contents: write nebo id-token: write by mělo mít důvod. Viz Oprávnění GITHUB_TOKEN.
  • Nové spouštěče. pull_request_target běží s tokenem pro čtení i zápis a se secrets repozitáře, a to i u pull requestů z forků.
  • Nepřipnuté actions. Nová action odkazovaná tagem místo plného SHA commitu se vám může změnit pod rukama.
  • Secrets na nových místech. Secret předaný kroku, který ho dřív nepotřeboval.

Omezte, kam se build může připojit

Každá z kontrol výše může něco přehlédnout. Zbrusu nový škodlivý balíček nemá žádné bezpečnostní upozornění, má přesvědčivý název a čistý diff. Potřebuje ale síťové spojení: aby si stáhl druhou fázi nebo aby někam poslal vaše secrets.

Egress policy dovolí buildu připojit se k registrům a hostitelům, které potřebuje, a k ničemu dalšímu. Nezávisí na tom, že útok znáte, takže funguje hned napoprvé, kdy se nový útok ve vaší pipeline spustí.

Ponechte člověka v procesu schvalování

Agenti by neměli mít možnost schválit vlastní práci, a stejně tak ani člověk, který si ji vyžádal. Copilot cloud agent od GitHubu nedovolí uživateli, který ho požádal o vytvoření pull requestu, tento pull request schválit a stávající ochrana větví i povinné kontroly nadále platí.

Totéž zajistěte pro každého agenta pomocí rulesetů na výchozí větvi:

  • Vyžadujte pull request a alespoň jedno schválení.
  • Vyžadujte review od vlastníků kódu, aby se změny workflow a závislostí dostaly ke správným lidem.
  • Rušte zastaralá schválení, když nové commity změní diff, protože agenti pushují i po review.
  • Vyžadujte status checks, včetně kontrol závislostí a SBOM popsaných výše.

Některé nástroje posouvají bránu dřív. Například AI CodeOps otevře pull request teprve tehdy, když na přesně této verzi prošla sada testů, AI review diffu nenašlo problém a člověk změnu schválil.

Hlídejte vydání, nejen merge

Brána u merge vidí jednu změnu. Brána u vydání vidí vše, co se od posledního vydání změnilo, včetně závislostí, které byly při sloučení v pořádku a mezitím se u nich našla zranitelnost. Před vydáním:

  • Znovu zkontrolujte komponenty vydání proti aktuálním bezpečnostním upozorněním a blokujte známé kritické zranitelnosti a známá škodlivá vydání.
  • Zkontrolujte licence všeho, co od posledního vydání přibylo.
  • Uchovejte záznam toho, co build vydání stáhl, abyste později mohli odpovědět na otázku „byli jsme zasaženi?“. Viz Jsme zasaženi? Jak posoudit nový CVE napříč vašimi buildy.

Kde má své místo CRACI

CRACI nekontroluje kód, který agent napíše. Nedetekuje ani nové škodlivé balíčky, proto nové závislosti prověřujte kontrolami popsanými výše. CRACI pokrývá build.

CRACI spouští vaše joby GitHub Actions na vlastních runnerech, zhruba dvakrát rychlejších než runnery hostované na GitHubu. Změníte runs-on na craci a běhy se dál zobrazují v GitHubu. Během každého jobu CRACI zaznamenává každý balíček, který job skutečně stáhl, včetně balíčků obnovených z cache CI a skrytých závislostí, jako je kód stažený instalačními hooky npm: záznamník, ne skener. SBOM každého jobu nese stav úplnosti, který označí, co CRACI nemohlo vidět, a exportuje se ve formátu CycloneDX nebo SPDX, takže můžete build pull requestu porovnat s posledním vydáním. Vestavěné porovnání vydání je na roadmapě.

Na runneru rozhoduje egress policy, ke kterým hostitelům se job smí připojit. Validuje se před startem jobu, je fail-closed a lze ji nastavit na default deny, takže škodlivá závislost v pull requestu od agenta se nedostane k hostiteli, kterého build nepotřebuje, i když ten útok ještě nikdo neviděl. Porušení politiky spouští upozornění. Brány politik mohou zablokovat build na základě nálezů, včetně buildů obsahujících konkrétní CVE, a pravidla licenční politiky mohou zablokovat build kvůli licenci. Po vydání CRACI průběžně znovu vyhodnocuje monitorované SBOM proti novým bezpečnostním upozorněním a historie buildů ukazuje, které buildy obsahovaly zranitelnou závislost.

Rezervujte si demo a podívejte se na záznam jednoho z vašich vlastních buildů.