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_requesttöövoog laadib oma tulemused üles artefaktina jaworkflow_runtöö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:githubkomponentidena, 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