CI/CD-tietoturva
GitHub Actions -tietoturva: tarkistuslista työnkulkujesi koventamiseen
GitHub Actions -työnkulku ajaa monen tekijän koodia repositoriosi tokenilla, salaisuuksillasi ja reitillä tuotantoon. Useimmat sen suojaamiseen tarvittavat kontrollit on rakennettu GitHubiin, mutta oletuksena ne ovat pois päältä, löysiä tai helppo määrittää väärin. Tämä tarkistuslista käy läpi jokaisen: mitä asettaa, miksi sillä on väliä ja mikä tapaus näyttää, mitä ilman sitä tapahtuu.
Päivitetty
Tarkistuslista yhdellä silmäyksellä
| Kohta | Mitä se estää |
|---|---|
Vähimmät oikeudet GITHUB_TOKENille |
Kaapattu askel puskee koodia, julkaisee versioita tai käynnistää muita työnkulkuja |
| Kolmannen osapuolen actionien kiinnitys tai lukitus | Siirretty tagi ajaa hyökkääjän koodia jobissasi |
pull_request_target ja workflow_run etuoikeutettuina |
Pwn requestit: forkin koodi ajetaan salaisuuksiesi kanssa |
Tapahtumadata pois run-skripteistä |
Skripti-injektio otsikoiden, haarojen nimien ja kommenttien kautta |
| OIDC tallennettujen pilviavainten sijaan | Pitkäikäiset tunnistetiedot, jotka toimivat vuosia vuotamisen jälkeen |
| Ympäristöt pakollisine hyväksyjineen | Mikä tahansa haara tai työnkulku lukee tuotannon salaisuuksia |
Koodin omistajat kohteelle .github/workflows |
Katselmoimattomat muutokset siihen, mitä putki ajaa |
| Sallittujen actionien käytäntö | Tuntemattomat tai kiinnittämättömät actionit missä tahansa organisaatiossa |
| Ei itse ylläpidettyjä runnereita julkisissa repositorioissa | Vieraat ajavat koodia koneillasi |
| Välimuistien ja artefaktien hygienia | Myrkytetyt välimuistit ja lataustesi mukana vuotavat tokenit |
| Lähtevän liikenteen hallinta runnereilla | Varastettujen salaisuuksien lähettäminen hyökkääjän palvelimelle |
| Tallenne jokaisesta ajosta | Et tiedä, mitkä buildit ajoivat murretun actionin tai paketin |
Työnkulkujen koodi
1. Anna GITHUB_TOKENille vähimmät oikeudet
Jokainen jobi saa GITHUB_TOKENin, ja mikä tahansa jobin askel voi käyttää sitä. Ennen helmikuuta 2023 luodut
repositoriot ja organisaatiot voivat yhä antaa oletuksena luku- ja kirjoitusoikeuden jokaiseen oikeuteen. Aseta oletukseksi pelkkä luku kohdassa
Settings → Actions → General → Workflow permissions ja myönnä kirjoitusoikeus jobikohtaisesti:
permissions:
contents: read
jobs:
release:
runs-on: ubuntu-latest
permissions:
contents: write
steps:
- uses: actions/checkout@<full-commit-sha>
Kaikki, mitä et luettele, saa arvon none. Jokaisen oikeuden ja yleisten tehtävien tarpeet löydät artikkelista
GITHUB_TOKENin oikeudet: vähimmät oikeudet jokaiselle työnkululle.
2. Kiinnitä kolmannen osapuolen actionit commitiin tai lukitse ne
Tagi, kuten @v4, on osoitin, jota actionin omistaja tai kuka tahansa hänen pääsynsä varastava voi siirtää. Kaksi
tapausta näyttää, mitä se tarkoittaa:
- tj-actions/changed-files, maaliskuu 2025. Hyökkääjä muutti olemassa olevat versiotagit osoittamaan haitalliseen commitiin (CVE-2025-30066). Actionia käytti yli 23 000 repositoriota, ja hyötykuorma tulosti salaisuuksia runnerin muistista työnkulun lokeihin, joita kuka tahansa voi lukea julkisessa repositoriossa.
- aquasecurity/trivy-action, maaliskuu 2026. Aqua Securityn tietoturvatiedotteen (CVE-2026-33634) mukaan actionin 77 versiotagista 76 pakotettiin osoittamaan haitallisiin commiteihin. Upotettu koodi ajettiin ennen varsinaista skannausta, luki salaisuuksia runnerin muistista ja lähetti ne salattuina hyökkääjän infrastruktuuriin.
Työnkulut, jotka viittasivat täyteen commit-SHA:han, jatkoivat saman koodin ajamista kuin ennenkin. Pidä versio kommenttina:
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
Tarkista, että SHA tulee actionin omasta repositoriosta eikä forkista. GitHub tarjoaa nyt jotain vahvempaa:
työnkulkujen
riippuvuuksien lukitustiedostot, yleisesti saatavilla 28.10.2026 alkaen. gh actions-lock-CLI-laajennus
kirjoittaa tiedoston .github/workflows/actions.lock, joka tallentaa tarkan commitin jokaiselle työnkulkujesi käyttämälle actionille,
myös niiden actionien kutsumille actioneille, ja GitHub tarkistaa ajon aikana, että jokainen lähderepositorio on yhä se, jonka
lukitsit. Uudelleenkäytettävien työnkulkujen kutsut eivät kuulu tämän piiriin, joten kiinnitä ne SHA:lla. Ylläpitäjät voivat vaatia lukitustiedoston
käytännöllä. Kiinnitys tai lukitustiedosto ei tee actionista turvallista: katselmoi se, minkä lukitset.
Kiinnitetyt actionit eivät päivity itsestään. Anna Dependabotin ehdottaa päivityksiä odotusajalla, jotta uusi julkaisu ehditään havaita muutamassa päivässä ennen kuin se päätyy sinulle:
# .github/dependabot.yml
version: 2
updates:
- package-ecosystem: "github-actions"
directory: "/"
schedule:
interval: "weekly"
cooldown:
default-days: 7
3. Käsittele pull_request_target- ja workflow_run-työnkulkuja etuoikeutettuina
Forkista tuleva pull_request-työnkulku saa vain lukuoikeudellisen tokenin eikä salaisuuksia.
pull_request_target-työnkulku ajetaan perusrepositorion kontekstissa, sen salaisuuksien ja kirjoittamaan pystyvän
tokenin kanssa, vaikka pull request tulisi forkista. Se on turvallista vain niin kauan kuin työnkulku ei koskaan aja pull requestin
koodia. Checkouttaa pull requestin head ja buildaa se, niin jokainen pull requestin asennusskripti ja testi
ajetaan salaisuuksiesi kanssa. GitHub Security Lab kutsuu näitä nimellä
pwn
requests.
- Käytä
pull_request-tapahtumaa kaikkeen, mikä buildaa tai testaa ulkopuolisten tuomaa koodia. -
Jos perään tarvitaan etuoikeutettu askel, kuten kommentointi pull requestiin, jaa se kahtia: etuoikeudeton
pull_request-työnkulku lataa tuloksensa artefaktina, jaworkflow_run-työnkulku toimii niiden perusteella. Käsittele näitä artefakteja epäluotettavana syötteenä, ei koskaan ajettavana koodina. -
Julkisissa repositorioissa, joilla ei ole tapahtumakäytäntöä, GitHub
estää
pull_request_target-tapahtuman oletuksena 2.12.2026 alkaen. Jos sallit sen uudelleen, salli se vain niille työnkuluille, jotka sitä tarvitsevat.
TanStackin murto toukokuussa 2026 alkoi juuri näin: pull_request_target-työnkulku ajoi forkin koodia, joka
myrkytti välimuistin, jonka julkaisutyönkulku myöhemmin palautti, ja runnerin muistista luettua OIDC-tokenia käytettiin
84 haitallisen version julkaisemiseen 42
paketista.
4. Pidä tapahtumadata poissa run-skripteistä
Lausekkeet laajennetaan ennen kuin shell ajetaan, joten pull requestin otsikko, haaran nimi, issuen sisältö tai commit-viesti
run-kohdassa muuttuu osaksi skriptiä. Kuka tahansa, joka voi avata pull requestin tai issuen, voi silloin ajaa
komentoja jobissasi. Välitä arvo ympäristömuuttujan kautta, jolloin shell käsittelee sitä datana:
# 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 pätee actions/github-script-actioniin ja arvoihin, jotka kirjoitetaan GITHUB_ENV-tiedostoon. Tekoälyagentit
työnkuluissa tuovat saman ongelman uuteen muotoon: issuen teksti voi ohjata agenttia shellin sijaan. Katso
prompt injection.
Salaisuudet ja käyttöönotot
5. Käytä OIDC:tä pitkäikäisten pilviavainten sijaan
Salaisuutena tallennettu pilvipalvelun pääsyavain toimii, kunnes joku vaihtaa sen, mikä vuodon jälkeen on usein liian myöhään. OpenID Connectin avulla jobi pyytää GitHubilta lyhytikäisen tokenin ja vaihtaa sen AWS:n, Azuren tai Google Cloudin kanssa, jonka luottamuskäytäntö päättää, mikä repositorio, haara tai ympäristö voi ottaa roolin käyttöön:
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
Lyhytikäisenkin tokenin voi yhä varastaa käynnissä olevasta jobista, kuten TanStack osoitti, mutta se on paljon vähemmän arvokas kuin avain, joka ei koskaan vanhene. Välitä ne salaisuudet, jotka pidät, vain niitä tarvitsevalle askeleelle eikä koko jobille, jotta jobin muut actionit eivät voi lukea niitä. Miten salaisuudet vuotavat ja muut kontrollit kerrotaan artikkelissa GitHub Actions -salaisuudet: miten ne vuotavat ja miten ne lukitaan.
6. Sijoita tuotanto ympäristöjen taakse pakollisine hyväksyjineen
Ympäristöllä on omat salaisuutensa, eikä sen nimeävä jobi voi lukea niitä ennen kuin pakollinen hyväksyjä hyväksyy ajon. Käyttöönottohaarojen säännöt rajaavat, mitkä haarat voivat ylipäätään käyttää sitä. Ominaisuushaaran työnkululla tai pull requestin käynnistämällä työnkululla ei silloin ole reittiä tuotannon tunnistetietoihin.
Hallinta
7. Vaadi koodin omistajan katselmointi työnkulkutiedostoille
Työnkulkutiedosto päättää, mitä salaisuuksiesi kanssa ajetaan, joten sen muutos ansaitsee saman katselmoinnin kuin muutos
tuotannon käyttöoikeuksiin. Lisää kansio tiedostoon CODEOWNERS ja vaadi koodin omistajan katselmointi haaran ruleset-säännöissä:
/.github/workflows/ @example-org/platform-security
/.github/actions/ @example-org/platform-security
8. Rajoita, mitä actioneita voidaan ajaa
Yritys-, organisaatio- tai repositoriotasolla sallittujen actionien käytäntö voi rajata actionit GitHubin,
vahvistettujen tekijöiden tai ylläpitämäsi listan actioneihin. Elokuusta
2025 lähtien se voi myös vaatia SHA-kiinnityksen, jolloin kiinnittämätöntä actionia käyttävä työnkulku epäonnistuu, ja estää tietyn actionin
tai version !-merkinnällä, mikä auttaa sinä päivänä, kun käyttämäsi action raportoidaan murretuksi.
Runnerit, välimuistit ja artefaktit
9. Pidä itse ylläpidetyt runnerit poissa julkisista repositorioista
GitHubin turvallisen käytön ohjeen mukaan itse ylläpidettyjä runnereita ei pitäisi juuri koskaan käyttää julkisissa repositorioissa, koska kuka tahansa voi avata pull requestin ja ajaa niillä koodia. Käytä yksityisissä repositorioissa runnereita, jotka käynnistyvät puhtaina jokaiselle jobille: pitkäikäinen runneri säilyttää seuraavalle kaiken, minkä yksi jobi jättää jälkeensä, myös takaoven. Shai-Hulud-npm-mato rekisteröi saastuneita koneita itse ylläpidetyiksi runnereiksi juuri tästä syystä. Katso hallinnoidut vs. itse ylläpidetyt runnerit.
10. Suojaa välimuistit myrkytykseltä
Välimuistit on rajattu haaroittain, ja oletushaaralla tallennetut välimuistit voi palauttaa mikä tahansa muu haara. Koodi, joka ajetaan missä tahansa oletushaaran työnkulussa, voi siksi kirjoittaa välimuistimerkintöjä, jotka julkaisutyönkulku myöhemmin palauttaa, ilman kirjoitustokenia. Pidä epäluotettava koodi poissa oletushaaran työnkuluista, vältä välimuistien palauttamista julkaisu- ja julkaisemisjobeissa ja buildaa niissä sen sijaan lukitustiedostosta. Katso miten GitHub Actionsin välimuisti toimii.
11. Käsittele artefakteja epäluotettavina
actions/checkout säilyttää tokenin levyllä myöhempiä git-komentoja varten, ellei sitä kytketä pois. Työtilan
lataaminen artefaktina on aiemmin vuotanut tuon tokenin. Aseta persist-credentials: false checkouteille,
jotka eivät puske, lataa vain tarvitsemasi polut äläkä koskaan aja pull requestin artefaktia etuoikeutetussa
työnkulussa:
- uses: actions/checkout@<full-commit-sha>
with:
persist-credentials: false
Verkko ja tallenteet
12. Hallitse, mihin jobit voivat ottaa yhteyttä
GitHubin ylläpitämät runnerit eivät rajoita lähtevää liikennettä, joten jobin koodi voi lähettää lukemansa minne tahansa. Useimmat jobit tarvitsevat lyhyen listan kohteita: pakettirekisterit, konttirekisterit, lähdekoodipalvelimet ja muutaman API:n. Salli ne ja estä loput, niin varastetulla salaisuudella ei ole minne mennä, ei edes hyökkäyksessä, jota kukaan ei ole ennen nähnyt. Egress-käytäntö ei estä lokeihin tulostettuja salaisuuksia, kuten tj-actions-tapauksessa, ja siksi se kuuluu kiinnityksen rinnalle eikä sen tilalle. Katso miten egress-käytäntö estää tietojen vuotamisen GitHub Actionsista.
13. Tallenna, mitä actioneita ja paketteja kukin ajo käytti
Kun seuraava murrettu action tai paketti julkistetaan, ensimmäinen kysymys on, mitkä ajoistasi käyttivät sitä. Työnkulkutiedosto kertoo, mitä ajon oli tarkoitus käyttää. Tagi, versioalue tai välimuistiosuma voi muuttaa vastauksen, ja sen ratkaiseva tallenne on se, joka otettiin jobin ollessa käynnissä: jokaisen actionin commit, jokainen haettu tai välimuistista palautettu paketti ja jobin muodostamat yhteydet. Katso SBOM:t GitHub Actionsissa.
Ilmaiset työkalut työnkulkujesi auditointiin
Useimmat yllä olevista työnkulkukohdista voi tarkistaa automaattisesti. Nämä työkalut lukevat työnkulkutiedostoja; ne eivät seuraa jobia sen ollessa käynnissä.
| Työkalu | Mitä se tarkistaa |
|---|---|
| zizmor | Staattinen analyysi GitHub Actionsin, Dependabotin ja pre-commitin määrityksille: template-injektio, vaaralliset käynnistimet, liialliset oikeudet, kiinnittämättömät actionit, impostor-commitit, välimuistin myrkytys ja checkoutin jättämät tunnistetiedot |
| actionlint |
Työnkulkujen syntaksin ja lausekkeiden linter, joka merkitsee myös inline-skripteissä käytetyt epäluotettavat arvot ja ajaa
shellcheckin run-askelille
|
| OpenSSF Scorecard | Repositoriotarkistukset, kuten Dangerous-Workflow (epäluotettavat checkoutit ja skripti-injektio), Token-Permissions ja Pinned-Dependencies |
| poutine | BoostSecurityn avoimen lähdekoodin skanneri build-putkille, joka kattaa GitHub Actionsin, GitLabin, Azure DevOpsin ja Tektonin ja voi skannata organisaation jokaisen repositorion |
| CodeQL | GitHubin koodiskannaus, joka on analysoinut työnkulkuja injektio- ja pwn request -kuvioiden varalta vuodesta 2025 |
Aja jotakin niistä pull requesteissa, jotka koskevat kansiota .github/. Miten nämä sopivat yhteen runnerikontrollien ja
posture-työkalujen kanssa, katso CI/CD-tietoturvatyökalujen vertailu ja
CI/CD-tietoturva. Tarkistuslista, joka kattaa koko putken eikä vain GitHub Actionsin
asetuksia, on CI/CD-putken tietoturvan tarkistuslista.
Miten CRACI auttaa
CRACI korvaa runnerin, ei GitHub Actionsia: vaihdat runs-on-arvoksi craci, ja
työnkulut, salaisuudet, tokenien oikeudet ja ajohistoria pysyvät GitHubissa. Se kattaa tämän listan viimeiset kohdat, ne,
jotka tapahtuvat jobin ollessa käynnissä:
- Lähtevän liikenteen hallinta. Egress-käytäntö päättää, mihin pakettilähteisiin, rekistereihin ja palvelimiin jobi saa yhteyden. Se validoidaan ennen jobin alkua, sitä valvotaan runnerilla ja se toimii fail closed -periaatteella, ja estetty yhteys nostaa hälytyksen.
-
Tallenne jokaisesta ajosta. Jobin SBOM luettelee sen ajamat GitHub Actionsit
pkg:github-komponentteina, jotka on kiinnitetty käytettyyn commitiin, sekä jokaisen sen hakeman paketin, välimuistista palautetut paketit mukaan lukien, ja jäljen sen verkkoyhteyksistä. Kun actionin tageja siirretään, näet, minkä commitin kukin ajo todella suoritti. - Käytäntöportit. Buildi, joka tuo mukanaan paketin, jossa on tunnettu haavoittuvuus, tietty CVE mukaan lukien, voidaan pysäyttää.
- Eristys. Jokainen jobi ajetaan omassa virtuaalikoneessaan, joten mitään ei siirry seuraavaan.
CRACI ei auditoi työnkulkutiedostojasi, skannaa lähdekoodia eikä etsi salaisuuksia, joten pidä niitä varten työnkulkujen linter, kuten zizmor, GitHubin secret scanning ja SAST-työkalusi. Se ajaa GitHub Actions -jobeja Linuxilla, ja muut CI-järjestelmät ovat tiekartalla.
GitHub Actions -tietoturva: usein kysytyt kysymykset
Miten GitHub Actions suojataan?
Aseta GITHUB_TOKEN pelkälle lukuoikeudelle ja myönnä kirjoitusoikeus jobikohtaisesti, kiinnitä tai lukitse kolmannen osapuolen actionit, älä aja pull requestin koodia pull_request_target-työnkuluissa, välitä tapahtumadata skripteille ympäristömuuttujien kautta, käytä OIDC:tä tallennettujen pilviavainten sijaan, sijoita tuotannon salaisuudet ympäristöjen taakse, vaadi työnkulkutiedostojen katselmointi ja hallitse, mihin jobit voivat ottaa yhteyttä.
Pitäisikö GitHub Actions kiinnittää commit-SHA:han?
Kyllä, kolmannen osapuolen actionit. Tagin voi siirtää osoittamaan muuhun koodiin, kuten tj-actions/changed-filesille kävi vuonna 2025 ja trivy-actionille vuonna 2026, mutta täyttä commit-SHA:ta ei. GitHubin työnkulkujen lukitustiedostot menevät pidemmälle ja lukitsevat myös actioniesi kutsumat actionit.
Onko pull_request_target vaarallinen?
Se on turvallinen vain, jos työnkulku ei koskaan aja pull requestin koodia. Se ajetaan perusrepositorion salaisuuksien ja kirjoitustokenin kanssa myös forkeille, joten forkin koodin buildaaminen siinä antaa molemmat pull requestin avaajalle. GitHub estää sen oletuksena julkisissa repositorioissa, joilla ei ole tapahtumakäytäntöä, 2.12.2026 alkaen.
Mikä on pwn request?
GitHub Security Labin nimitys etuoikeutetulle työnkululle, jonka yleensä käynnistää pull_request_target ja joka checkouttaa ja ajaa pull requestin epäluotettavaa koodia, jolloin tekijä pääsee käsiksi työnkulun salaisuuksiin ja tokeniin.
Ovatko työnkulkujen lukitustiedostot parempia kuin SHA-kiinnitys?
Ne ovat vahvempia. Lukitustiedosto tallentaa jokaisen työnkulun käyttämän actionin commitin, transitiiviset mukaan lukien, ja GitHub tarkistaa lähderepositorion identiteetin ajon aikana. Uudelleenkäytettävien työnkulkujen kutsut eivät kuulu sen piiriin, joten kiinnitä ne SHA:lla.
Mitkä ilmaiset työkalut tarkistavat GitHub Actions -työnkulkujen tietoturvaongelmat?
zizmor, actionlint, OpenSSF Scorecard ja poutine ovat ilmaisia, ja CodeQL voi analysoida työnkulkuja osana GitHubin koodiskannausta. Ne lukevat työnkulkutiedostoja; ne eivät hallitse, mitä jobi tekee ollessaan käynnissä.
Katso, mitä yksi työnkuluistasi todella ajoi
Aja GitHub Actions -jobi CRACI:lla ja saat jokaisen actionin commitin, jokaisen haetun paketin ja fail closed -periaatteella toimivan egress-käytännön.
Varaa demo