コンテンツへスキップ

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によって実行された場合も、デフォルトでは読み取り専用のトークンが使われます。対処方法は次のとおりです。

  1. workflow_run トリガーを使い、最初のワークフローの後に実行される別のワークフローで書き込みステップを行ってください。このトリガーはベースリポジトリのコンテキストで実行されます。
  2. pull_request_target は、リスクを理解している場合にのみ使用してください。このトリガーは書き込み権限とシークレットを持って実行されるため、プルリクエストのコードをチェックアウトして実行することは絶対に避けてください。詳しくはGitHub Actionsのセキュリティを参照してください。
  3. Dependabotの場合は、必要なシークレットをActions用ではなく、Dependabot用のシークレットストアに設定してください。

修正4: GITHUB_TOKENで実行できない場合は別のトークンを使う

GITHUB_TOKEN がアクセスできるのは、ワークフローが実行されているリポジトリだけです。別のリポジトリへの操作、ワークフローファイルの変更、または他のワークフローの実行をトリガーする必要がある場合は、GitHub Appのインストールトークン、または必要な権限を指定したfine-grained personal access tokenを使ってください。

予防方法

  1. すべてのワークフローとジョブで permissions: を明示的に宣言し、必要最小限の権限を設定してください。
  2. リポジトリのデフォルトは読み取り専用に保ち、書き込み権限はジョブごとに付与してください。
  3. 同じリポジトリ内のブランチからだけでなく、フォークからのプルリクエストでも自動化を検証してください。
  4. リポジトリをまたぐ処理では、個人用アクセストークンよりも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を参照してください。