Zum Inhalt springen

GitHub App darf Workflow nicht aktualisieren: Lösung

Zuletzt aktualisiert am

refusing to allow a GitHub App to create or update workflow ... without workflows permission bedeutet, dass ein Push versucht hat, eine Datei unter .github/workflows anzulegen oder zu ändern, und das für den Push verwendete Token dies nicht darf. Das integrierte GITHUB_TOKEN kann Workflow-Dateien niemals bearbeiten: Es gibt keinen Eintrag workflows, den Sie dem permissions:-Block hinzufügen könnten. Sie benötigen ein anderes Token.

Die genaue Meldung

! [remote rejected] main -> main (refusing to allow a GitHub App to create or update workflow `.github/workflows/ci.yml` without `workflows` permission)
error: failed to push some refs to 'https://github.com/my-org/my-repo'

Sie können diesen Fehler auch bei peter-evans/create-pull-request, einem Sync-Bot, einem Template-Updater oder Dependabot-ähnlichen Tools sehen, die Action-Versionen in Workflow-Dateien aktualisieren.

Warum GitHub dies blockiert

Könnte ein Workflow Workflow-Dateien mit dem bereits vorhandenen Token ändern, könnte ein kompromittierter Job die Pipeline umschreiben, sich selbst mehr Rechte verschaffen und sich dauerhaft festsetzen. Deshalb verlangt GitHub dafür eine ausdrückliche, separate Berechtigung.

Lösung 1: Personal Access Token mit Workflow-Zugriff verwenden

Erstellen Sie ein Token und speichern Sie es als Secret:

  1. Classic Token: Aktivieren Sie den Scope workflow (zusätzlich zu repo).
  2. Fine-grained Token: Gewähren Sie für das Repository, in das Sie pushen, die Berechtigungen Contents: Read and write und Workflows: Read and write.

Verwenden Sie es beim Checkout, damit spätere Pushes es nutzen:

- uses: actions/checkout@v4
  with:
    token: ${{ secrets.WORKFLOW_PAT }}
- run: |
    sed -i 's/actions\/checkout@v3/actions\/checkout@v4/' .github/workflows/*.yml
    git config user.name "ci-bot"
    git config user.email "ci-bot@users.noreply.github.com"
    git commit -am "Bump checkout" && git push

Lösung 2: GitHub-App-Token verwenden (besser für Teams)

Erstellen Sie eine GitHub App mit Contents: Read and write und Workflows: Read and write, installieren Sie sie im Repository und erzeugen Sie im Job ein kurzlebiges Token:

- uses: actions/create-github-app-token@v1
  id: app
  with:
    app-id: ${{ vars.APP_ID }}
    private-key: ${{ secrets.APP_PRIVATE_KEY }}
- uses: actions/checkout@v4
  with:
    token: ${{ steps.app.outputs.token }}

Ein App-Token ist nicht an das Konto einer einzelnen Person gebunden, läuft schnell ab und ist auf die von Ihnen erteilten Berechtigungen beschränkt. Außerdem kann der Push Folge-Workflow-Runs auslösen, was mit dem GITHUB_TOKEN nicht möglich ist.

Lösung 3: Das Bearbeiten von Workflow-Dateien aus der CI vermeiden

Wenn Sie nur die Action-Versionen aktuell halten möchten, lassen Sie Dependabot das übernehmen statt eines eigenen Skripts. Siehe Dependabot-Einrichtung. Wenn Sie nur Dateien außerhalb von Workflows ändern möchten, stellen Sie sicher, dass Ihr Commit nichts unter .github/workflows enthält, zum Beispiel durch ein präzises git add.

Prüfen, welches Token der Push verwendet

Wenn Sie token: an actions/checkout übergeben, der Fehler aber trotzdem auftritt, überschreibt möglicherweise ein anderer Schritt die Git-Zugangsdaten, oder persist-credentials: false ist gesetzt und ein späterer Schritt authentifiziert sich mit dem Standard-Token. Mit git remote -v lässt sich prüfen, als welcher Benutzer Sie pushen (die URL enthält kein Secret). Kontrollieren Sie außerdem, ob das gespeicherte Token das beabsichtigte ist.

So verhindern Sie den Fehler

  1. Bewahren Sie das Token zum Bearbeiten von Workflows in einem eigenen Secret auf, das auf das eine Repository beschränkt ist.
  2. Bevorzugen Sie GitHub-App-Token und rotieren oder befristen Sie jedes persönliche Token.
  3. Beschränken Sie mit Branch Protection und CODEOWNERS, wer den Workflow ändern darf, der diese Berechtigung besitzt. Siehe CODEOWNERS und Branch Protection.
  4. Führen Sie diese Art von Workflow nicht bei Pull Requests aus Forks aus.

FAQ

Kann ich workflows: write zum permissions-Block hinzufügen?

Nein. Das GITHUB_TOKEN besitzt diese Berechtigung nicht. Verwenden Sie ein Personal Access Token oder ein GitHub-App-Token.

Betrifft das nur Pushes nach .github/workflows?

Ja. Die Prüfung betrifft das Anlegen oder Ändern von Dateien in diesem Verzeichnis.

Ist das dasselbe wie "Resource not accessible by integration"?

Beides sind Probleme mit Token-Berechtigungen, dieses ist jedoch speziell auf Workflow-Dateien bezogen. Den allgemeinen API-Fall finden Sie unter Resource not accessible by integration.

Ist ein Personal Access Token in der CI sicher?

So sicher wie sein Scope und seine Aufbewahrung. Verwenden Sie Fine-grained Tokens, die auf ein Repository beschränkt sind, speichern Sie sie als Secrets und bevorzugen Sie nach Möglichkeit ein App-Token.