Permission Denied to github-actions[bot] (403): solución
Última actualización:
Permission to <owner>/<repo>.git denied to github-actions[bot] significa que un workflow intentó hacer un push (un commit, una etiqueta o una rama) y el GITHUB_TOKEN que usó solo tiene acceso de lectura. La solución es una línea en el workflow y, en algunas organizaciones, una configuración. Esta página también cubre los otros motivos por los que falla un push del bot.
El mensaje exacto
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
Solución 1: dé al job 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 guarda el token del workflow para los comandos git posteriores de forma predeterminada, por lo que un git push simple lo usa. Coloque permissions en el job que hace el push, no en todo el workflow, para que los demás jobs sigan siendo de solo lectura.
Solución 2: revise el valor predeterminado de la organización y del repositorio
En Settings, Actions, General, "Workflow permissions" puede estar en "Read repository contents and packages permissions" (solo lectura). Un propietario de la organización puede imponer esto a todos los repositorios. Un bloque permissions: en el workflow puede elevarlo, salvo que la configuración de la organización lo impida. Si el bloque no tiene efecto, consulte a un propietario.
Solución 3: el push está bloqueado por una regla de rama
Una rama protegida que exige pull requests, revisiones o comprobaciones de estado también rechaza un push directo del bot, con un mensaje distinto como GH006: Protected branch update failed. Por defecto, el bot no puede saltarse la regla. Las opciones son hacer push a una rama nueva y abrir un pull request, o añadir la app o el bot a la lista de omisiones del ruleset si su plan lo permite.
- uses: peter-evans/create-pull-request@v7
with:
branch: auto/changelog
title: Update changelog
Esa acción necesita contents: write y pull-requests: write, y que esté activada la opción del repositorio "Allow GitHub Actions to create and approve pull requests".
Solución 4: los forks no pueden hacer push
En los workflows activados desde un pull request abierto desde un fork, el token es de solo lectura y ninguna configuración de permisos lo cambia. El workflow no puede hacer push a la rama del fork. Realice el paso de escritura desde un workflow aparte activado por workflow_run, o pida a los colaboradores que ejecuten el formateador en local.
Solución 5: el workflow quiere hacer push y activar más workflows
Un push realizado con GITHUB_TOKEN no inicia otras ejecuciones de workflows, algo que GitHub hace para evitar bucles. Si un commit o una etiqueta enviados deben activar un workflow, haga el push con un token de una GitHub App o con un personal access token.
Solución 6: hacer push de una etiqueta o editar archivos de workflow
Hacer push de una etiqueta también necesita contents: write. Modificar un archivo en .github/workflows no es posible con GITHUB_TOKEN, consulte refusing to allow a GitHub App to update workflow.
Cómo prevenirlo
- Mantenga los permisos predeterminados en solo lectura y añada
contents: writesolo al job que hace el push. - Tenga en cuenta las reglas de rama: haga push a una rama y abra un pull request en lugar de hacer push a
main. - Use un token de GitHub App cuando un push deba activar un workflow posterior.
- Pruebe el workflow en una rama antes de depender de él para las publicaciones.
Preguntas frecuentes
¿Por qué el bot puede leer pero no escribir?
Los repositorios y organizaciones más recientes establecen el GITHUB_TOKEN como solo lectura por defecto, por seguridad. Usted habilita la escritura job por job.
¿Es lo mismo que "Resource not accessible by integration"?
Tiene la misma causa (falta un permiso del token), pero se manifiesta a través de git en lugar de la API. Consulte Resource not accessible by integration.
¿persist-credentials: false rompe esto?
Sí. Con esa opción, el token no se conserva para los comandos git posteriores, así que git push no tiene con qué autenticarse. Déjela en el valor predeterminado en los jobs que hacen push, o pase el token explícitamente.
¿Puedo hacer push desde un workflow programado?
Sí, con contents: write. Los workflows programados se ejecutan en la rama predeterminada, por lo que las reglas de ramas protegidas siguen aplicándose.
Relacionado
- Permission Denied (publickey) en GitHub Actions: soluciónCorrija "git@github.com: Permission denied (publickey)" en GitHub Actions: añada una clave SSH o de despliegue, o use un token HTTPS en repos privados.
- Rechazo de GitHub App para actualizar el flujo: soluciónCorrija «refusing to allow a GitHub App to create or update workflow without workflows permission» con un PAT o token de App con permiso de escritura.
- Cache Service Responded With 429: Cómo solucionarloSolucione "Failed to restore: Cache service responded with 429" en GitHub Actions: demasiadas solicitudes de caché. Actualice actions/cache y restaure y guarde una vez.
- fatal: could not read Username for github.com: SoluciónSolucione "fatal: could not read Username for 'https://github.com'" en GitHub Actions: repos privados, submódulos y dependencias git necesitan un token.