Zum Inhalt springen

Resource Not Accessible by Integration: So beheben

Zuletzt aktualisiert am

Resource not accessible by integration ist ein HTTP 403 der GitHub API. Ihr Workflow hat die API mit dem GITHUB_TOKEN aufgerufen, und dieses Token besitzt nicht die Berechtigung, die der Aufruf benötigt, zum Beispiel das Schreiben eines Kommentars in einem Pull Request oder das Erstellen eines Releases. Die Lösung ist fast immer ein permissions:-Block oder ein anderes Token, wenn der Lauf aus einem Fork oder von Dependabot stammt.

Die genaue Meldung

HttpError: Resource not accessible by integration
Error: Resource not accessible by integration
RequestError [HttpError]: Resource not accessible by integration - https://docs.github.com/rest/...

Lösung 1: Die benötigte Berechtigung erteilen

Sehen Sie sich den API-Endpunkt in der Fehlermeldung an, ermitteln Sie in der Referenz permissions for the GITHUB_TOKEN von GitHub sowie in der Dokumentation des Endpunkts, welche Berechtigung er benötigt, und fügen Sie sie hinzu. Häufige Beispiele:

Sie tun FolgendesBerechtigung
Kommentieren eines Pull Requestspull-requests: write
Kommentieren oder Labeln eines Issuesissues: write
Pushen von Commits, Tags oder Releasescontents: write
Erstellen von Check Runschecks: write
Veröffentlichen in GitHub Packagespackages: write
OIDC-Token für die Cloud-Anmeldungid-token: write
permissions:
  contents: read
  pull-requests: write

jobs:
  comment:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/github-script@v7
        with:
          script: |
            await github.rest.issues.createComment({
              owner: context.repo.owner,
              repo: context.repo.repo,
              issue_number: context.issue.number,
              body: "Build finished.",
            });

Wichtiges Detail: Sobald Sie einen permissions:-Block schreiben, wird jede Berechtigung, die Sie nicht auflisten, auf none gesetzt. Fügen Sie contents: read hinzu, wenn der Job zusätzlich Code auscheckt. Sie können dies für den gesamten Workflow oder pro Job setzen; pro Job ist sicherer.

Lösung 2: Repository- und Organisations-Standard prüfen

Unter Settings, Actions, General entscheidet „Workflow permissions“, ob das Standard-Token nur lesend oder lesend und schreibend ist. Neuere Repositories und Organisationen sind standardmäßig auf nur lesend eingestellt, und eine Organisationseinstellung kann das Repository überschreiben. Ein permissions:-Block im Workflow funktioniert unabhängig von diesem Standard, solange die Organisation ihn nicht eingeschränkt hat.

Lösung 3: Pull Requests aus Forks und von Dependabot

Bei Workflows, die durch pull_request aus einem Fork ausgelöst werden, erhält das GITHUB_TOKEN von GitHub nur Lesezugriff und Repository-Secrets werden nicht übergeben. Eine Schreibberechtigung in der Datei hilft daher nicht. Auch durch Dependabot ausgelöste Läufe erhalten standardmäßig ein Token mit Lesezugriff. Optionen:

  1. Führen Sie den Schreibschritt in einem separaten Workflow aus, der nach dem ersten läuft, über den Trigger workflow_run, der im Kontext des Basis-Repositories ausgeführt wird.
  2. Verwenden Sie pull_request_target nur, wenn Sie das Risiko verstehen. Der Workflow läuft mit Schreibzugriff und Secrets und darf niemals Code aus dem Pull Request auschecken und ausführen. Siehe sichere GitHub Actions.
  3. Hinterlegen Sie für Dependabot die benötigten Secrets im Dependabot-Secrets-Speicher, nicht im Actions-Speicher.

Lösung 4: Ein anderes Token verwenden, wenn das GITHUB_TOKEN dies nicht kann

Das GITHUB_TOKEN hat nur Zugriff auf das Repository, in dem der Workflow läuft. Für ein anderes Repository, für das Ändern von Workflow-Dateien oder für Aktionen, die weitere Workflow-Läufe auslösen müssen, verwenden Sie ein Installationstoken einer GitHub App oder ein Fine-grained Personal Access Token mit genau den benötigten Berechtigungen.

So verhindern Sie den Fehler

  1. Deklarieren Sie in jedem Workflow und Job permissions: explizit, mit den minimal nötigen Rechten.
  2. Belassen Sie den Repository-Standard bei nur lesend und vergeben Sie Schreibrechte pro Job.
  3. Testen Sie die Automatisierung für Pull Requests aus einem Fork, nicht nur von einem Branch im selben Repository.
  4. Bevorzugen Sie für repositoryübergreifende Arbeit ein GitHub-App-Token gegenüber einem Personal Access Token.

FAQ

Warum funktioniert es auf meinem Branch, aber nicht bei einem Pull Request aus einem Fork?

Pull Requests aus Forks laufen mit einem Token mit reinen Leserechten und ohne Secrets, unabhängig davon, was in der Datei steht. Verwenden Sie für den Schreibschritt workflow_run.

Entfernt das Hinzufügen von permissions: meine anderen Berechtigungen?

Ja. Jede Berechtigung, die Sie nicht auflisten, wird zu none. Listen Sie daher alles auf, was der Job benötigt.

Ist das dasselbe wie ein 404 oder 401?

Nein. Ein 403 mit dieser Meldung bedeutet, dass Sie authentifiziert, aber nicht berechtigt sind. Ein 404 kann auf ein fehlendes Repository oder eines hinweisen, das das Token nicht sehen kann. Für Action-Suchen siehe Unable to resolve action.

Kann das GITHUB_TOKEN Workflow-Dateien bearbeiten?

Nein. Ihm kann keine Berechtigung erteilt werden, Dateien unter .github/workflows zu ändern. Siehe refusing to allow a GitHub App to update workflow.