CI/CD-Sicherheit
GitHub-Actions-Sicherheit: eine Checkliste zum Härten Ihrer Workflows
Ein GitHub-Actions-Workflow führt Code vieler Autoren aus, mit dem Token Ihres Repositorys, Ihren Secrets und einem Weg in die Produktion. Die meisten Kontrollen, die ihn absichern, sind in GitHub eingebaut, aber standardmäßig ausgeschaltet, zu locker oder leicht falsch zu konfigurieren. Diese Checkliste behandelt jede davon: was Sie einstellen, warum es wichtig ist und welcher Vorfall zeigt, was ohne sie passiert.
Aktualisiert am
Die Checkliste im Überblick
| Punkt | Was er verhindert |
|---|---|
GITHUB_TOKEN mit minimalen Rechten |
Einen gekaperten Schritt, der Code pusht, Releases veröffentlicht oder andere Workflows auslöst |
| Actions von Drittanbietern pinnen oder sperren | Einen verschobenen Tag, der den Code eines Angreifers in Ihrem Job ausführt |
pull_request_target und workflow_run als privilegiert behandeln |
Pwn Requests: Fork-Code, der mit Ihren Secrets läuft |
Event-Daten aus run-Skripten heraushalten |
Script Injection über Titel, Branch-Namen und Kommentare |
| OIDC statt gespeicherter Cloud-Schlüssel | Langlebige Zugangsdaten, die nach einem Leak noch jahrelang funktionieren |
| Environments mit Pflicht-Reviewern | Beliebige Branches oder Workflows, die Produktions-Secrets lesen |
Code Owners für .github/workflows |
Ungeprüfte Änderungen daran, was die Pipeline ausführt |
| Richtlinie für erlaubte Actions | Unbekannte oder nicht gepinnte Actions irgendwo in der Organisation |
| Keine selbst gehosteten Runner für öffentliche Repositorys | Fremde, die Code auf Ihren Maschinen ausführen |
| Hygiene bei Caches und Artefakten | Vergiftete Caches und Tokens, die über Uploads abfließen |
| Egress-Kontrolle auf Runnern | Gestohlene Secrets, die an den Server eines Angreifers gesendet werden |
| Eine Aufzeichnung jedes Laufs | Nicht zu wissen, welche Builds eine kompromittierte Action oder ein kompromittiertes Paket ausgeführt haben |
Workflow-Code
1. GITHUB_TOKEN nur minimale Rechte geben
Jeder Job erhält ein GITHUB_TOKEN, und jeder Schritt im Job kann es nutzen. Repositorys und Organisationen,
die vor Februar 2023 angelegt wurden, können noch standardmäßig Lese- und Schreibrechte für jede Berechtigung haben. Stellen Sie den Standard unter
Settings → Actions → General → Workflow permissions auf schreibgeschützt und vergeben Sie Schreibrechte dann pro Job:
permissions:
contents: read
jobs:
release:
runs-on: ubuntu-latest
permissions:
contents: write
steps:
- uses: actions/checkout@<full-commit-sha>
Alles, was Sie nicht aufführen, wird zu none. Zu jeder Berechtigung und dazu, was gängige Aufgaben brauchen, siehe
GITHUB_TOKEN-Berechtigungen: minimale Rechte für jeden Workflow.
2. Actions von Drittanbietern auf einen Commit pinnen oder sperren
Ein Tag wie @v4 ist ein Zeiger, den der Besitzer der Action, oder jeder, der dessen Zugang stiehlt, verschieben kann. Zwei
Vorfälle zeigen, was das bedeutet:
- tj-actions/changed-files, März 2025. Ein Angreifer änderte bestehende Versions-Tags so, dass sie auf einen bösartigen Commit zeigten (CVE-2025-30066). Die Action wurde von mehr als 23.000 Repositorys genutzt, und die Payload schrieb Secrets aus dem Speicher des Runners in die Workflow-Logs, die bei einem öffentlichen Repository jeder lesen kann.
- aquasecurity/trivy-action, März 2026. Laut Advisory von Aqua Security (CVE-2026-33634) wurden 76 der 77 Versions-Tags der Action per Force-Push auf bösartige Commits umgebogen. Der eingeschleuste Code lief vor dem eigentlichen Scan, las Secrets aus dem Speicher des Runners und schickte sie verschlüsselt an die Infrastruktur des Angreifers.
Workflows, die einen vollständigen Commit-SHA referenzierten, führten weiter den Code aus, den sie vorher hatten. Behalten Sie die Version als 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
Prüfen Sie, dass der SHA aus dem eigenen Repository der Action stammt, nicht aus einem Fork. GitHub bietet inzwischen etwas Stärkeres:
Workflow-Dependency-Lockfiles,
allgemein verfügbar seit dem 28. Oktober 2026. Die CLI-Erweiterung gh actions-lock
schreibt .github/workflows/actions.lock, das den genauen Commit jeder Action festhält, die Ihre Workflows nutzen,
einschließlich der Actions, die diese Actions aufrufen, und GitHub prüft zur Laufzeit, dass jedes Quell-Repository noch dasjenige ist, das Sie
gesperrt haben. Aufrufe wiederverwendbarer Workflows sind nicht abgedeckt, pinnen Sie diese also per SHA. Administratoren können ein Lockfile per
Richtlinie vorschreiben. Weder Pinning noch ein Lockfile machen eine Action sicher: Prüfen Sie, was Sie sperren.
Gepinnte Actions aktualisieren sich nicht selbst. Lassen Sie Dependabot Updates vorschlagen, mit einer Wartezeit, damit ein neues Release ein paar Tage Zeit hat, aufzufallen, bevor es Sie erreicht:
# .github/dependabot.yml
version: 2
updates:
- package-ecosystem: "github-actions"
directory: "/"
schedule:
interval: "weekly"
cooldown:
default-days: 7
3. pull_request_target und workflow_run als privilegiert behandeln
Ein pull_request-Workflow aus einem Fork erhält ein schreibgeschütztes Token und keine Secrets. Ein
pull_request_target-Workflow läuft im Kontext des Basis-Repositorys, mit dessen Secrets und einem Token, das
schreiben kann, selbst wenn der Pull Request aus einem Fork stammt. Das ist nur sicher, solange der Workflow nie Code aus dem
Pull Request ausführt. Checken Sie den Head des Pull Requests aus und bauen Sie ihn, läuft jedes Installationsskript und jeder Test in diesem Pull Request
mit Ihren Secrets. GitHub Security Lab nennt das
Pwn
Requests.
- Verwenden Sie
pull_requestfür alles, was beigesteuerten Code baut oder testet. -
Muss ein privilegierter Schritt folgen, etwa ein Kommentar am Pull Request, teilen Sie ihn auf: Ein nicht privilegierter
pull_request-Workflow lädt seine Ergebnisse als Artefakt hoch, und einworkflow_run-Workflow verarbeitet sie. Behandeln Sie diese Artefakte als nicht vertrauenswürdige Eingabe, niemals als auszuführenden Code. -
In öffentlichen Repositorys ohne Event-Richtlinie
blockiert
GitHub
pull_request_targetstandardmäßig ab dem 2. Dezember 2026. Wenn Sie es wieder erlauben, erlauben Sie es nur für die Workflows, die es brauchen.
Die Kompromittierung von TanStack im Mai 2026 begann genau so: Ein pull_request_target-Workflow führte Fork-Code aus, der
den Cache vergiftete, den ein Release-Workflow später wiederherstellte, und ein aus dem Speicher des Runners gelesenes OIDC-Token wurde genutzt, um
84 bösartige Versionen von 42
Paketen zu veröffentlichen.
4. Event-Daten aus run-Skripten heraushalten
Ausdrücke werden expandiert, bevor die Shell läuft, sodass ein Pull-Request-Titel, Branch-Name, Issue-Text oder eine Commit-Nachricht
in run Teil des Skripts wird. Wer einen Pull Request oder ein Issue eröffnen kann, kann dann
Befehle in Ihrem Job ausführen. Übergeben Sie den Wert über eine Umgebungsvariable, damit die Shell ihn als Daten behandelt:
# 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"
Dasselbe gilt für actions/github-script und für Werte, die in GITHUB_ENV geschrieben werden. KI-Agenten in
Workflows bringen eine neue Form desselben Problems: Text in einem Issue kann statt der Shell den Agenten steuern. Siehe
Prompt Injection.
Secrets und Deployments
5. OIDC statt langlebiger Cloud-Schlüssel
Ein als Secret gespeicherter Cloud-Zugangsschlüssel funktioniert, bis jemand ihn rotiert, was nach einem Leak oft zu spät ist. Mit OpenID Connect fordert der Job bei GitHub ein kurzlebiges Token an und tauscht es bei AWS, Azure oder Google Cloud ein, deren Vertrauensrichtlinie entscheidet, welches Repository, welcher Branch oder welches Environment die Rolle übernehmen darf:
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
Ein kurzlebiges Token kann aus einem laufenden Job trotzdem gestohlen werden, wie TanStack gezeigt hat, aber es ist weit weniger wert als ein Schlüssel, der nie abläuft. Übergeben Sie die Secrets, die Sie behalten, nur dem Schritt, der sie braucht, statt dem ganzen Job, damit andere Actions im Job sie nicht lesen können. Wie Secrets abfließen und die übrigen Kontrollen finden Sie in GitHub-Actions-Secrets: wie sie abfließen und wie Sie sie absichern.
6. Produktion hinter Environments mit Pflicht-Reviewern stellen
Ein Environment hat eigene Secrets, und ein Job, der es angibt, kann sie erst lesen, wenn ein Pflicht-Reviewer den Lauf freigibt. Regeln für Deployment-Branches begrenzen, welche Branches es überhaupt nutzen dürfen. Ein Workflow auf einem Feature-Branch oder einer, der von einem Pull Request ausgelöst wird, hat dann keinen Weg zu Produktionszugangsdaten.
Governance
7. Code-Owner-Review für Workflow-Dateien vorschreiben
Eine Workflow-Datei entscheidet, was mit Ihren Secrets läuft, also verdient eine Änderung daran dasselbe Review wie eine Änderung am
Produktionszugang. Nehmen Sie den Ordner in CODEOWNERS auf und schreiben Sie in einem Branch-Ruleset ein Code-Owner-Review vor:
/.github/workflows/ @example-org/platform-security
/.github/actions/ @example-org/platform-security
8. Einschränken, welche Actions laufen dürfen
Auf Enterprise-, Organisations- oder Repository-Ebene kann die Richtlinie für erlaubte Actions Actions auf solche von GitHub,
verifizierten Erstellern oder einer von Ihnen gepflegten Liste beschränken. Seit
August
2025 kann sie außerdem SHA-Pinning vorschreiben, sodass ein Workflow mit einer nicht gepinnten Action fehlschlägt, und eine bestimmte Action
oder Version mit einem !-Eintrag blockieren, was an dem Tag hilft, an dem eine von Ihnen genutzte Action als kompromittiert gemeldet wird.
Runner, Caches und Artefakte
9. Selbst gehostete Runner von öffentlichen Repositorys fernhalten
GitHubs Referenz zur sicheren Nutzung sagt, dass selbst gehostete Runner für öffentliche Repositorys fast nie verwendet werden sollten, weil jeder einen Pull Request eröffnen und Code auf ihnen ausführen kann. Nutzen Sie bei privaten Repositorys Runner, die für jeden Job frisch starten: Ein langlebiger Runner behält alles, was ein Job hinterlässt, für den nächsten, einschließlich einer Hintertür. Der npm-Wurm Shai-Hulud registrierte infizierte Maschinen genau aus diesem Grund als selbst gehostete Runner. Siehe verwaltete vs. selbst gehostete Runner.
10. Caches vor Vergiftung schützen
Caches sind nach Branch abgegrenzt, und Caches, die auf dem Default-Branch gespeichert wurden, kann jeder andere Branch wiederherstellen. Code, der in irgendeinem Workflow auf dem Default-Branch läuft, kann daher Cache-Einträge schreiben, die ein Release-Workflow später wiederherstellt, ohne ein Token mit Schreibrechten zu brauchen. Halten Sie nicht vertrauenswürdigen Code aus Workflows auf dem Default-Branch heraus, vermeiden Sie das Wiederherstellen von Caches in Release- und Veröffentlichungs-Jobs und bauen Sie dort stattdessen aus einem Lockfile neu. Siehe wie der GitHub-Actions-Cache funktioniert.
11. Artefakte als nicht vertrauenswürdig behandeln
actions/checkout behält das Token für spätere Git-Befehle auf der Festplatte, sofern Sie das nicht abschalten. Den
Workspace als Artefakt hochzuladen, hat dieses Token in der Vergangenheit offengelegt. Setzen Sie persist-credentials: false bei Checkouts,
die nicht pushen, laden Sie nur die Pfade hoch, die Sie brauchen, und führen Sie niemals ein Artefakt aus einem Pull Request in einem privilegierten
Workflow aus:
- uses: actions/checkout@<full-commit-sha>
with:
persist-credentials: false
Netzwerk und Aufzeichnungen
12. Steuern, wohin Jobs sich verbinden können
GitHub-gehostete Runner beschränken ausgehenden Datenverkehr nicht, sodass Code in einem Job alles, was er liest, überallhin senden kann. Die meisten Jobs brauchen eine kurze Liste von Zielen: Paket-Registries, Container-Registries, Quell-Hosts und ein paar APIs. Erlauben Sie diese und blockieren Sie den Rest, dann kann ein gestohlenes Secret nirgendwohin, selbst bei einem Angriff, den noch niemand gesehen hat. Eine Egress-Richtlinie verhindert keine Secrets, die in Logs ausgegeben werden, wie im Fall tj-actions, weshalb sie neben das Pinning gehört und es nicht ersetzt. Siehe wie eine Egress-Richtlinie Exfiltration aus GitHub Actions stoppt.
13. Aufzeichnen, welche Actions und Pakete jeder Lauf genutzt hat
Wenn die nächste kompromittierte Action oder das nächste kompromittierte Paket bekannt wird, lautet die erste Frage, welche Ihrer Läufe sie genutzt haben. Eine Workflow-Datei sagt, was ein Lauf nutzen sollte. Ein Tag, ein Versionsbereich oder ein Cache-Treffer können die Antwort verändern, und die Aufzeichnung, die sie klärt, ist die, die während des Job-Laufs entstanden ist: der Commit jeder Action, jedes geladene oder aus einem Cache wiederhergestellte Paket und die Verbindungen, die der Job aufgebaut hat. Siehe SBOMs in GitHub Actions.
Kostenlose Tools, die Ihre Workflows prüfen
Die meisten der obigen Workflow-Punkte lassen sich automatisch prüfen. Diese Tools lesen Workflow-Dateien; sie beobachten keinen Job, während er läuft.
| Tool | Was es prüft |
|---|---|
| zizmor | Statische Analyse für GitHub Actions, Dependabot und pre-commit-Konfiguration: Template Injection, gefährliche Trigger, übermäßige Berechtigungen, nicht gepinnte Actions, Impostor-Commits, Cache-Vergiftung und von Checkout zurückgelassene Zugangsdaten |
| actionlint |
Ein Linter für Workflow-Syntax und Ausdrücke, der auch nicht vertrauenswürdige Werte in Inline-Skripten markiert und
shellcheck auf run-Schritte anwendet
|
| OpenSSF Scorecard | Repository-Prüfungen, darunter Dangerous-Workflow (nicht vertrauenswürdige Checkouts und Script Injection), Token-Permissions und Pinned-Dependencies |
| poutine | Der Open-Source-Scanner von BoostSecurity für Build-Pipelines, der GitHub Actions, GitLab, Azure DevOps und Tekton abdeckt und jedes Repository einer Organisation scannen kann |
| CodeQL | GitHubs Code Scanning, das Workflows seit 2025 auf Injection- und Pwn-Request-Muster analysiert |
Lassen Sie eines davon in Pull Requests laufen, die .github/ berühren. Wie diese Tools zu Runner-Kontrollen und Posture-
Tools passen, lesen Sie unter CI/CD-Sicherheitstools im Vergleich und
CI/CD-Sicherheit. Für eine Checkliste, die die gesamte Pipeline statt der Einstellungen von GitHub
Actions abdeckt, siehe die Checkliste für CI/CD-Pipeline-Sicherheit.
Wie CRACI hilft
CRACI ersetzt den Runner, nicht GitHub Actions: Sie ändern runs-on auf craci, und die
Workflows, Secrets, Token-Berechtigungen und der Laufverlauf bleiben in GitHub. CRACI deckt die letzten Punkte dieser Liste ab, die,
die während eines Job-Laufs passieren:
- Egress-Kontrolle. Eine Egress-Richtlinie entscheidet, welche Paketquellen, Registries und Hosts ein Job erreichen darf. Sie wird vor dem Start des Jobs validiert, am Runner durchgesetzt und blockiert im Zweifel (fail closed), und eine blockierte Verbindung löst eine Warnung aus.
-
Eine Aufzeichnung jedes Laufs. Die SBOM des Jobs listet die GitHub Actions, die er ausgeführt hat, als
pkg:github-Komponenten, gepinnt auf den verwendeten Commit, und jedes Paket, das er geladen hat, einschließlich Paketen aus einem Cache, mit einem Trace seiner Netzwerkverbindungen. Werden die Tags einer Action verschoben, sehen Sie, welchen Commit jeder Lauf tatsächlich ausgeführt hat. - Policy Gates. Ein Build, der ein Paket mit einer bekannten Schwachstelle einbindet, auch eine bestimmte CVE, kann gestoppt werden.
- Isolation. Jeder Job läuft in einer eigenen virtuellen Maschine, sodass nichts auf den nächsten übergeht.
CRACI prüft weder Ihre Workflow-Dateien noch scannt es Quellcode oder nach Secrets. Behalten Sie dafür einen Workflow-Linter wie zizmor, GitHubs Secret Scanning und Ihr SAST-Tool. CRACI führt GitHub-Actions-Jobs unter Linux aus, und weitere CI-Systeme sind auf der Roadmap.
GitHub-Actions-Sicherheit: häufig gestellte Fragen
Wie sichere ich GitHub Actions ab?
Setzen Sie GITHUB_TOKEN auf schreibgeschützt und vergeben Sie Schreibrechte pro Job, pinnen oder sperren Sie Actions von Drittanbietern, führen Sie in pull_request_target-Workflows keinen Pull-Request-Code aus, übergeben Sie Event-Daten über Umgebungsvariablen an Skripte, nutzen Sie OIDC statt gespeicherter Cloud-Schlüssel, stellen Sie Produktions-Secrets hinter Environments, schreiben Sie Reviews für Workflow-Dateien vor und steuern Sie, wohin Jobs sich verbinden können.
Sollte ich GitHub Actions auf einen Commit-SHA pinnen?
Ja, bei Actions von Drittanbietern. Ein Tag kann auf anderen Code verschoben werden, wie 2025 bei tj-actions/changed-files und 2026 bei trivy-action geschehen, ein vollständiger Commit-SHA nicht. Die Workflow-Lockfiles von GitHub gehen weiter und sperren auch die Actions, die Ihre Actions aufrufen.
Ist pull_request_target gefährlich?
Es ist nur sicher, wenn der Workflow nie Code aus dem Pull Request ausführt. Es läuft auch bei Forks mit den Secrets des Basis-Repositorys und einem Token mit Schreibrechten, wer darin Fork-Code baut, übergibt also beides an den Autor des Pull Requests. GitHub blockiert es ab dem 2. Dezember 2026 standardmäßig in öffentlichen Repositorys ohne Event-Richtlinie.
Was ist ein Pwn Request?
Der Name, den GitHub Security Lab einem privilegierten Workflow gibt, meist ausgelöst durch pull_request_target, der nicht vertrauenswürdigen Code aus einem Pull Request auscheckt und ausführt und dem Autor so Zugriff auf die Secrets und das Token des Workflows gibt.
Sind Workflow-Lockfiles besser als SHA-Pinning?
Sie sind stärker. Ein Lockfile hält den Commit jeder Action fest, die ein Workflow nutzt, transitive eingeschlossen, und GitHub prüft die Identität des Quell-Repositorys zur Laufzeit. Aufrufe wiederverwendbarer Workflows sind nicht abgedeckt, pinnen Sie diese also per SHA.
Welche kostenlosen Tools prüfen GitHub-Actions-Workflows auf Sicherheitsprobleme?
zizmor, actionlint, OpenSSF Scorecard und poutine sind kostenlos, und CodeQL kann Workflows im Rahmen von GitHub Code Scanning analysieren. Sie lesen Workflow-Dateien; sie steuern nicht, was ein Job tut, während er läuft.
Sehen Sie, was einer Ihrer Workflows tatsächlich ausgeführt hat
Führen Sie einen GitHub-Actions-Job auf CRACI aus und erhalten Sie den Commit jeder Action, jedes geladene Paket und eine Egress-Richtlinie, die im Zweifel blockiert.
Demo buchen