Resource Not Accessible by Integration: 修正方法
最終更新:
Resource not accessible by integration は、GitHub APIからのHTTP 403エラーです。ワークフローが GITHUB_TOKEN を使ってAPIを呼び出しましたが、そのトークンには呼び出しに必要な権限がありません。たとえば、プルリクエストへのコメント投稿やリリースの作成がこれに該当します。ほとんどの場合、修正には permissions: ブロックの追加が必要です。ただし、実行がフォークやDependabotから発生している場合は、別のトークンを使う必要があります。
表示される正確なメッセージ
HttpError: Resource not accessible by integration
Error: Resource not accessible by integration
RequestError [HttpError]: Resource not accessible by integration - https://docs.github.com/rest/...
修正1: 呼び出しに必要な権限を付与する
エラーに含まれるAPIエンドポイントを確認し、GitHubのGITHUB_TOKENのpermissionsリファレンスとそのエンドポイントのドキュメントで必要なパーミッションを調べて追加してください。よくあるものは次のとおりです:
| 実行する操作 | 権限 |
|---|---|
| プルリクエストへのコメント | pull-requests: write |
| Issueへのコメントやラベル付け | issues: write |
| コミット、タグ、リリースのプッシュ | contents: write |
| チェックランの作成 | checks: write |
| GitHub Packagesへの公開 | packages: write |
| クラウドログイン用のOIDCトークン | 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.",
});
重要な点として、permissions: ブロックを記述すると、一覧に含めなかった権限はすべて none に設定されます。ジョブでコードのチェックアウトも行う場合は、contents: read を追加してください。ワークフロー全体に設定することも、ジョブごとに設定することもできますが、安全性の観点からはジョブごとの設定をおすすめします。
修正2: リポジトリと組織のデフォルト設定を確認する
「Settings」「Actions」「General」の「Workflow permissions」で、デフォルトのトークンが読み取り専用か読み書き可能かを設定できます。新しいリポジトリや組織では読み取り専用がデフォルトです。また、組織の設定がリポジトリの設定を上書きする場合もあります。組織によって制限されていない限り、ワークフロー内の permissions: ブロックはこのデフォルトに関係なく機能します。
修正3: フォークからのプルリクエストとDependabot
フォークから pull_request によってトリガーされたワークフローでは、GitHubは GITHUB_TOKEN に読み取り専用のアクセス権のみを与え、リポジトリのシークレットを渡しません。そのため、ファイル内で書き込み権限を指定しても効果がありません。Dependabotによって実行された場合も、デフォルトでは読み取り専用のトークンが使われます。対処方法は次のとおりです。
workflow_runトリガーを使い、最初のワークフローの後に実行される別のワークフローで書き込みステップを行ってください。このトリガーはベースリポジトリのコンテキストで実行されます。pull_request_targetは、リスクを理解している場合にのみ使用してください。このトリガーは書き込み権限とシークレットを持って実行されるため、プルリクエストのコードをチェックアウトして実行することは絶対に避けてください。詳しくはGitHub Actionsのセキュリティを参照してください。- Dependabotの場合は、必要なシークレットをActions用ではなく、Dependabot用のシークレットストアに設定してください。
修正4: GITHUB_TOKENで実行できない場合は別のトークンを使う
GITHUB_TOKEN がアクセスできるのは、ワークフローが実行されているリポジトリだけです。別のリポジトリへの操作、ワークフローファイルの変更、または他のワークフローの実行をトリガーする必要がある場合は、GitHub Appのインストールトークン、または必要な権限を指定したfine-grained personal access tokenを使ってください。
予防方法
- すべてのワークフローとジョブで
permissions:を明示的に宣言し、必要最小限の権限を設定してください。 - リポジトリのデフォルトは読み取り専用に保ち、書き込み権限はジョブごとに付与してください。
- 同じリポジトリ内のブランチからだけでなく、フォークからのプルリクエストでも自動化を検証してください。
- リポジトリをまたぐ処理では、個人用アクセストークンよりもGitHub Appのトークンを優先してください。
よくある質問
なぜ自分のブランチでは動くのに、フォークからのプルリクエストでは失敗するのですか。
フォークからのプルリクエストは、ファイルの内容に関係なく読み取り専用のトークンとシークレットなしで実行されます。書き込みステップには workflow_run を使ってください。
permissions: を追加すると、ほかの権限が削除されますか。
はい。一覧に含めなかった権限はすべて none になるため、ジョブに必要なすべての権限を記載してください。
404や401と同じですか。
いいえ。このメッセージを伴う403は、認証はされているものの、操作が許可されていないことを意味します。404は、リポジトリが存在しないか、トークンから見えないリポジトリであることを示す場合があります。アクションの検索に関する問題はUnable to resolve actionを参照してください。
GITHUB_TOKENでワークフローファイルを編集できますか?
いいえ。.github/workflows配下のファイルを変更する権限を付与することはできません。refusing to allow a GitHub App to update workflowを参照してください。
関連記事
- Cache Service Responded With 429: 修正方法GitHub Actions の「Failed to restore: Cache service responded with 429」を修正します。キャッシュへのリクエストが多すぎる場合の対処法です。actions/cache を更新し、復元は何度行っても構いませんが、保存は一度だけにしてください。
- fatal: could not read Username for github.com: 修正方法GitHub Actionsで"fatal: could not read Username for 'https://github.com'"を解決する方法:プライベートリポジトリ、サブモジュール、gitの依存関係にはトークンが必要です。
- Invalid Workflow File: YAML構文エラーの修正方法GitHub Actionsで"Invalid workflow file"と"You have an error in your yaml syntax"を解決する方法:インデント、予期しない値、不正な式をactionlintで確認します。
- GitHub ActionsでのJavaScript Heap Out of Memoryの修正方法GitHub ActionsでNODE_OPTIONSを使い、"FATAL ERROR: Reached heap limit Allocation failed - JavaScript heap out of memory"とnpm ENOMEMを解決する方法。