Bezpečnost CI/CD
Bezpečnost GitHub Actions: checklist pro zabezpečení vašich workflow
Workflow GitHub Actions spouští kód mnoha autorů s tokenem vašeho repozitáře, vašimi tajnými údaji a cestou do produkce. Většina opatření, která ho chrání, je v GitHubu vestavěná, ale ve výchozím stavu jsou vypnutá, volná nebo snadno nastavitelná špatně. Tento checklist prochází každé z nich: co nastavit, proč na tom záleží a incident, který ukazuje, co se bez něj stane.
Aktualizováno
Checklist v kostce
| Položka | Čemu brání |
|---|---|
GITHUB_TOKEN s minimálními oprávněními |
Unesený krok pushuje kód, publikuje vydání nebo spouští jiná workflow |
| Připnutí nebo uzamčení akcí třetích stran | Přesunutý tag spustí ve vašem jobu kód útočníka |
pull_request_target a workflow_run brát jako privilegované |
Pwn requesty: kód z forku běží s vašimi tajnými údaji |
Data událostí mimo skripty run |
Injekce do skriptů přes názvy, jména větví a komentáře |
| OIDC místo uložených cloudových klíčů | Dlouhodobé přihlašovací údaje, které po úniku fungují ještě roky |
| Prostředí s povinnými schvalovateli | Jakákoli větev nebo workflow čte produkční tajné údaje |
Vlastníci kódu pro .github/workflows |
Nezkontrolované změny toho, co pipeline spouští |
| Politika povolených akcí | Neznámé nebo nepřipnuté akce kdekoli v organizaci |
| Žádné vlastní (self-hosted) runnery ve veřejných repozitářích | Cizí lidé spouštějí kód na vašich strojích |
| Hygiena cache a artefaktů | Otrávené cache a tokeny unikající přes nahrané soubory |
| Kontrola odchozího provozu na runnerech | Ukradené tajné údaje odeslané na server útočníka |
| Záznam každého běhu | Nevíte, které buildy spustily kompromitovanou akci nebo balíček |
Kód workflow
1. Dejte GITHUB_TOKEN minimální oprávnění
Každý job dostane GITHUB_TOKEN a může ho použít kterýkoli krok v jobu. Repozitáře a organizace vytvořené
před únorem 2023 mohou mít stále jako výchozí čtení i zápis u všech oprávnění. Nastavte výchozí hodnotu na jen čtení v
Settings → Actions → General → Workflow permissions a právo zápisu pak udělujte po jednotlivých jobech:
permissions:
contents: read
jobs:
release:
runs-on: ubuntu-latest
permissions:
contents: write
steps:
- uses: actions/checkout@<full-commit-sha>
Vše, co neuvedete, se stane none. Jednotlivá oprávnění a to, co potřebují běžné úlohy, najdete v článku
Oprávnění GITHUB_TOKEN: minimální oprávnění pro každé workflow.
2. Připínejte akce třetích stran na commit, nebo je uzamkněte
Tag jako @v4 je ukazatel, který může přesunout vlastník akce, nebo kdokoli, kdo mu ukradne přístup. Co to
znamená, ukazují dva incidenty:
- tj-actions/changed-files, březen 2025. Útočník změnil existující tagy verzí tak, aby ukazovaly na škodlivý commit (CVE-2025-30066). Akci používalo více než 23 000 repozitářů a škodlivý kód vypisoval tajné údaje z paměti runneru do logů workflow, které si ve veřejném repozitáři může přečíst kdokoli.
- aquasecurity/trivy-action, březen 2026. Bezpečnostní upozornění Aqua Security (CVE-2026-33634) uvádí, že 76 ze 77 tagů verzí akce bylo násilně přepsáno (force-push) na škodlivé commity. Vložený kód běžel před skutečným skenem, četl tajné údaje z paměti runneru a odesílal je šifrované na infrastrukturu útočníka.
Workflow, která odkazovala na plné SHA commitu, dál spouštěla kód, který spouštěla předtím. Verzi si ponechte jako komentář:
steps:
# Mutable: whoever controls the tag decides what runs
- uses: tj-actions/changed-files@v45
# Immutable: a full commit SHA, with the version as a comment
- uses: tj-actions/changed-files@<full-commit-sha> # v46.0.1
Ověřte, že SHA pochází z vlastního repozitáře akce, ne z forku. GitHub dnes nabízí něco silnějšího:
lockfily
závislostí workflow, obecně dostupné od 28. října 2026. Rozšíření CLI gh actions-lock zapíše
.github/workflows/actions.lock, který zaznamenává přesný commit každé akce, kterou vaše workflow používají,
včetně akcí, které tyto akce volají, a GitHub při běhu ověřuje, že každý zdrojový repozitář je stále ten, který jste
uzamkli. Volání opakovaně použitelných workflow (reusable workflows) pokrytá nejsou, ty proto připněte na SHA.
Administrátoři mohou lockfile vyžadovat politikou. Ani připnutí, ani lockfile akci bezpečnou neudělají: kontrolujte, co
uzamykáte.
Připnuté akce se samy neaktualizují. Nechte Dependabot navrhovat aktualizace s prodlevou (cooldown), aby nové vydání mělo několik dní na odhalení, než se k vám dostane:
# .github/dependabot.yml
version: 2
updates:
- package-ecosystem: "github-actions"
directory: "/"
schedule:
interval: "weekly"
cooldown:
default-days: 7
3. Berte pull_request_target a workflow_run jako privilegované
Workflow pull_request z forku dostane token jen pro čtení a žádné tajné údaje. Workflow
pull_request_target běží v kontextu základního repozitáře, s jeho tajnými údaji a tokenem, který může
zapisovat, i když pull request pochází z forku. To je bezpečné jen tehdy, pokud workflow nikdy nespustí kód z pull
requestu. Stáhněte (checkout) head pull requestu a sestavte ho, a každý instalační skript a test v tom pull requestu
poběží s vašimi tajnými údaji. GitHub Security Lab jim říká
pwn
requesty.
- Pro vše, co sestavuje nebo testuje přispěný kód, používejte
pull_request. -
Pokud musí následovat privilegovaný krok, například komentář k pull requestu, rozdělte to: neprivilegované workflow
pull_requestnahraje své výsledky jako artefakt a workflowworkflow_runs nimi pracuje. Tyto artefakty berte jako nedůvěryhodný vstup, nikdy jako kód ke spuštění. -
Ve veřejných repozitářích bez politiky událostí GitHub od 2. prosince 2026
ve
výchozím stavu blokuje
pull_request_target. Pokud ho znovu povolíte, povolte ho jen pro workflow, která ho potřebují.
Kompromitace TanStack v květnu 2026 začala právě takto: workflow pull_request_target spustilo kód z forku,
který otrávil cache, kterou později obnovilo workflow pro vydání, a token OIDC přečtený z paměti runneru posloužil
k publikování 84 škodlivých
verzí 42 balíčků.
4. Nedávejte data událostí do skriptů run
Výrazy se rozbalují dřív, než se spustí shell, takže název pull requestu, jméno větve, text issue nebo zpráva commitu
uvnitř run se stane součástí skriptu. Kdokoli, kdo může otevřít pull request nebo issue, pak může ve vašem
jobu spouštět příkazy. Hodnotu předejte přes proměnnou prostředí, aby ji shell bral jako data:
# Vulnerable: the title is pasted into the script before the shell runs
- run: echo "Checking ${{ github.event.pull_request.title }}"
# Safe: the shell reads the title as data
- env:
PR_TITLE: ${{ github.event.pull_request.title }}
run: echo "Checking $PR_TITLE"
Totéž platí pro actions/github-script a pro hodnoty zapisované do GITHUB_ENV. AI agenti ve
workflow přidávají novou podobu stejného problému: text v issue může řídit agenta místo shellu. Viz
prompt injection.
Tajné údaje a nasazení
5. Používejte OIDC místo dlouhodobých cloudových klíčů
Cloudový přístupový klíč uložený jako tajný údaj funguje, dokud ho někdo nerotuje, což je po úniku často pozdě. S OpenID Connect si job vyžádá od GitHubu krátkodobý token a vymění ho u AWS, Azure nebo Google Cloud, jejichž politika důvěry rozhoduje, který repozitář, větev nebo prostředí smí roli převzít:
jobs:
deploy:
runs-on: ubuntu-latest
environment: production
permissions:
contents: read
id-token: write
steps:
- uses: aws-actions/configure-aws-credentials@<full-commit-sha>
with:
role-to-assume: arn:aws:iam::123456789012:role/deploy
aws-region: us-east-1
Krátkodobý token lze z běžícího jobu stále ukrást, jak ukázal TanStack, ale má mnohem menší hodnotu než klíč, který nikdy nevyprší. Tajné údaje, které si ponecháte, předávejte jen kroku, který je potřebuje, ne celému jobu, aby je ostatní akce v jobu nemohly číst. Jak tajné údaje unikají a další opatření popisuje článek Tajné údaje v GitHub Actions: jak unikají a jak je zabezpečit.
6. Dejte produkci za prostředí s povinnými schvalovateli
Prostředí má vlastní tajné údaje a job, který ho uvádí, je nemůže číst, dokud běh neschválí povinný schvalovatel. Pravidla větví pro nasazení omezují, které větve ho vůbec smějí používat. Workflow na feature větvi nebo workflow spuštěné pull requestem pak nemá k produkčním přihlašovacím údajům žádnou cestu.
Správa a řízení
7. Vyžadujte u souborů workflow review od vlastníka kódu
Soubor workflow rozhoduje o tom, co poběží s vašimi tajnými údaji, takže jeho změna si zaslouží stejné review jako
změna přístupu do produkce. Přidejte složku do CODEOWNERS a v sadě pravidel větve (branch ruleset)
vyžadujte review od vlastníka kódu:
/.github/workflows/ @example-org/platform-security
/.github/actions/ @example-org/platform-security
8. Omezte, které akce smějí běžet
Na úrovni enterprise, organizace nebo repozitáře může politika povolených akcí omezit akce na ty od GitHubu, od
ověřených tvůrců nebo ze seznamu, který spravujete. Od
srpna
2025 umí také vyžadovat připnutí na SHA, takže workflow, které použije nepřipnutou akci, selže, a zablokovat
konkrétní akci nebo verzi položkou s !, což pomůže v den, kdy je akce, kterou používáte, nahlášena jako
kompromitovaná.
Runnery, cache a artefakty
9. Nepoužívejte vlastní runnery ve veřejných repozitářích
Referenční příručka GitHubu k bezpečnému používání uvádí, že vlastní (self-hosted) runnery by se pro veřejné repozitáře neměly používat téměř nikdy, protože kdokoli může otevřít pull request a spustit na nich kód. V soukromých repozitářích používejte runnery, které pro každý job startují načisto: dlouhodobě běžící runner si ponechá vše, co jeden job zanechá, pro ten další, včetně zadních vrátek. Npm červ Shai-Hulud registroval infikované stroje jako vlastní runnery právě z tohoto důvodu. Viz spravované vs vlastní runnery.
10. Chraňte cache před otrávením
Cache jsou omezené na větev a cache uložené na výchozí větvi může obnovit každá jiná větev. Kód, který běží v jakémkoli workflow na výchozí větvi, proto může zapsat položky cache, které později obnoví workflow pro vydání, a to bez tokenu s právem zápisu. Nepouštějte nedůvěryhodný kód do workflow na výchozí větvi, v jobech pro vydání a publikování se obnovování cache vyhněte a sestavujte tam místo toho z lockfilu. Viz jak funguje cache GitHub Actions.
11. Zacházejte s artefakty jako s nedůvěryhodnými
actions/checkout si ponechává token na disku pro pozdější příkazy git, pokud to nevypnete. Nahrání
pracovního prostoru jako artefaktu tento token v minulosti vyzradilo. U checkoutů, které nepushují, nastavte
persist-credentials: false, nahrávejte jen cesty, které potřebujete, a nikdy ve privilegovaném workflow
nespouštějte artefakt z pull requestu:
- uses: actions/checkout@<full-commit-sha>
with:
persist-credentials: false
Síť a záznamy
12. Kontrolujte, kam se joby mohou připojit
Runnery GitHub-hosted neomezují odchozí provoz, takže kód v jobu může to, co přečte, odeslat kamkoli. Většina jobů potřebuje krátký seznam cílů: registry balíčků, registry kontejnerů, hostitele zdrojového kódu a několik API. Ty povolte a zbytek blokujte, a ukradený tajný údaj nebude mít kam odejít, ani při útoku, který nikdo dosud neviděl. Egress policy nezastaví tajné údaje vypsané do logů, jako v případě tj-actions, a proto patří vedle připínání, ne místo něj. Viz jak egress policy zastaví únik dat z GitHub Actions.
13. Zaznamenávejte, které akce a balíčky každý běh použil
Když je oznámena další kompromitovaná akce nebo balíček, první otázka zní, které z vašich běhů ji použily. Soubor workflow říká, co měl běh použít. Tag, rozsah verzí nebo zásah do cache mohou odpověď změnit a záznam, který ji rozhodne, je ten pořízený během běhu jobu: commit každé akce, každý balíček stažený nebo obnovený z cache a spojení, která job navázal. Viz SBOM v GitHub Actions.
Bezplatné nástroje, které auditují vaše workflow
Většinu výše uvedených položek týkajících se workflow lze kontrolovat automaticky. Tyto nástroje čtou soubory workflow; job během běhu nesledují.
| Nástroj | Co kontroluje |
|---|---|
| zizmor | Statická analýza konfigurace GitHub Actions, Dependabotu a pre-commit: template injection, nebezpečné spouštěče, nadměrná oprávnění, nepřipnuté akce, podvržené commity (impostor commits), otrávení cache a přihlašovací údaje ponechané po checkoutu |
| actionlint |
Linter syntaxe a výrazů workflow, který také označuje nedůvěryhodné hodnoty použité ve vložených skriptech a na
kroky run spouští shellcheck
|
| OpenSSF Scorecard | Kontroly repozitáře včetně Dangerous-Workflow (nedůvěryhodné checkouty a injekce do skriptů), Token-Permissions a Pinned-Dependencies |
| poutine | Open source skener build pipeline od BoostSecurity, který pokrývá GitHub Actions, GitLab, Azure DevOps a Tekton a dokáže proskenovat každý repozitář v organizaci |
| CodeQL | Skenování kódu od GitHubu, které od roku 2025 analyzuje workflow na vzory injekcí a pwn requestů |
Spouštějte jeden z nich v pull requestech, které mění .github/. Jak zapadají vedle kontrol runnerů
a nástrojů pro posture, viz srovnání nástrojů pro bezpečnost CI/CD a
bezpečnost CI/CD. Checklist, který místo nastavení GitHub Actions pokrývá celou
pipeline, najdete v checklistu zabezpečení CI/CD pipeline.
Jak pomáhá CRACI
CRACI nahrazuje runner, ne GitHub Actions: změníte runs-on na craci a workflow, tajné údaje,
oprávnění tokenu i historie běhů zůstávají v GitHubu. Pokrývá poslední položky tohoto seznamu, ty, které se dějí během
běhu jobu:
- Kontrola odchozího provozu. Egress policy rozhoduje, na které zdroje balíčků, registry a hostitele se job smí dostat. Ověřuje se před spuštěním jobu, vynucuje se na runneru a při selhání vše zablokuje (fail-closed) a zablokované spojení vyvolá upozornění.
-
Záznam každého běhu. SBOM jobu uvádí GitHub Actions, které spustil, jako komponenty
pkg:githubpřipnuté na použitý commit, a každý balíček, který stáhl, včetně balíčků obnovených z cache, se stopou jeho síťových spojení. Když se tagy akce přesunou, vidíte, který commit každý běh skutečně spustil. - Kontrolní brány politik (policy gates). Build, který stáhne balíček se známou zranitelností, včetně konkrétního CVE, lze zastavit.
- Izolace. Každý job běží ve vlastním virtuálním stroji, takže nic nepřejde do dalšího.
CRACI neaudituje vaše soubory workflow, neskenuje zdrojový kód ani nehledá tajné údaje, takže si pro to ponechte linter workflow, jako je zizmor, skenování tajných údajů od GitHubu a svůj nástroj SAST. Spouští joby GitHub Actions na Linuxu a další systémy CI jsou v plánu vývoje.
Bezpečnost GitHub Actions: časté dotazy
Jak zabezpečit GitHub Actions?
Nastavte GITHUB_TOKEN na jen čtení a právo zápisu udělujte po jednotlivých jobech, připínejte nebo uzamykejte akce třetích stran, nespouštějte kód z pull requestů ve workflow pull_request_target, předávejte data událostí do skriptů přes proměnné prostředí, používejte OIDC místo uložených cloudových klíčů, dejte produkční tajné údaje za prostředí, vyžadujte review souborů workflow a kontrolujte, kam se joby mohou připojit.
Mám připínat GitHub Actions na SHA commitu?
Ano, u akcí třetích stran. Tag lze přesunout na jiný kód, jak se stalo u tj-actions/changed-files v roce 2025 a u trivy-action v roce 2026, kdežto plné SHA commitu ne. Lockfily workflow od GitHubu jdou dál a uzamykají i akce, které vaše akce volají.
Je pull_request_target nebezpečný?
Je bezpečný jen tehdy, pokud workflow nikdy nespustí kód z pull requestu. Běží s tajnými údaji základního repozitáře a tokenem s právem zápisu i pro forky, takže sestavení kódu z forku v něm předá obojí tomu, kdo pull request otevřel. GitHub ho od 2. prosince 2026 ve výchozím stavu blokuje ve veřejných repozitářích bez politiky událostí.
Co je pwn request?
Název, který GitHub Security Lab používá pro privilegované workflow, obvykle spouštěné přes pull_request_target, které stáhne a spustí nedůvěryhodný kód z pull requestu, čímž autorovi dá přístup k tajným údajům a tokenu workflow.
Jsou lockfily workflow lepší než připínání na SHA?
Jsou silnější. Lockfile zaznamenává commit každé akce, kterou workflow používá, včetně tranzitivních, a GitHub při běhu ověřuje identitu zdrojového repozitáře. Volání opakovaně použitelných workflow pokrytá nejsou, ta proto připněte na SHA.
Které bezplatné nástroje kontrolují bezpečnostní problémy ve workflow GitHub Actions?
zizmor, actionlint, OpenSSF Scorecard a poutine jsou zdarma a CodeQL umí analyzovat workflow v rámci skenování kódu na GitHubu. Čtou soubory workflow; nekontrolují, co job dělá během běhu.
Podívejte se, co jedno z vašich workflow skutečně spustilo
Spusťte job GitHub Actions na CRACI a získejte commit každé akce, každý stažený balíček a egress policy, která při selhání vše zablokuje.
Rezervujte si demo