コンテンツへスキップ

github-actions[bot]によるアクセス拒否(403): 修正方法

最終更新:

Permission to <owner>/<repo>.git denied to github-actions[bot] は、ワークフローがプッシュ(コミット、タグ、ブランチ)を試みたものの、使用された GITHUB_TOKEN が読み取り権限しか持っていないことを意味します。修正はワークフロー内の1行の変更で、組織によってはさらに1つの設定が必要になります。このページでは、bot によるプッシュが失敗するその他の原因についても説明します。

表示される正確なメッセージ

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

修正1:ジョブにcontents: writeを付与する

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は、デフォルトでワークフローのトークンを後続のgitコマンド用に保存するため、単純なgit pushでもそのトークンが使われます。他のジョブは読み取り専用のままにできるよう、permissionsはワークフロー全体ではなく、プッシュを行うジョブに設定してください。

修正2:組織とリポジトリのデフォルト設定を確認する

「Settings」「Actions」「General」の「Workflow permissions」が「Read repository contents and packages permissions」(読み取り専用)になっている場合があります。組織のオーナーは、すべてのリポジトリに対してこれを強制できます。組織の設定でそれが禁止されていない限り、ワークフロー内のpermissions:ブロックで権限を引き上げられます。ブロックを記述しても効果がない場合は、オーナーに確認してください。

修正3:ブランチルールによってプッシュがブロックされている

プルリクエスト、レビュー、またはステータスチェックを必須とする保護されたブランチは、ボットからの直接のプッシュも拒否します。その際にはGH006: Protected branch update failedなどの別のメッセージが表示されます。デフォルトでは、ボットがこのルールを迂回することはできません。対処法は、新しいブランチにプッシュしてプルリクエストを作成するか、お使いのプランが対応している場合は、ルールセットのバイパスリストにアプリまたはボットを追加することです。

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

そのアクションにはcontents: writeとpull-requests: writeが必要で、さらにリポジトリ設定の「Allow GitHub Actions to create and approve pull requests」を有効にする必要があります。

修正4:フォークからはプッシュできない

フォークで開かれたプルリクエストによってトリガーされるワークフローでは、トークンは読み取り専用となり、どの権限設定を変更してもこれは変わりません。ワークフローはフォーク側のブランチにプッシュできません。書き込みのステップはworkflow_runによってトリガーされる別のワークフローから実行するか、コントリビューターにフォーマッターをローカルで実行してもらってください。

修正5:プッシュによって別のワークフローもトリガーしたい

GITHUB_TOKENで行われたプッシュは、他のワークフロー実行をトリガーしません。これはループを防ぐためのGitHubの仕様です。プッシュしたコミットやタグによってワークフローを必ず起動させる必要がある場合は、GitHub Appのトークンまたは個人用アクセストークンでプッシュしてください。

修正6:タグのプッシュやワークフローファイルの編集

タグをプッシュするには、同じくcontents: writeが必要です。.github/workflows配下のファイルの変更は、GITHUB_TOKENでは一切できません。詳しくはrefusing to allow a GitHub App to update workflowを参照してください。

予防方法

  1. デフォルトの権限は読み取り専用のままにし、contents: writeはプッシュを行う1つのジョブにのみ追加してください。
  2. ブランチルールを想定し、mainに直接プッシュする代わりに、ブランチにプッシュしてプルリクエストを作成してください。
  3. 後続のワークフローを必ずトリガーさせる必要がある場合は、GitHub Appのトークンを使用してください。
  4. リリースに利用する前に、ブランチ上でワークフローをテストしてください。

よくある質問

ボットが読み取れるのに書き込めないのはなぜですか?

新しいリポジトリや組織では、安全のためGITHUB_TOKENのデフォルトが読み取り専用になっています。書き込みは、ジョブごとに明示的に許可する必要があります。

これは「Resource not accessible by integration」と同じものですか?

原因は同じ(トークンの権限不足)ですが、APIではなくgit経由で現れたものです。Resource not accessible by integrationを参照してください。

persist-credentials: falseを設定すると問題になりますか?

はい。この設定を行うと、トークンは後続のgitコマンド用に保持されないため、git pushが認証に使えるものがなくなります。プッシュを行うジョブではデフォルトのままにするか、トークンを明示的に渡してください。

スケジュール実行されるワークフローからプッシュできますか?

contents: writeを付与すれば可能です。スケジュールされたワークフローはデフォルトブランチで実行されるため、保護されたブランチのルールは引き続き適用されます。