V roce 2026 o 138% více nahlášených CVE denně než loni.Novinka: stále aktivní Fixboxy. Zranitelné závislosti, opravené a ověřené.

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_request nahraje své výsledky jako artefakt a workflow workflow_run s 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:github př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