CI/CD-sikkerhed
GitHub Actions-sikkerhed: en tjekliste til hærdning af dine workflows
Et GitHub Actions-workflow kører kode fra mange forfattere med dit repositorys token, dine secrets og en vej til produktion. De fleste af de kontroller, der holder det sikkert, er indbygget i GitHub, men som standard er de slået fra, for løse eller lette at sætte forkert op. Denne tjekliste gennemgår hver enkelt: hvad du skal indstille, hvorfor det betyder noget, og den hændelse, der viser, hvad der sker uden.
Opdateret
Tjeklisten i overblik
| Punkt | Hvad det stopper |
|---|---|
GITHUB_TOKEN med mindste privilegium |
Et kapret trin, der pusher kode, offentliggør releases eller udløser andre workflows |
| Fastlås eller lås tredjeparts-actions | Et flyttet tag, der kører en angribers kode i dit job |
Behandl pull_request_target og workflow_run som privilegerede |
Pwn requests: kode fra forks, der kører med dine secrets |
Hold hændelsesdata ude af run-scripts |
Script injection via titler, branchnavne og kommentarer |
| OIDC i stedet for gemte cloud-nøgler | Langlivede legitimationsoplysninger, der virker i årevis, efter de er lækket |
| Environments med påkrævede reviewere | At enhver branch eller ethvert workflow kan læse produktions-secrets |
Code owners på .github/workflows |
Ugennemgåede ændringer i det, pipelinen kører |
| Politik for tilladte actions | Ukendte eller ikke-fastlåste actions overalt i organisationen |
| Ingen self-hosted runnere på offentlige repositories | Fremmede, der kører kode på dine maskiner |
| Hygiejne for caches og artefakter | Forgiftede caches og tokens, der lækker via uploads |
| Egress-kontrol på runnere | Stjålne secrets, der sendes til en angribers server |
| En registrering af hver kørsel | Ikke at vide, hvilke builds der kørte en kompromitteret action eller pakke |
Workflow-kode
1. Giv GITHUB_TOKEN mindste privilegium
Hvert job får et GITHUB_TOKEN, og ethvert trin i jobbet kan bruge det. Repositories og organisationer
oprettet før februar 2023 kan stadig som standard have læse- og skriveadgang på alle rettigheder. Sæt standarden til
skrivebeskyttet under Settings → Actions → General → Workflow permissions, og giv derefter
skriveadgang pr. job:
permissions:
contents: read
jobs:
release:
runs-on: ubuntu-latest
permissions:
contents: write
steps:
- uses: actions/checkout@<full-commit-sha>
Alt, du ikke angiver, bliver none. For hver rettighed, og hvad almindelige opgaver kræver, se
GITHUB_TOKEN-rettigheder: mindste privilegium for hvert workflow.
2. Fastlås tredjeparts-actions på et commit, eller lås dem
Et tag som @v4 er en pegepind, som actionens ejer, eller enhver, der stjæler deres adgang, kan flytte. To
hændelser viser, hvad det betyder:
- tj-actions/changed-files, marts 2025. En angriber ændrede eksisterende versionstags, så de pegede på et ondsindet commit (CVE-2025-30066). Actionen blev brugt af mere end 23.000 repositories, og nyttelasten skrev secrets fra runnerens hukommelse ud i workflow-loggene, som alle kan læse i et offentligt repository.
- aquasecurity/trivy-action, marts 2026. Aqua Securitys advisory (CVE-2026-33634) oplyser, at 76 af actionens 77 versionstags blev force-pushet til ondsindede commits. Den indsatte kode kørte før den rigtige scanning, læste secrets fra runnerens hukommelse og sendte dem, krypteret, til angriberens infrastruktur.
Workflows, der refererede til en fuld commit-SHA, blev ved med at køre den kode, de havde før. Behold versionen 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
Tjek, at SHA'en kommer fra actionens eget repository, ikke fra en fork. GitHub tilbyder nu noget stærkere:
workflow
dependency lockfiles, generelt tilgængelige siden 28. oktober 2026. CLI-udvidelsen gh actions-lock
skriver .github/workflows/actions.lock, som registrerer det præcise commit for hver action, dine workflows
bruger, inklusive de actions, som de actions kalder, og GitHub tjekker ved kørsel, at hvert kilderepository stadig er
det, du låste. Kald til genbrugelige workflows er ikke dækket, så fastlås dem med SHA. Administratorer kan kræve en
lockfile via en politik. Hverken fastlåsning eller en lockfile gør en action sikker: Gennemgå det, du låser.
Fastlåste actions opdaterer ikke sig selv. Lad Dependabot foreslå opdateringer med en cooldown, så en ny release har et par dage til at blive opdaget, før den når dig:
# .github/dependabot.yml
version: 2
updates:
- package-ecosystem: "github-actions"
directory: "/"
schedule:
interval: "weekly"
cooldown:
default-days: 7
3. Behandl pull_request_target og workflow_run som privilegerede
Et pull_request-workflow fra en fork får et skrivebeskyttet token og ingen secrets. Et
pull_request_target-workflow kører i base-repositoryets kontekst med dets secrets og et token, der kan
skrive, også når pull requesten kommer fra en fork. Det er kun sikkert, så længe workflowet aldrig kører kode fra pull
requesten. Tjekker du pull requestens head ud og bygger den, kører hvert installationsscript og hver test i den pull
request med dine secrets. GitHub Security Lab kalder dem
pwn
requests.
- Brug
pull_requesttil alt, der bygger eller tester bidraget kode. -
Hvis et privilegeret trin skal følge, såsom at kommentere på pull requesten, så del det op: Et uprivilegeret
pull_request-workflow uploader sine resultater som et artefakt, og etworkflow_run-workflow handler på dem. Behandl de artefakter som upålideligt input, aldrig som kode, der skal køres. -
I offentlige repositories uden en hændelsespolitik
blokerer
GitHub
pull_request_targetsom standard fra 2. december 2026. Tillader du det igen, så tillad kun de workflows, der har brug for det.
Kompromitteringen af TanStack i maj 2026 startede sådan: Et pull_request_target-workflow kørte kode fra en
fork, som forgiftede den cache, et release-workflow senere gendannede, og et OIDC-token læst fra runnerens hukommelse
blev brugt til at offentliggøre
84 ondsindede versioner af 42
pakker.
4. Hold hændelsesdata ude af run-scripts
Udtryk udfoldes, før shellen kører, så en pull request-titel, et branchnavn, en issue-tekst eller en commit-besked
inde i run bliver en del af scriptet. Enhver, der kan åbne en pull request eller et issue, kan så køre
kommandoer i dit job. Send værdien gennem en miljøvariabel, så shellen 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 gælder actions/github-script og værdier skrevet til GITHUB_ENV. AI-agenter i
workflows tilføjer en ny form for det samme problem: Tekst i et issue kan styre agenten i stedet for shellen. Se
prompt injection.
Secrets og udrulninger
5. Brug OIDC i stedet for langlivede cloud-nøgler
En cloud-adgangsnøgle gemt som secret virker, indtil nogen roterer den, hvilket efter et læk ofte er for sent. Med OpenID Connect beder jobbet GitHub om et kortlivet token og veksler det hos AWS, Azure eller Google Cloud, hvis trust-politik afgør, hvilket repository, hvilken branch eller hvilket environment der må overtage 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 stadig stjæles fra et kørende job, som TanStack viste, men det er langt mindre værd end en nøgle, der aldrig udløber. Giv de secrets, du beholder, til det trin, der har brug for dem, frem for hele jobbet, så andre actions i jobbet ikke kan læse dem. Hvordan secrets lækker, og resten af kontrollerne, finder du i GitHub Actions-secrets: hvordan de lækker, og hvordan du låser dem ned.
6. Sæt produktion bag environments med påkrævede reviewere
Et environment har sine egne secrets, og et job, der angiver det, kan ikke læse dem, før en påkrævet reviewer godkender kørslen. Regler for deployment-branches begrænser, hvilke branches der overhovedet må bruge det. Et workflow på en feature-branch, eller et, der udløses af en pull request, har så ingen vej til produktionens legitimationsoplysninger.
Governance
7. Kræv code owner-review af workflow-filer
En workflow-fil afgør, hvad der kører med dine secrets, så en ændring i den fortjener samme review som en ændring i
produktionsadgang. Tilføj mappen til CODEOWNERS, og kræv code owner-review i et branch-ruleset:
/.github/workflows/ @example-org/platform-security
/.github/actions/ @example-org/platform-security
8. Begræns, hvilke actions der kan køre
På enterprise-, organisations- eller repository-niveau kan politikken for tilladte actions begrænse actions til dem
fra GitHub, verificerede udgivere eller en liste, du vedligeholder. Siden
august
2025 kan den også kræve SHA-fastlåsning, så et workflow, der bruger en ikke-fastlåst action, fejler, og blokere en
bestemt action eller version med en !-post, hvilket hjælper den dag, en action, du bruger, meldes
kompromitteret.
Runnere, caches og artefakter
9. Hold self-hosted runnere væk fra offentlige repositories
GitHubs reference for sikker brug siger, at self-hosted runnere næsten aldrig bør bruges til offentlige repositories, fordi enhver kan åbne en pull request og køre kode på dem. På private repositories skal du bruge runnere, der starter forfra for hvert job: En langlivet runner beholder det, ét job efterlader, til det næste, inklusive en bagdør. npm-ormen Shai-Hulud registrerede inficerede maskiner som self-hosted runnere netop af den grund. Se managed vs. self-hosted runnere.
10. Beskyt caches mod forgiftning
Caches er afgrænset pr. branch, og caches gemt på default-branchen kan gendannes af alle andre branches. Kode, der kører i et hvilket som helst workflow på default-branchen, kan derfor skrive cache-poster, som et release-workflow senere gendanner, uden at have brug for et skrivetoken. Hold upålidelig kode ude af workflows på default-branchen, undgå at gendanne caches i release- og publiceringsjobs, og byg i stedet fra en lockfile dér. Se hvordan GitHub Actions-cachen virker.
11. Behandl artefakter som upålidelige
actions/checkout beholder tokenet på disken til senere git-kommandoer, medmindre du slår det fra. At
uploade workspacet som et artefakt har tidligere lækket det token. Sæt persist-credentials: false på
checkouts, der ikke pusher, upload kun de stier, du har brug for, og kør aldrig et artefakt fra en pull request i et
privilegeret workflow:
- uses: actions/checkout@<full-commit-sha>
with:
persist-credentials: false
Netværk og registreringer
12. Styr, hvor jobs kan forbinde til
GitHub-hostede runnere begrænser ikke udgående trafik, så kode i et job kan sende det, den læser, hvor som helst hen. De fleste jobs har brug for en kort liste af destinationer: pakkeregistries, container-registries, kildehosts og et par API'er. Tillad dem, og blokér resten, så har en stjålet secret ingen steder at gå hen, selv i et angreb, ingen har set før. En egress-politik stopper ikke secrets, der skrives i logs, som i tj-actions-sagen, og derfor hører den til ved siden af fastlåsning, ikke i stedet for den. Se hvordan en egress-politik stopper exfiltration fra GitHub Actions.
13. Registrér, hvilke actions og pakker hver kørsel brugte
Når den næste kompromitterede action eller pakke offentliggøres, er det første spørgsmål, hvilke af dine kørsler der brugte den. En workflow-fil siger, hvad en kørsel skulle bruge. Et tag, et versionsinterval eller et cache-hit kan gøre svaret anderledes, og den registrering, der afgør det, er den, der blev taget, mens jobbet kørte: commit'et for hver action, hver pakke hentet eller gendannet fra en cache og de forbindelser, jobbet oprettede. Se SBOM'er i GitHub Actions.
Gratis værktøjer, der auditerer dine workflows
De fleste af workflow-punkterne ovenfor kan tjekkes automatisk. Disse værktøjer læser workflow-filer; de overvåger ikke et job, mens det kører.
| Værktøj | Hvad det tjekker |
|---|---|
| zizmor | Statisk analyse af GitHub Actions-, Dependabot- og pre-commit-konfiguration: template injection, farlige triggere, for mange rettigheder, ikke-fastlåste actions, impostor commits, cache-forgiftning og legitimationsoplysninger efterladt af checkout |
| actionlint |
En linter til workflow-syntaks og udtryk, der også markerer upålidelige værdier brugt i inline-scripts og kører
shellcheck på run-trin
|
| OpenSSF Scorecard | Repository-tjek, herunder Dangerous-Workflow (upålidelige checkouts og script injection), Token-Permissions og Pinned-Dependencies |
| poutine | BoostSecuritys open source-scanner til build-pipelines, der dækker GitHub Actions, GitLab, Azure DevOps og Tekton og kan scanne alle repositories i en organisation |
| CodeQL | GitHubs code scanning, som har analyseret workflows for injection- og pwn request-mønstre siden 2025 |
Kør et af dem i pull requests, der rører .github/. For hvordan de passer sammen med runner-kontroller og
posture-værktøjer, se CI/CD-sikkerhedsværktøjer sammenlignet og
CI/CD-sikkerhed. For en tjekliste, der dækker hele pipelinen frem for GitHub
Actions-indstillinger, se tjeklisten for CI/CD-pipelinesikkerhed.
Sådan hjælper CRACI
CRACI erstatter runneren, ikke GitHub Actions: Du ændrer runs-on til craci, og workflows,
secrets, tokenrettigheder og kørselshistorik bliver i GitHub. Det dækker de sidste punkter på listen, dem der sker,
mens et job kører:
- Egress-kontrol. En egress-politik afgør, hvilke pakkekilder, registries og hosts et job må nå. Den valideres, før jobbet starter, håndhæves på runneren og blokerer ved fejl (fail closed), og en blokeret forbindelse udløser en advarsel.
-
En registrering af hver kørsel. Jobbets SBOM viser de GitHub Actions, det kørte, som
pkg:github-komponenter fastlåst på det anvendte commit, og hver pakke, det hentede, inklusive pakker gendannet fra en cache, med et trace af dets netværksforbindelser. Når en actions tags flyttes, kan du se, hvilket commit hver kørsel faktisk eksekverede. - Policy gates. Et build, der trækker en pakke med en kendt sårbarhed ind, inklusive en bestemt CVE, kan stoppes.
- Isolering. Hvert job kører i sin egen virtuelle maskine, så intet føres videre til det næste.
CRACI auditerer ikke dine workflow-filer, scanner ikke kildekode og scanner ikke efter secrets, så behold en workflow-linter som zizmor, GitHubs secret scanning og dit SAST-værktøj til det. Det kører GitHub Actions-jobs på Linux, og andre CI-systemer er på roadmappen.
GitHub Actions-sikkerhed: ofte stillede spørgsmål
Hvordan sikrer jeg GitHub Actions?
Sæt GITHUB_TOKEN til skrivebeskyttet, og giv skriveadgang pr. job, fastlås eller lås tredjeparts-actions, undgå at køre pull request-kode i pull_request_target-workflows, send hændelsesdata til scripts via miljøvariabler, brug OIDC i stedet for gemte cloud-nøgler, sæt produktions-secrets bag environments, kræv review af workflow-filer, og styr, hvad jobs kan forbinde til.
Skal jeg fastlåse GitHub Actions på en commit-SHA?
Ja, for tredjeparts-actions. Et tag kan flyttes til anden kode, som det skete med tj-actions/changed-files i 2025 og trivy-action i 2026, mens en fuld commit-SHA ikke kan. GitHubs workflow-lockfiles går videre og låser også de actions, som dine actions kalder.
Er pull_request_target farligt?
Det er kun sikkert, hvis workflowet aldrig kører kode fra pull requesten. Det kører med base-repositoryets secrets og et skrivetoken, også for forks, så at bygge kode fra en fork i det giver begge dele til den, der åbnede pull requesten. GitHub blokerer det som standard i offentlige repositories uden en hændelsespolitik fra 2. december 2026.
Hvad er en pwn request?
GitHub Security Labs navn for et privilegeret workflow, som regel udløst af pull_request_target, der tjekker upålidelig kode ud fra en pull request og kører den, så forfatteren får adgang til workflowets secrets og token.
Er workflow-lockfiles bedre end SHA-fastlåsning?
De er stærkere. En lockfile registrerer commit'et for hver action, et workflow bruger, inklusive transitive, og GitHub tjekker kilderepositoryets identitet ved kørsel. Kald til genbrugelige workflows er ikke dækket, så fastlås dem med SHA.
Hvilke gratis værktøjer tjekker GitHub Actions-workflows for sikkerhedsproblemer?
zizmor, actionlint, OpenSSF Scorecard og poutine er gratis, og CodeQL kan analysere workflows som en del af GitHub code scanning. De læser workflow-filer; de styrer ikke, hvad et job gør, mens det kører.
Se, hvad et af dine workflows faktisk kørte
Kør et GitHub Actions-job på CRACI, og få commit'et for hver action, hver hentet pakke og en egress-politik, der blokerer ved fejl (fail closed).
Book en demo