Resource Not Accessible by Integration: Solución
Última actualización:
Resource not accessible by integration es un error HTTP 403 de la API de GitHub. Su workflow llamó a la API con el GITHUB_TOKEN, y ese token no tiene el permiso que necesita la llamada, por ejemplo, escribir un comentario en un pull request o crear una release. La solución casi siempre es un bloque permissions:, o un token distinto cuando la ejecución procede de un fork o de Dependabot.
El mensaje exacto
HttpError: Resource not accessible by integration
Error: Resource not accessible by integration
RequestError [HttpError]: Resource not accessible by integration - https://docs.github.com/rest/...
Solución 1: conceda el permiso que necesita la llamada
Revise el endpoint de la API que aparece en el error, busque qué permiso requiere en la referencia permissions for the GITHUB_TOKEN de GitHub y en la documentación del endpoint, y añádalo. Los más habituales:
| Lo que está haciendo | Permiso |
|---|---|
| Comentar en un pull request | pull-requests: write |
| Comentar o etiquetar una issue | issues: write |
| Subir commits, tags o releases | contents: write |
| Crear check runs | checks: write |
| Publicar en GitHub Packages | packages: write |
| Token OIDC para el inicio de sesión en la nube | 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.",
});
Detalle importante: en cuanto escribe un bloque permissions:, todos los permisos que no incluya se establecen en none. Añada contents: read si el job también hace checkout del código. Puede definirlo para todo el workflow o por job; por job es más seguro.
Solución 2: revise el valor predeterminado del repositorio y de la organización
En Settings, Actions, General, "Workflow permissions" se decide si el token predeterminado es de solo lectura o de lectura y escritura. Los repositorios y organizaciones más recientes usan solo lectura por defecto, y una configuración de la organización puede prevalecer sobre la del repositorio. Un bloque permissions: en el workflow funciona independientemente de ese valor, siempre que la organización no lo haya restringido.
Solución 3: pull requests de forks y de Dependabot
En los workflows activados por pull_request desde un fork, GitHub concede al GITHUB_TOKEN acceso de solo lectura y no pasa los secretos del repositorio, así que un permiso de escritura en el archivo no sirve de nada. Las ejecuciones activadas por Dependabot también reciben por defecto un token de solo lectura. Opciones:
- Realice el paso de escritura en un workflow aparte que se ejecute después del primero, usando el disparador
workflow_run, que se ejecuta en el contexto del repositorio base. - Use
pull_request_targetsolo si entiende el riesgo. Se ejecuta con acceso de escritura y secretos, y nunca debe hacer checkout ni ejecutar código del pull request. Consulte proteger GitHub Actions. - En el caso de Dependabot, defina los secretos necesarios en el almacén de secretos de Dependabot, no en el de Actions.
Solución 4: use otro token cuando el GITHUB_TOKEN no pueda hacerlo
El GITHUB_TOKEN solo tiene acceso al repositorio en el que se ejecuta el workflow. Para otro repositorio, para modificar archivos de workflow o para acciones que deban activar más ejecuciones de workflow, use un token de instalación de una GitHub App o un token de acceso personal de grano fino con los permisos exactos.
Cómo prevenirlo
- Declare
permissions:explícitamente en cada workflow y job, con el mínimo necesario. - Mantenga el valor predeterminado del repositorio en solo lectura y conceda escritura por job.
- Pruebe la automatización de pull requests desde un fork, no solo desde una rama del mismo repositorio.
- Prefiera un token de GitHub App frente a un token de acceso personal para trabajo entre repositorios.
Preguntas frecuentes
¿Por qué funciona en mi rama pero falla en un pull request desde un fork?
Los pull requests de forks se ejecutan con un token de solo lectura y sin secretos, independientemente de lo que indique el archivo. Use workflow_run para el paso de escritura.
¿Al añadir permissions: se eliminan mis otros permisos?
Sí. Cualquier permiso que no incluya pasa a none, así que enumere todo lo que necesita el job.
¿Es lo mismo que un 404 o un 401?
No. Un 403 con este mensaje significa que está autenticado pero no tiene permiso. Un 404 puede indicar un repositorio inexistente o uno que el token no puede ver. Consulte Unable to resolve action para las búsquedas de acciones.
¿Puede GITHUB_TOKEN editar archivos de workflow?
No. No se le puede conceder permiso para modificar archivos en .github/workflows. Consulte refusing to allow a GitHub App to update workflow.
Relacionado
- 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.
- Archivo de flujo de trabajo no válido: cómo solucionar el error de sintaxis YAMLCorrija "Invalid workflow file" y "You have an error in your yaml syntax" en GitHub Actions: sangría, valor inesperado, expresiones erróneas, con actionlint.
- JavaScript Heap Out of Memory en GitHub Actions: soluciónSolucione "FATAL ERROR: Reached heap limit Allocation failed - JavaScript heap out of memory" y npm ENOMEM en GitHub Actions con NODE_OPTIONS.