コンテンツへスキップ

GitHub Appによるワークフローの更新を拒否される:修正方法

最終更新:

refusing to allow a GitHub App to create or update workflow ... without workflows permission は、プッシュが .github/workflows 配下のファイルを追加または変更しようとしたものの、そのプッシュに使われたトークンにはその操作が許可されていないことを意味します。組み込みの GITHUB_TOKEN でワークフローファイルを編集することはできません。permissions: ブロックに workflows のエントリを追加することもできません。別のトークンが必要です。

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

! [remote rejected] main -> main (refusing to allow a GitHub App to create or update workflow `.github/workflows/ci.yml` without `workflows` permission)
error: failed to push some refs to 'https://github.com/my-org/my-repo'

このエラーは、peter-evans/create-pull-request、同期ボット、テンプレート更新ツール、ワークフローファイル内のアクションのバージョンを更新する Dependabot 系のツールなどでも発生することがあります。

GitHub がこの操作をブロックする理由

ワークフローが既に持っているトークンでワークフローファイルを変更できてしまうと、侵害されたジョブがパイプラインを書き換え、自身により多くの権限を追加し、永続化できてしまいます。そのため GitHub は、これに対して明示的かつ別途の権限を要求しています。

対策 1: ワークフローへのアクセス権を持つ個人アクセストークンを使う

トークンを作成し、シークレットとして保存します。

  1. クラシックトークンの場合: workflow スコープ(および repo)にチェックを入れます。
  2. ファイングレイン トークンの場合: プッシュ先のリポジトリに対して、リポジトリ権限の Contents: Read and write と Workflows: Read and write を付与します。

以降のプッシュでこのトークンが使われるように、チェックアウトで使用します。

- uses: actions/checkout@v4
  with:
    token: ${{ secrets.WORKFLOW_PAT }}
- run: |
    sed -i 's/actions\/checkout@v3/actions\/checkout@v4/' .github/workflows/*.yml
    git config user.name "ci-bot"
    git config user.email "ci-bot@users.noreply.github.com"
    git commit -am "Bump checkout" && git push

対策 2: GitHub App トークンを使う(チーム向けに推奨)

Contents: Read and write と Workflows: Read and write の権限を持つ GitHub App を作成し、リポジトリにインストールして、ジョブ内で短命のトークンを発行します。

- uses: actions/create-github-app-token@v1
  id: app
  with:
    app-id: ${{ vars.APP_ID }}
    private-key: ${{ secrets.APP_PRIVATE_KEY }}
- uses: actions/checkout@v4
  with:
    token: ${{ steps.app.outputs.token }}

App トークンは特定の個人のアカウントに紐づかず、すぐに期限切れになり、付与された権限の範囲内に限られます。また、GITHUB_TOKEN では行えない、後続のワークフロー実行をプッシュで開始することもできます。

対策 3: CI からワークフローファイルを編集しない

アクションのバージョンを最新に保つだけであれば、自前のスクリプトではなく Dependabot に任せてください。詳しくは Dependabot のセットアップ を参照してください。ワークフロー以外のファイルだけを変更したい場合は、たとえば git add で対象を明確に指定するなどして、コミットに .github/workflows 配下のファイルが含まれないようにしてください。

プッシュに使われているトークンを確認する

actions/checkout に token: を渡しているのにエラーが出る場合、別のステップが git の認証情報を上書きしているか、persist-credentials: false が設定されていて、後のステップがデフォルトのトークンで認証している可能性があります。git remote -v を実行すると、どのユーザーとしてプッシュしようとしているかを確認できます(URL にシークレットは含まれません)。意図したトークンが保存されているかも確認してください。

予防方法

  1. ワークフローを編集するトークンは、専用のシークレットに保存し、対象を 1 つのリポジトリに限定してください。
  2. GitHub App トークンを優先し、個人トークンはローテーションするか有効期限を設定してください。
  3. この強い権限を持つワークフローを変更できる人を、ブランチ保護と CODEOWNERS で制限してください。詳しくは CODEOWNERS とブランチ保護 を参照してください。
  4. フォークからのプルリクエストに対して、この種のワークフローを実行しないでください。

よくある質問

permissions ブロックに workflows: write を追加できますか?

いいえ。GITHUB_TOKEN にはそのような権限はありません。個人アクセストークンまたは GitHub App トークンを使用してください。

影響があるのは .github/workflows へのプッシュだけですか?

はい。このチェックは、そのディレクトリ内のファイルを作成または更新する操作を対象としています。

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

どちらもトークンの権限に関する問題ですが、こちらはワークフローファイルに特化したものです。API 全般の場合は Resource not accessible by integration を参照してください。

個人アクセストークンを CI で使うのは安全ですか?

安全性は、そのスコープと保存方法によって決まります。1 つのリポジトリに限定したファイングレイン トークンを使い、シークレットとして保存し、可能な場合は App トークンを優先してください。