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

CI/CD turvalisus

GitHub Actionsi turvalisus: kontroll-loend teie töövoogude kaitsmiseks

GitHub Actionsi töövoog käitab paljude autorite koodi teie repositooriumi tokeni, teie saladuste ja teega tootmiskeskkonda. Enamik kontrolle, mis seda kaitsevad, on GitHubi sisse ehitatud, kuid vaikimisi on need välja lülitatud, liiga lõdvad või kergesti valesti seadistatavad. See kontroll-loend käsitleb neid kõiki: mida seadistada, miks see on oluline ja milline intsident näitab, mis juhtub ilma selleta.

Uuendatud

Kontroll-loend lühidalt

Punkt Mida see peatab
Minimaalsete õigustega GITHUB_TOKEN Kaaperdatud samm lükkab koodi, avaldab väljalaskeid või käivitab teisi töövooge
Kolmanda osapoole actionite kinnitamine või lukustamine Liigutatud silt käivitab teie töös ründaja koodi
pull_request_target ja workflow_run käsitlemine privilegeeritutena Pwn request'id: forgi kood töötab teie saladustega
Sündmuste andmed run-skriptidest eemal Skriptisüst pealkirjade, harunimede ja kommentaaride kaudu
OIDC salvestatud pilvevõtmete asemel Pikaajalised volitused, mis töötavad veel aastaid pärast lekkimist
Keskkonnad kohustuslike ülevaatajatega Mis tahes haru või töövoog loeb tootmiskeskkonna saladusi
Koodiomanikud kaustale .github/workflows Üle vaatamata muudatused selles, mida konveier käitab
Lubatud actionite poliitika Tundmatud või kinnitamata actionid kõikjal organisatsioonis
Avalikel repositooriumidel isehallatavaid runnereid pole Võõrad käitavad koodi teie masinates
Vahemälude ja artefaktide hügieen Mürgitatud vahemälud ja üleslaadimiste kaudu lekkivad tokenid
Väljuva liikluse kontroll runneritel Varastatud saladused saadetakse ründaja serverisse
Kirje igast käivitusest Teadmatus, millised buildid käitasid kompromiteeritud actionit või paketti

Töövoo kood

1. Andke GITHUB_TOKEN-ile minimaalsed õigused

Iga töö saab GITHUB_TOKEN-i ja iga samm töös saab seda kasutada. Enne 2023. aasta veebruari loodud repositooriumid ja organisatsioonid võivad endiselt anda vaikimisi lugemis- ja kirjutusõiguse igale õigusele. Seadke vaikeväärtuseks ainult lugemine jaotises Settings → Actions → General → Workflow permissions ja andke kirjutusõigus töö kaupa:

permissions:
  contents: read

jobs:
  release:
    runs-on: ubuntu-latest
    permissions:
      contents: write
    steps:
      - uses: actions/checkout@<full-commit-sha>

Kõik, mida te ei loetle, muutub väärtuseks none. Iga õiguse ja selle kohta, mida levinud ülesanded vajavad, lugege GITHUB_TOKEN-i õigused: minimaalsed õigused igale töövoole.

2. Kinnitage kolmanda osapoole actionid commit'i järgi või lukustage need

Silt, näiteks @v4, on viit, mida actioni omanik või igaüks, kes tema juurdepääsu varastab, saab liigutada. Kaks intsidenti näitavad, mida see tähendab:

  • tj-actions/changed-files, märts 2025. Ründaja muutis olemasolevaid versioonisilte nii, et need osutasid pahatahtlikule commit'ile (CVE-2025-30066). Actionit kasutas üle 23 000 repositooriumi ning kahjulik koormus printis runneri mälust saladusi töövoo logidesse, mida avalikus repositooriumis saab lugeda igaüks.
  • aquasecurity/trivy-action, märts 2026. Aqua Security turvateate (CVE-2026-33634) järgi lükati actioni 77 versioonisildist 76 jõuga pahatahtlikele commit'idele. Süstitud kood käivitus enne päris skannimist, luges runneri mälust saladusi ja saatis need krüpteeritult ründaja taristusse.

Töövood, mis viitasid täispikale commit'i SHA-le, käitasid edasi sama koodi mis varem. Hoidke versioon kommentaarina alles:

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

Kontrollige, et SHA pärineb actioni enda repositooriumist, mitte forgist. GitHub pakub nüüd midagi tugevamat: töövoo sõltuvuste lukufailid, üldiselt saadaval alates 28. oktoobrist 2026. CLI-laiendus gh actions-lock kirjutab faili .github/workflows/actions.lock, mis salvestab täpse commit'i iga actioni kohta, mida teie töövood kasutavad, sealhulgas actionid, mida need actionid välja kutsuvad, ning GitHub kontrollib käivitamise ajal, et iga lähterepositoorium on endiselt see, mille lukustasite. Korduvkasutatavate töövoogude väljakutsed pole kaetud, seega kinnitage need SHA järgi. Administraatorid saavad lukufaili poliitikaga kohustuslikuks teha. Ei kinnitamine ega lukufail muuda actionit turvaliseks: vaadake üle, mida lukustate.

Kinnitatud actionid ei uuenda end ise. Laske Dependabotil uuendusi pakkuda, ooteajaga, et uut väljalaset saaks mõne päeva jooksul tabada enne, kui see teieni jõuab:

# .github/dependabot.yml
version: 2
updates:
  - package-ecosystem: "github-actions"
    directory: "/"
    schedule:
      interval: "weekly"
    cooldown:
      default-days: 7

3. Käsitlege pull_request_target ja workflow_run privilegeeritutena

Forgist pärit pull_request töövoog saab ainult lugemisõigusega tokeni ja mitte ühtegi saladust. pull_request_target töövoog töötab baasrepositooriumi kontekstis, selle saladuste ja kirjutusõigusega tokeniga, isegi kui pull request tuleb forgist. See on turvaline ainult seni, kuni töövoog ei käivita kunagi pull requesti koodi. Tõmmake välja pull requesti head ja ehitage see ning iga installiskript ja test selles pull requestis töötab teie saladustega. GitHub Security Lab nimetab neid pwn request'ideks.

  • Kasutage pull_request-i kõige jaoks, mis ehitab või testib panustatud koodi.
  • Kui sellele peab järgnema privilegeeritud samm, näiteks pull requesti kommenteerimine, jagage see kaheks: privilegeerimata pull_request töövoog laadib oma tulemused üles artefaktina ja workflow_run töövoog tegutseb nende põhjal. Käsitlege neid artefakte ebausaldusväärse sisendina, mitte kunagi käivitatava koodina.
  • Avalikes repositooriumides, millel pole sündmuste poliitikat, blokeerib GitHub pull_request_target-i vaikimisi alates 2. detsembrist 2026. Kui selle uuesti lubate, lubage ainult töövood, mis seda vajavad.

TanStacki kompromiteerimine 2026. aasta mais algas just nii: pull_request_target töövoog käivitas forgi koodi, mis mürgitas vahemälu, mille väljalaske töövoog hiljem taastas, ning runneri mälust loetud OIDC-tokeniga avaldati 84 pahatahtlikku versiooni 42 paketist.

4. Hoidke sündmuste andmed run-skriptidest eemal

Avaldised laiendatakse enne shelli käivitumist, nii et pull requesti pealkiri, haru nimi, issue sisu või commit'i sõnum run-i sees muutub skripti osaks. Igaüks, kes saab avada pull requesti või issue, saab seejärel teie töös käske käivitada. Edastage väärtus keskkonnamuutuja kaudu, nii et shell käsitleb seda andmetena:

# 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"

Sama kehtib actions/github-script-i ja GITHUB_ENV-i kirjutatud väärtuste kohta. Töövoogudes olevad AI-agendid lisavad sama probleemi uue vormi: issue tekst võib juhtida shelli asemel agenti. Vaadake viipesüst (prompt injection).

Saladused ja juurutused

5. Kasutage OIDC-d pikaajaliste pilvevõtmete asemel

Saladusena salvestatud pilve juurdepääsuvõti töötab, kuni keegi selle välja vahetab, mis on pärast leket sageli liiga hilja. OpenID Connectiga küsib töö GitHubilt lühiajalise tokeni ja vahetab selle AWS-i, Azure'i või Google Cloudiga, mille usalduspoliitika otsustab, milline repositoorium, haru või keskkond tohib rolli võtta:

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

Lühiajalise tokeni saab töötavast tööst siiski varastada, nagu TanStack näitas, kuid see on palju vähem väärt kui võti, mis kunagi ei aegu. Edastage saladused, mida alles hoiate, ainult neid vajavale sammule, mitte kogu tööle, nii et teised actionid töös ei saa neid lugeda. Kuidas saladused lekivad ja ülejäänud kontrollid leiate artiklist GitHub Actionsi saladused: kuidas need lekivad ja kuidas neid kaitsta.

6. Pange tootmiskeskkond kohustuslike ülevaatajatega keskkondade taha

Keskkonnal on oma saladused ja töö, mis sellele viitab, ei saa neid lugeda enne, kui kohustuslik ülevaataja käivituse heaks kiidab. Juurutusharude reeglid piiravad, millised harud seda üldse kasutada tohivad. Funktsiooniharu töövoogul või pull requesti käivitatud töövoogul pole siis teed tootmiskeskkonna volitusteni.

Juhtimine

7. Nõudke töövoofailidele koodiomaniku ülevaatust

Töövoofail otsustab, mis töötab teie saladustega, seega väärib selle muudatus sama ülevaatust kui muudatus tootmiskeskkonna juurdepääsus. Lisage kaust faili CODEOWNERS ja nõudke haru reeglistikus koodiomaniku ülevaatust:

/.github/workflows/ @example-org/platform-security
/.github/actions/ @example-org/platform-security

8. Piirake, millised actionid tohivad töötada

Ettevõtte, organisatsiooni või repositooriumi tasandil saab lubatud actionite poliitika piirata actionid GitHubi, kinnitatud loojate või teie hallatava loendi omadega. 2025. aasta augustist saab see nõuda ka SHA järgi kinnitamist, nii et kinnitamata actionit kasutav töövoog ebaõnnestub, ning blokeerida konkreetse actioni või versiooni !-kirjega, mis aitab päeval, mil teie kasutatavat actionit teatatakse kompromiteerituna.

Runnerid, vahemälud ja artefaktid

9. Hoidke isehallatavad runnerid avalikest repositooriumidest eemal

GitHubi turvalise kasutamise juhend ütleb, et isehallatavaid runnereid ei tohiks avalike repositooriumide jaoks peaaegu kunagi kasutada, sest igaüks saab avada pull requesti ja käitada neil koodi. Privaatsetes repositooriumides kasutage runnereid, mis alustavad iga töö jaoks puhtalt lehelt: pikaealine runner hoiab järgmise jaoks alles kõik, mis üks töö maha jättis, sealhulgas tagaukse. Shai-Huludi npm-uss registreeris nakatunud masinaid isehallatavate runneritena just sel põhjusel. Vaadake hallatud vs isehallatavad runnerid.

10. Kaitske vahemälusid mürgitamise eest

Vahemälud on harupõhised ja vaikeharul salvestatud vahemälusid saab taastada iga teine haru. Kood, mis töötab mis tahes töövoos vaikeharul, saab seega kirjutada vahemälukirjeid, mille väljalaske töövoog hiljem taastab, ilma et tal oleks vaja kirjutusõigusega tokenit. Hoidke ebausaldusväärne kood vaikeharu töövoogudest eemal, vältige vahemälude taastamist väljalaske- ja avaldamistöödes ning ehitage seal selle asemel uuesti lukufailist. Vaadake kuidas GitHub Actionsi vahemälu töötab.

11. Käsitlege artefakte ebausaldusväärsetena

actions/checkout hoiab tokeni hilisemate git-käskude jaoks kettal, kui te seda välja ei lülita. Tööruumi üleslaadimine artefaktina on seda tokenit varem lekitanud. Seadke persist-credentials: false neile väljatõmbamistele, mis ei lükka, laadige üles ainult vajalikud teed ja ärge kunagi käivitage pull requesti artefakti privilegeeritud töövoos:

- uses: actions/checkout@<full-commit-sha>
  with:
    persist-credentials: false

Võrk ja kirjed

12. Kontrollige, kuhu tööd ühendust võtta saavad

GitHubi hallatud runnerid ei piira väljuvat liiklust, nii et töös olev kood saab loetu saata ükskõik kuhu. Enamik töid vajab lühikest sihtkohtade loendit: paketiregistrid, konteineriregistrid, lähtekoodi hostid ja mõned API-d. Lubage need ja blokeerige ülejäänud ning varastatud saladusel pole kuhugi minna, isegi rünnaku puhul, mida keegi pole varem näinud. Väljuva liikluse poliitika ei peata logidesse prinditud saladusi, nagu tj-actionsi juhtumis, mistõttu kuulub see kinnitamise kõrvale, mitte selle asemele. Vaadake kuidas väljuva liikluse poliitika peatab andmelekke GitHub Actionsist.

13. Salvestage, milliseid actioneid ja pakette iga käivitus kasutas

Kui teatatakse järgmisest kompromiteeritud actionist või paketist, on esimene küsimus, millised teie käivitused seda kasutasid. Töövoofail ütleb, mida käivitus pidi kasutama. Silt, versioonivahemik või vahemälutabamus võib muuta vastuse teistsuguseks ja küsimuse lahendab kirje, mis tehti töö töötamise ajal: iga actioni commit, iga pakett, mis alla laaditi või vahemälust taastati, ja ühendused, mille töö lõi. Vaadake SBOM-id GitHub Actionsis.

Tasuta tööriistad, mis teie töövooge auditeerivad

Enamikku ülaltoodud töövoo punktidest saab kontrollida automaatselt. Need tööriistad loevad töövoofaile; need ei jälgi tööd selle töötamise ajal.

Tööriist Mida see kontrollib
zizmor GitHub Actionsi, Dependaboti ja pre-commiti seadistuse staatiline analüüs: mallisüst, ohtlikud päästikud, liigsed õigused, kinnitamata actionid, petiscommit'id, vahemälu mürgitamine ja väljatõmbamisest maha jäänud volitused
actionlint Töövoo süntaksi ja avaldiste linter, mis märgib ka tekstisiseste skriptide ebausaldusväärsed väärtused ja käitab run-sammudel shellchecki
OpenSSF Scorecard Repositooriumi kontrollid, sealhulgas Dangerous-Workflow (ebausaldusväärsed väljatõmbamised ja skriptisüst), Token-Permissions ja Pinned-Dependencies
poutine BoostSecurity avatud lähtekoodiga skanner buildikonveieritele, mis katab GitHub Actionsi, GitLabi, Azure DevOpsi ja Tektoni ning suudab skannida organisatsiooni kõiki repositooriume
CodeQL GitHubi koodiskannimine, mis on alates 2025. aastast analüüsinud töövooge süstimise ja pwn request'i mustrite suhtes

Käitage üht neist pull requestides, mis puudutavad kausta .github/. Kuidas need sobivad kokku runneri kontrollide ja turvaseisundi tööriistadega, vaadake CI/CD turvatööriistad võrdluses ja CI/CD turvalisus. Kontroll-loendi, mis katab kogu konveieri, mitte ainult GitHub Actionsi seadeid, leiate lehelt CI/CD konveieri turvalisuse kontroll-loend.

Kuidas CRACI aitab

CRACI asendab runneri, mitte GitHub Actionsit: muudate runs-on väärtuseks craci ning töövood, saladused, tokeni õigused ja käivituste ajalugu jäävad GitHubi. See katab selle loendi viimased punktid, need, mis toimuvad töö töötamise ajal:

  • Väljuva liikluse kontroll. Väljuva liikluse poliitika otsustab, milliste paketiallikate, registrite ja hostideni töö tohib jõuda. See valideeritakse enne töö algust, jõustatakse runneris ja on vaikimisi keelav (fail closed) ning blokeeritud ühendus tekitab hoiatuse.
  • Kirje igast käivitusest. Töö SBOM loetleb GitHub Actionsi actionid, mida see käitas, pkg:github komponentidena, mis on kinnitatud kasutatud commit'ile, ning iga paketi, mille see alla laadis, sealhulgas vahemälust taastatud paketid, koos selle võrguühenduste jäljega. Kui actioni silte liigutatakse, näete, millist commit'i iga käivitus tegelikult täitis.
  • Poliitikaväravad. Buildi, mis toob kaasa teadaoleva haavatavusega paketi, sealhulgas konkreetse CVE-ga, saab peatada.
  • Isolatsioon. Iga töö töötab oma virtuaalmasinas, nii et midagi ei kandu järgmisele üle.

CRACI ei auditeeri teie töövoofaile, ei skanni lähtekoodi ega otsi saladusi, seega hoidke nende jaoks alles töövoo linter, näiteks zizmor, GitHubi saladuste skannimine ja teie SAST-tööriist. See käitab GitHub Actionsi töid Linuxis ning teised CI-süsteemid on arenduskavas.

GitHub Actionsi turvalisus: korduma kippuvad küsimused

Kuidas GitHub Actionsit turvata?

Seadke GITHUB_TOKEN ainult lugemiseks ja andke kirjutusõigus töö kaupa, kinnitage või lukustage kolmanda osapoole actionid, ärge käivitage pull requesti koodi pull_request_target töövoogudes, edastage sündmuste andmed skriptidele keskkonnamuutujate kaudu, kasutage OIDC-d salvestatud pilvevõtmete asemel, pange tootmiskeskkonna saladused keskkondade taha, nõudke töövoofailide ülevaatust ja kontrollige, kuhu tööd ühendust võtta saavad.

Kas peaksin GitHub Actionsi actionid commit'i SHA järgi kinnitama?

Jah, kolmanda osapoole actionite puhul. Silti saab liigutada teisele koodile, nagu juhtus tj-actions/changed-filesiga 2025. aastal ja trivy-actioniga 2026. aastal, täispikka commit'i SHA-d aga mitte. GitHubi töövoo lukufailid lähevad kaugemale ja lukustavad ka actionid, mida teie actionid välja kutsuvad.

Kas pull_request_target on ohtlik?

See on turvaline ainult siis, kui töövoog ei käivita kunagi pull requesti koodi. See töötab baasrepositooriumi saladuste ja kirjutusõigusega tokeniga isegi forkide puhul, nii et forgi koodi ehitamine selles annab mõlemad sellele, kes pull requesti avas. Alates 2. detsembrist 2026 blokeerib GitHub selle vaikimisi avalikes repositooriumides, millel pole sündmuste poliitikat.

Mis on pwn request?

GitHub Security Labi nimetus privilegeeritud töövoole, mille käivitab tavaliselt pull_request_target ja mis tõmbab välja ning käivitab pull requesti ebausaldusväärse koodi, andes autorile juurdepääsu töövoo saladustele ja tokenile.

Kas töövoo lukufailid on paremad kui SHA järgi kinnitamine?

Need on tugevamad. Lukufail salvestab iga töövoo kasutatava actioni commit'i, sealhulgas transitiivsete oma, ja GitHub kontrollib käivitamise ajal lähterepositooriumi identiteeti. Korduvkasutatavate töövoogude väljakutsed pole kaetud, seega kinnitage need SHA järgi.

Millised tasuta tööriistad kontrollivad GitHub Actionsi töövooge turvaprobleemide suhtes?

zizmor, actionlint, OpenSSF Scorecard ja poutine on tasuta ning CodeQL saab analüüsida töövooge GitHubi koodiskannimise osana. Need loevad töövoofaile; need ei kontrolli, mida töö oma töötamise ajal teeb.

Vaadake, mida üks teie töövoogudest tegelikult käitas

Käitage GitHub Actionsi töö CRACI-s ning saage iga actioni commit, iga allalaaditud pakett ja vaikimisi keelav väljuva liikluse poliitika.

Broneerige demo