Vuonna 2026 raportoitiin päivässä 138% enemmän CVE:itä kuin edellisenä vuonna.Uutta: aina päällä olevat Fixboxit. Haavoittuvat riippuvuudet korjattuina ja varmistettuina.

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, ja workflow_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