Saltar al contenido

Rechazo de GitHub App para actualizar el flujo: solución

Última actualización:

refusing to allow a GitHub App to create or update workflow ... without workflows permission significa que un push intentó añadir o modificar un archivo en .github/workflows, y el token usado para el push no tiene permiso para hacerlo. El GITHUB_TOKEN integrado nunca puede editar archivos de workflow: no existe una entrada workflows que pueda añadir al bloque permissions:. Necesita un token diferente.

El mensaje exacto

! [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'

También puede verlo con peter-evans/create-pull-request, un bot de sincronización, un actualizador de plantillas o herramientas tipo Dependabot que actualizan las versiones de las acciones en los archivos de workflow.

Por qué GitHub lo bloquea

Si un workflow pudiera modificar archivos de workflow con el token que ya tiene, un job comprometido podría reescribir el pipeline, otorgarse más privilegios y mantener su acceso. Por eso GitHub exige un permiso explícito y separado para ello.

Solución 1: usar un token de acceso personal con acceso a workflows

Cree un token y guárdelo como secret:

  1. Token clásico: marque el alcance workflow (además de repo).
  2. Token de grano fino: conceda los permisos de repositorio Contents: Read and write y Workflows: Read and write, en el repositorio al que hace push.

Úselo en checkout para que los push posteriores utilicen este token:

- 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

Solución 2: usar un token de GitHub App (mejor para equipos)

Cree una GitHub App con Contents: Read and write y Workflows: Read and write, instálela en el repositorio y genere un token de corta duración en el job:

- 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 }}

Un token de app no está vinculado a la cuenta de una persona, caduca rápidamente y se limita a lo que haya concedido. Además, permite que el push inicie ejecuciones de workflows posteriores, algo que el GITHUB_TOKEN no hace.

Solución 3: evitar editar archivos de workflow desde CI

Si solo necesita mantener actualizadas las versiones de las acciones, deje que Dependabot lo haga en lugar de su propio script. Consulte configuración de Dependabot. Si solo quiere modificar archivos que no son de workflow, asegúrese de que su commit no incluya nada dentro de .github/workflows, por ejemplo, usando un git add preciso.

Compruebe qué token usa el push

Si pasa token: a actions/checkout pero sigue apareciendo el error, es posible que otro paso sobrescriba las credenciales de git, o que esté definido persist-credentials: false y un paso posterior se autentique con el token predeterminado. Puede comprobar con qué usuario está haciendo el push mediante git remote -v (la URL no contiene ningún secreto) y verificar que el token almacenado es el que pretendía usar.

Cómo prevenirlo

  1. Guarde el token para editar workflows en su propio secret, limitado a un único repositorio.
  2. Prefiera los tokens de GitHub App y rote o haga caducar cualquier token personal.
  3. Limite quién puede modificar el workflow que contiene este permiso, con reglas de protección de ramas y CODEOWNERS. Consulte CODEOWNERS y protección de ramas.
  4. No ejecute este tipo de workflow en pull requests procedentes de forks.

Preguntas frecuentes

¿Puedo añadir workflows: write al bloque permissions?

No. El GITHUB_TOKEN no tiene ese permiso. Use un token de acceso personal o un token de GitHub App.

¿Afecta solo a los push a .github/workflows?

Sí. La comprobación se refiere a la creación o actualización de archivos en ese directorio.

¿Es lo mismo que "Resource not accessible by integration"?

Ambos son problemas de permisos de token, pero este es específico de los archivos de workflow. Para el caso general de la API consulte Resource not accessible by integration.

¿Es seguro usar un token de acceso personal en CI?

Es tan seguro como su alcance y su almacenamiento. Use tokens de grano fino limitados a un único repositorio, guárdelos como secrets y prefiera un token de App siempre que sea posible.