Zum Inhalt springen

Permission Denied to github-actions[bot] (403): Lösung

Zuletzt aktualisiert am

Permission to <owner>/<repo>.git denied to github-actions[bot] bedeutet, dass ein Workflow versucht hat zu pushen (einen Commit, ein Tag oder einen Branch), das GITHUB_TOKEN dafür aber nur Lesezugriff hat. Die Lösung ist eine Zeile im Workflow und in manchen Organisationen eine Einstellung. Diese Seite behandelt außerdem die anderen Gründe, aus denen ein Push durch den Bot fehlschlägt.

Die genaue Meldung

remote: Permission to my-org/my-repo.git denied to github-actions[bot].
fatal: unable to access 'https://github.com/my-org/my-repo/': The requested URL returned error: 403

Lösung 1: Dem Job contents: write geben

permissions:
  contents: write

jobs:
  release:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: |
          git config user.name "github-actions[bot]"
          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
          git add CHANGELOG.md
          git commit -m "Update changelog" || echo "nothing to commit"
          git push

actions/checkout speichert das Token des Workflows standardmäßig für spätere Git-Befehle, daher verwendet ein einfaches git push es. Setzen Sie permissions auf den Job, der pusht, und nicht auf den gesamten Workflow, damit andere Jobs weiterhin nur lesend arbeiten.

Lösung 2: Standardeinstellung der Organisation und des Repositorys prüfen

Unter Settings, Actions, General kann "Workflow permissions" auf "Read repository contents and packages permissions" (nur lesend) stehen. Ein Organisationsinhaber kann dies für alle Repositorys erzwingen. Ein permissions:-Block im Workflow kann die Berechtigung erhöhen, sofern die Organisationseinstellung dies nicht verhindert. Wenn der Block keine Wirkung hat, wenden Sie sich an einen Inhaber.

Lösung 3: Der Push wird durch eine Branch-Regel blockiert

Ein geschützter Branch, der Pull Requests, Reviews oder Status-Checks verlangt, lehnt auch einen direkten Push des Bots ab, mit einer anderen Meldung wie GH006: Protected branch update failed. Der Bot kann die Regel standardmäßig nicht umgehen. Möglichkeiten sind, in einen neuen Branch zu pushen und einen Pull Request zu öffnen, oder die App bzw. den Bot in die Bypass-Liste des Rulesets aufzunehmen, sofern Ihr Tarif dies unterstützt.

- uses: peter-evans/create-pull-request@v7
  with:
    branch: auto/changelog
    title: Update changelog

Diese Aktion benötigt contents: write und pull-requests: write sowie die Repository-Einstellung "Allow GitHub Actions to create and approve pull requests", die aktiviert sein muss.

Lösung 4: Forks können nicht pushen

Bei Workflows, die durch einen Pull Request aus einem Fork ausgelöst werden, ist das Token nur lesend, und keine Berechtigungseinstellung ändert das. Der Workflow kann nicht in den Branch des Forks pushen. Führen Sie den Schreibschritt in einem separaten Workflow aus, der durch workflow_run ausgelöst wird, oder bitten Sie Mitwirkende, den Formatierer lokal auszuführen.

Lösung 5: Der Workflow soll pushen und weitere Workflows auslösen

Ein Push mit dem GITHUB_TOKEN startet keine weiteren Workflow-Runs, was GitHub verhindert, um Endlosschleifen zu vermeiden. Wenn ein gepushter Commit oder Tag einen Workflow auslösen muss, pushen Sie stattdessen mit einem GitHub-App-Token oder einem persönlichen Zugriffstoken.

Lösung 6: Tags pushen oder Workflow-Dateien bearbeiten

Das Pushen eines Tags benötigt ebenfalls contents: write. Das Ändern einer Datei unter .github/workflows ist mit dem GITHUB_TOKEN gar nicht möglich, siehe refusing to allow a GitHub App to update workflow.

So verhindern Sie den Fehler

  1. Halten Sie die Standardberechtigungen nur lesend und fügen Sie contents: write nur dem einen Job hinzu, der pusht.
  2. Planen Sie für Branch-Regeln: Pushen Sie in einen Branch und öffnen Sie einen Pull Request, anstatt direkt in main zu pushen.
  3. Verwenden Sie ein GitHub-App-Token, wenn ein Push einen nachfolgenden Workflow auslösen muss.
  4. Testen Sie den Workflow in einem Branch, bevor Sie ihn für Releases verwenden.

FAQ

Warum kann der Bot lesen, aber nicht schreiben?

Neuere Repositorys und Organisationen setzen das GITHUB_TOKEN aus Sicherheitsgründen standardmäßig auf nur lesend. Schreibzugriff aktivieren Sie pro Job.

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

Die Ursache ist dieselbe (eine fehlende Token-Berechtigung), nur wird sie über Git statt über die API sichtbar. Siehe Resource not accessible by integration.

Verursacht persist-credentials: false dieses Problem?

Ja. Damit wird das Token nicht für spätere Git-Befehle gespeichert, sodass git push keine Zugangsdaten hat. Lassen Sie die Einstellung für Jobs, die pushen, auf dem Standardwert oder übergeben Sie das Token explizit.

Kann ich aus einem zeitgesteuerten Workflow pushen?

Ja, mit contents: write. Zeitgesteuerte Workflows laufen auf dem Standard-Branch, daher gelten die Regeln für geschützte Branches weiterhin.