CI/CD-sikkerhet
GitHub Actions-sikkerhet: en sjekkliste for å herde workflowene dine
En GitHub Actions-workflow kjører kode fra mange forfattere med repositoriets token, hemmelighetene dine og en vei til produksjon. De fleste kontrollene som holder den trygg, er innebygd i GitHub, men som standard er de slått av, løst satt eller lette å få feil. Denne sjekklisten går gjennom hver av dem: hva du skal stille inn, hvorfor det betyr noe, og hendelsen som viser hva som skjer uten.
Oppdatert
Sjekklisten i korte trekk
| Punkt | Hva det stopper |
|---|---|
GITHUB_TOKEN med minste privilegium |
Et kapret steg som pusher kode, publiserer utgivelser eller utløser andre workflows |
| Fest eller lås tredjeparts actions | En flyttet tagg som kjører angriperens kode i jobben din |
Behandle pull_request_target og workflow_run som privilegerte |
Pwn requests: kode fra en fork som kjører med hemmelighetene dine |
Hold hendelsesdata utenfor run-skript |
Skriptinjeksjon via titler, branchnavn og kommentarer |
| OIDC i stedet for lagrede skynøkler | Langlivet påloggingsinformasjon som virker i årevis etter en lekkasje |
| Miljøer med påkrevde godkjennere | At hvilken som helst branch eller workflow kan lese produksjonshemmeligheter |
Kodeeiere for .github/workflows |
Ugjennomgåtte endringer i hva pipelinen kjører |
| Policy for tillatte actions | Ukjente eller ufestede actions hvor som helst i organisasjonen |
| Ingen selvhostede runnere på offentlige repositorier | At fremmede kjører kode på maskinene dine |
| Hygiene for cache og artefakter | Forgiftede cacher og tokens som lekker via opplastinger |
| Egress-kontroll på runnere | At stjålne hemmeligheter sendes til angriperens server |
| En registrering av hver kjøring | Å ikke vite hvilke bygg som kjørte en kompromittert action eller pakke |
Workflow-kode
1. Gi GITHUB_TOKEN minste privilegium
Hver jobb får et GITHUB_TOKEN, og alle steg i jobben kan bruke det. Repositorier og organisasjoner som ble
opprettet før februar 2023, kan fortsatt ha lese- og skrivetilgang på alle rettigheter som standard. Sett standarden
til skrivebeskyttet under Settings → Actions → General → Workflow permissions, og gi deretter
skrivetilgang per jobb:
permissions:
contents: read
jobs:
release:
runs-on: ubuntu-latest
permissions:
contents: write
steps:
- uses: actions/checkout@<full-commit-sha>
Alt du ikke lister opp, blir none. For hver rettighet og hva vanlige oppgaver trenger, se
GITHUB_TOKEN-rettigheter: minste privilegium for hver workflow.
2. Fest tredjeparts actions til en commit, eller lås dem
En tagg som @v4 er en peker som eieren av actionen, eller hvem som helst som stjeler tilgangen deres, kan
flytte. To hendelser viser hva det betyr:
- tj-actions/changed-files, mars 2025. En angriper endret eksisterende versjonstagger til å peke på en ondsinnet commit (CVE-2025-30066). Actionen ble brukt av mer enn 23 000 repositorier, og nyttelasten skrev hemmeligheter fra runnerens minne ut i workflow-loggene, som alle kan lese i et offentlig repositorium.
- aquasecurity/trivy-action, mars 2026. Aqua Securitys sikkerhetsvarsel (CVE-2026-33634) sier at 76 av actionens 77 versjonstagger ble force-pushet til ondsinnede commits. Den injiserte koden kjørte før den ekte skanningen, leste hemmeligheter fra runnerens minne og sendte dem, kryptert, til angriperens infrastruktur.
Workflows som refererte til en fullstendig commit-SHA, fortsatte å kjøre koden de hadde fra før. Behold versjonen som en kommentar:
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
Sjekk at SHA-en kommer fra actionens eget repositorium, ikke fra en fork. GitHub tilbyr nå noe sterkere:
lockfiler
for workflow-avhengigheter, allment tilgjengelig siden 28. oktober 2026. CLI-utvidelsen gh actions-lock
skriver .github/workflows/actions.lock, som registrerer den nøyaktige commiten for hver action workflowene
dine bruker, inkludert actionene disse actionene kaller, og GitHub sjekker ved kjøring at hvert kilderepositorium
fortsatt er det du låste. Kall til gjenbrukbare workflows dekkes ikke, så fest dem med SHA. Administratorer kan kreve
en lockfile via policy. Verken festing eller en lockfile gjør en action trygg: Gå gjennom det du låser.
Festede actions oppdaterer seg ikke selv. La Dependabot foreslå oppdateringer, med en ventetid slik at en ny utgivelse har noen dager på seg til å bli avslørt før den når deg:
# .github/dependabot.yml
version: 2
updates:
- package-ecosystem: "github-actions"
directory: "/"
schedule:
interval: "weekly"
cooldown:
default-days: 7
3. Behandle pull_request_target og workflow_run som privilegerte
En pull_request-workflow fra en fork får et skrivebeskyttet token og ingen hemmeligheter. En
pull_request_target-workflow kjører i konteksten til basisrepositoriet, med dets hemmeligheter og et token
som kan skrive, selv når pull requesten kommer fra en fork. Det er bare trygt så lenge workflowen aldri kjører kode fra
pull requesten. Sjekker du ut pull requestens head og bygger den, kjører hvert installasjonsskript og hver test i den
pull requesten med hemmelighetene dine. GitHub Security Lab kaller disse
pwn
requests.
- Bruk
pull_requesttil alt som bygger eller tester bidratt kode. -
Hvis et privilegert steg må følge, for eksempel en kommentar på pull requesten, del det opp: En uprivilegert
pull_request-workflow laster opp resultatene som en artefakt, og enworkflow_run-workflow handler på dem. Behandle disse artefaktene som upålitelige inndata, aldri som kode som skal kjøres. -
I offentlige repositorier uten en hendelsespolicy
blokkerer
GitHub
pull_request_targetsom standard fra 2. desember 2026. Tillater du det igjen, tillat bare workflowene som trenger det.
TanStack-kompromitteringen i mai 2026 startet slik: En pull_request_target-workflow kjørte kode fra en
fork, som forgiftet cachen en utgivelsesworkflow senere gjenopprettet, og et OIDC-token lest fra runnerens minne ble
brukt til å publisere
84 ondsinnede versjoner av 42
pakker.
4. Hold hendelsesdata utenfor run-skript
Uttrykk ekspanderes før skallet kjører, så en pull request-tittel, et branchnavn, en issue-tekst eller en
commit-melding inne i run blir en del av skriptet. Alle som kan åpne en pull request eller et issue, kan
da kjøre kommandoer i jobben din. Send verdien gjennom en miljøvariabel, så skallet behandler den som 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"
Det samme gjelder actions/github-script og verdier som skrives til GITHUB_ENV. AI-agenter i
workflows gir en ny form for det samme problemet: Tekst i et issue kan styre agenten i stedet for skallet. Se
prompt injection.
Hemmeligheter og utrullinger
5. Bruk OIDC i stedet for langlivede skynøkler
En tilgangsnøkkel til skyen som er lagret som en hemmelighet, virker til noen roterer den, og etter en lekkasje er det ofte for sent. Med OpenID Connect ber jobben GitHub om et kortlivet token og bytter det hos AWS, Azure eller Google Cloud, der en tillitspolicy avgjør hvilket repositorium, hvilken branch eller hvilket miljø som kan anta rollen:
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
Et kortlivet token kan fortsatt stjeles fra en jobb som kjører, slik TanStack viste, men det er verdt langt mindre enn en nøkkel som aldri utløper. Gi hemmelighetene du beholder, til steget som trenger dem i stedet for til hele jobben, så andre actions i jobben ikke kan lese dem. Hvordan hemmeligheter lekker og resten av kontrollene finner du i GitHub Actions-hemmeligheter: hvordan de lekker og hvordan du låser dem ned.
6. Sett produksjon bak miljøer med påkrevde godkjennere
Et miljø har sine egne hemmeligheter, og en jobb som refererer til det, kan ikke lese dem før en påkrevd godkjenner har godkjent kjøringen. Regler for utrullingsbrancher begrenser hvilke brancher som i det hele tatt kan bruke det. En workflow på en feature-branch, eller en som utløses av en pull request, har da ingen vei til påloggingsinformasjonen for produksjon.
Styring
7. Krev gjennomgang fra kodeeier for workflow-filer
En workflow-fil bestemmer hva som kjører med hemmelighetene dine, så en endring i den fortjener samme gjennomgang som en
endring i produksjonstilgang. Legg mappen til i CODEOWNERS, og krev gjennomgang fra kodeeier i et
branch-regelsett:
/.github/workflows/ @example-org/platform-security
/.github/actions/ @example-org/platform-security
8. Begrens hvilke actions som kan kjøre
På enterprise-, organisasjons- eller repositorienivå kan policyen for tillatte actions begrense actions til dem fra
GitHub, verifiserte skapere eller en liste du vedlikeholder. Siden
august
2025 kan den også kreve SHA-festing, så en workflow som bruker en ufestet action, feiler, og blokkere en bestemt
action eller versjon med en !-oppføring, noe som hjelper den dagen en action du bruker, meldes som
kompromittert.
Runnere, cacher og artefakter
9. Hold selvhostede runnere unna offentlige repositorier
GitHubs referanse for sikker bruk sier at selvhostede runnere nesten aldri bør brukes til offentlige repositorier, fordi hvem som helst kan åpne en pull request og kjøre kode på dem. På private repositorier bør du bruke runnere som starter på nytt for hver jobb: En langlivet runner beholder det én jobb etterlater seg til den neste, inkludert en bakdør. npm-ormen Shai-Hulud registrerte infiserte maskiner som selvhostede runnere av nettopp den grunnen. Se administrerte vs. selvhostede runnere.
10. Beskytt cacher mot forgiftning
Cacher er avgrenset per branch, og cacher lagret på standardbranchen kan gjenopprettes av alle andre brancher. Kode som kjører i en hvilken som helst workflow på standardbranchen, kan derfor skrive cache-oppføringer som en utgivelsesworkflow gjenoppretter senere, uten å trenge et token med skrivetilgang. Hold upålitelig kode utenfor workflows på standardbranchen, unngå å gjenopprette cacher i utgivelses- og publiseringsjobber, og bygg heller på nytt fra en lockfile der. Se hvordan GitHub Actions-cachen fungerer.
11. Behandle artefakter som upålitelige
actions/checkout beholder tokenet på disk for senere git-kommandoer med mindre du slår det av. Å laste
opp arbeidsområdet som en artefakt har lekket det tokenet tidligere. Sett persist-credentials: false på
checkouter som ikke pusher, last bare opp stiene du trenger, og kjør aldri en artefakt fra en pull request i en
privilegert workflow:
- uses: actions/checkout@<full-commit-sha>
with:
persist-credentials: false
Nettverk og registreringer
12. Kontroller hvor jobber kan koble seg til
GitHub-hostede runnere begrenser ikke utgående trafikk, så kode i en jobb kan sende det den leser, hvor som helst. De fleste jobber trenger en kort liste over destinasjoner: pakkeregistre, containerregistre, kildeverter og noen få API-er. Tillat disse og blokker resten, så har en stjålet hemmelighet ingen steder å gå, selv i et angrep ingen har sett før. En egress-policy stopper ikke hemmeligheter som skrives ut i logger, som i tj-actions-tilfellet, og derfor hører den hjemme ved siden av festing, ikke i stedet for. Se hvordan en egress-policy stopper eksfiltrering fra GitHub Actions.
13. Registrer hvilke actions og pakker hver kjøring brukte
Når den neste kompromitterte actionen eller pakken blir kjent, er det første spørsmålet hvilke av kjøringene dine som brukte den. En workflow-fil sier hva en kjøring var ment å bruke. En tagg, et versjonsintervall eller et cache-treff kan gjøre svaret annerledes, og registreringen som avgjør det, er den som tas mens jobben kjørte: commiten til hver action, hver pakke som ble hentet eller gjenopprettet fra en cache, og tilkoblingene jobben gjorde. Se SBOM-er i GitHub Actions.
Gratis verktøy som reviderer workflowene dine
De fleste workflow-punktene ovenfor kan sjekkes automatisk. Disse verktøyene leser workflow-filer; de overvåker ikke en jobb mens den kjører.
| Verktøy | Hva det sjekker |
|---|---|
| zizmor | Statisk analyse av konfigurasjon for GitHub Actions, Dependabot og pre-commit: malinjeksjon, farlige utløsere, for vide rettigheter, ufestede actions, falske commits, cacheforgiftning og påloggingsinformasjon etterlatt av checkout |
| actionlint |
En linter for workflow-syntaks og uttrykk som også flagger upålitelige verdier brukt i innebygde skript og kjører
shellcheck på run-steg
|
| OpenSSF Scorecard | Repositoriesjekker, blant dem Dangerous-Workflow (upålitelige checkouter og skriptinjeksjon), Token-Permissions og Pinned-Dependencies |
| poutine | BoostSecuritys skanner med åpen kildekode for byggepipelines, som dekker GitHub Actions, GitLab, Azure DevOps og Tekton, og kan skanne alle repositorier i en organisasjon |
| CodeQL | GitHubs kodeskanning, som har analysert workflows for injeksjon og pwn request-mønstre siden 2025 |
Kjør ett av dem i pull requests som berører .github/. For hvordan disse passer sammen med runnerkontroller
og posture-verktøy, se CI/CD-sikkerhetsverktøy sammenlignet og
CI/CD-sikkerhet. For en sjekkliste som dekker hele pipelinen i stedet for innstillinger i
GitHub Actions, se sjekklisten for sikkerhet i CI/CD-pipelinen.
Slik hjelper CRACI
CRACI erstatter runneren, ikke GitHub Actions: Du endrer runs-on til craci, og workflowene,
hemmelighetene, tokenrettighetene og kjøringshistorikken blir værende i GitHub. CRACI dekker de siste punktene på denne
listen, dem som skjer mens en jobb kjører:
- Egress-kontroll. En egress-policy avgjør hvilke pakkekilder, registre og verter en jobb kan nå. Den valideres før jobben starter, håndheves i runneren og blokkerer ved feil, og en blokkert tilkobling utløser et varsel.
-
En registrering av hver kjøring. Jobbens SBOM lister GitHub Actions den kjørte, som
pkg:github-komponenter festet til commiten som ble brukt, og hver pakke den hentet, inkludert pakker gjenopprettet fra en cache, med et spor av nettverkstilkoblingene. Når taggene til en action flyttes, kan du se hvilken commit hver kjøring faktisk utførte. - Policy gates. Et bygg som trekker inn en pakke med en kjent sårbarhet, inkludert en bestemt CVE, kan stoppes.
- Isolasjon. Hver jobb kjører i sin egen virtuelle maskin, så ingenting overføres til den neste.
CRACI reviderer ikke workflow-filene dine, skanner ikke kildekode og skanner ikke etter hemmeligheter, så behold en workflow-linter som zizmor, GitHubs secret scanning og SAST-verktøyet ditt til det. CRACI kjører GitHub Actions-jobber på Linux, og andre CI-systemer står på veikartet.
GitHub Actions-sikkerhet: ofte stilte spørsmål
Hvordan sikrer jeg GitHub Actions?
Sett GITHUB_TOKEN til skrivebeskyttet og gi skrivetilgang per jobb, fest eller lås tredjeparts actions, unngå å kjøre kode fra pull requests i pull_request_target-workflows, send hendelsesdata til skript via miljøvariabler, bruk OIDC i stedet for lagrede skynøkler, sett produksjonshemmeligheter bak miljøer, krev gjennomgang av workflow-filer og kontroller hva jobber kan koble seg til.
Bør jeg feste GitHub Actions til en commit-SHA?
Ja, for tredjeparts actions. En tagg kan flyttes til annen kode, slik det skjedde med tj-actions/changed-files i 2025 og trivy-action i 2026, mens en fullstendig commit-SHA ikke kan det. GitHubs workflow-lockfiler går lenger og låser også actionene som actionene dine kaller.
Er pull_request_target farlig?
Den er bare trygg hvis workflowen aldri kjører kode fra pull requesten. Den kjører med basisrepositoriets hemmeligheter og et token med skrivetilgang selv for forks, så å bygge kode fra en fork i den gir begge deler til den som åpnet pull requesten. GitHub blokkerer den som standard i offentlige repositorier uten hendelsespolicy fra 2. desember 2026.
Hva er en pwn request?
GitHub Security Labs navn på en privilegert workflow, som regel utløst av pull_request_target, som sjekker ut og kjører upålitelig kode fra en pull request og gir forfatteren tilgang til workflowens hemmeligheter og token.
Er workflow-lockfiler bedre enn SHA-festing?
De er sterkere. En lockfile registrerer commiten til hver action en workflow bruker, også transitive, og GitHub sjekker identiteten til kilderepositoriet ved kjøring. Kall til gjenbrukbare workflows dekkes ikke, så fest dem med SHA.
Hvilke gratis verktøy sjekker GitHub Actions-workflows for sikkerhetsproblemer?
zizmor, actionlint, OpenSSF Scorecard og poutine er gratis, og CodeQL kan analysere workflows som en del av GitHubs kodeskanning. De leser workflow-filer; de kontrollerer ikke hva en jobb gjør mens den kjører.
Se hva en av workflowene dine faktisk kjørte
Kjør en GitHub Actions-jobb på CRACI og få commiten til hver action, hver pakke som ble hentet, og en egress-policy som blokkerer ved feil.
Book en demo