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 Folgendes | Berechtigung |
|---|---|
| Kommentieren eines Pull Requests | pull-requests: write |
| Kommentieren oder Labeln eines Issues | issues: write |
| Pushen von Commits, Tags oder Releases | contents: write |
| Erstellen von Check Runs | checks: write |
| Veröffentlichen in GitHub Packages | packages: write |
| OIDC-Token für die Cloud-Anmeldung | id-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:
- 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. - Verwenden Sie
pull_request_targetnur, 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. - 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
- Deklarieren Sie in jedem Workflow und Job
permissions:explizit, mit den minimal nötigen Rechten. - Belassen Sie den Repository-Standard bei nur lesend und vergeben Sie Schreibrechte pro Job.
- Testen Sie die Automatisierung für Pull Requests aus einem Fork, nicht nur von einem Branch im selben Repository.
- 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.
Verwandt
- Cache Service Responded With 429: So beheben Sie den FehlerFix "Failed to restore: Cache service responded with 429" in GitHub Actions: zu viele Cache-Anfragen. actions/cache aktualisieren, einmal wiederherstellen, einmal speichern.
- fatal: could not read Username for github.com: BehebenBehebe "fatal: could not read Username for 'https://github.com'" in GitHub Actions: Private Repos, Submodules und Git-Abhängigkeiten benötigen einen Token.
- Ungültige Workflow-Datei: YAML-Syntaxfehler beheben"Ungültige Workflow-Datei" und "Fehler in der YAML-Syntax" in GitHub Actions beheben: Einrückung, unerwarteter Wert, fehlerhafte Ausdrücke, mit actionlint.
- JavaScript Heap Out of Memory in GitHub Actions: BehebenBeheben Sie "FATAL ERROR: Reached heap limit Allocation failed - JavaScript heap out of memory" und npm ENOMEM in GitHub Actions mit NODE_OPTIONS.