138% más CVE notificadas al día en 2026 que el año pasado.Novedad: Fixboxes siempre activas. Dependencias vulnerables, corregidas y verificadas.

Seguridad de CI/CD

Seguridad en GitHub Actions: checklist para bastionar sus workflows

Un workflow de GitHub Actions ejecuta código de muchos autores con el token de su repositorio, sus secretos y una vía hacia producción. La mayoría de los controles que lo mantienen seguro vienen integrados en GitHub, pero por defecto están desactivados, son laxos o es fácil configurarlos mal. Esta checklist los recorre uno a uno: qué configurar, por qué importa y el incidente que muestra lo que ocurre sin ellos.

Actualizado el

La checklist de un vistazo

Elemento Qué evita
GITHUB_TOKEN con privilegios mínimos Que un paso secuestrado suba código, publique versiones o lance otros workflows
Fijar o bloquear las acciones de terceros Que una etiqueta movida ejecute el código de un atacante en su job
Tratar pull_request_target y workflow_run como privilegiados Pwn requests: código de un fork que se ejecuta con sus secretos
Mantener los datos de eventos fuera de los scripts run Inyección de scripts a través de títulos, nombres de rama y comentarios
OIDC en lugar de claves de nube almacenadas Credenciales de larga duración que siguen funcionando años después de filtrarse
Entornos con revisores obligatorios Que cualquier rama o workflow lea los secretos de producción
Code owners en .github/workflows Cambios sin revisar en lo que ejecuta el pipeline
Política de acciones permitidas Acciones desconocidas o sin fijar en cualquier parte de la organización
Nada de runners autoalojados en repositorios públicos Que desconocidos ejecuten código en sus máquinas
Higiene de cachés y artefactos Cachés envenenadas y tokens que se filtran a través de las subidas
Control de egress en los runners Que los secretos robados se envíen al servidor de un atacante
Un registro de cada ejecución No saber qué builds ejecutaron una acción o un paquete comprometidos

Código de los workflows

1. Dé a GITHUB_TOKEN los privilegios mínimos

Cada job recibe un GITHUB_TOKEN, y cualquier paso del job puede usarlo. Los repositorios y las organizaciones creados antes de febrero de 2023 pueden seguir teniendo por defecto lectura y escritura en todos los permisos. Establezca por defecto solo lectura en Settings → Actions → General → Workflow permissions y conceda escritura por job:

permissions:
  contents: read

jobs:
  release:
    runs-on: ubuntu-latest
    permissions:
      contents: write
    steps:
      - uses: actions/checkout@<full-commit-sha>

Todo lo que no incluya pasa a none. Para cada permiso y lo que necesitan las tareas habituales, consulte Permisos de GITHUB_TOKEN: privilegios mínimos para cada workflow.

2. Fije las acciones de terceros a un commit, o bloquéelas

Una etiqueta como @v4 es un puntero que el propietario de la acción, o cualquiera que le robe el acceso, puede mover. Dos incidentes muestran lo que eso significa:

  • tj-actions/changed-files, marzo de 2025. Un atacante modificó etiquetas de versión existentes para que apuntaran a un commit malicioso (CVE-2025-30066). La acción la usaban más de 23.000 repositorios, y la carga maliciosa volcaba secretos de la memoria del runner en los logs del workflow, que cualquiera puede leer en un repositorio público.
  • aquasecurity/trivy-action, marzo de 2026. El aviso de Aqua Security (CVE-2026-33634) indica que 76 de las 77 etiquetas de versión de la acción se forzaron a commits maliciosos. El código inyectado se ejecutaba antes del escaneo real, leía secretos de la memoria del runner y los enviaba, cifrados, a la infraestructura del atacante.

Los workflows que referenciaban un SHA de commit completo siguieron ejecutando el mismo código que antes. Conserve la versión como comentario:

steps:
  # Mutable: whoever controls the tag decides what runs
  - uses: tj-actions/changed-files@v45
  # Immutable: a full commit SHA, with the version as a comment
  - uses: tj-actions/changed-files@<full-commit-sha> # v46.0.1

Compruebe que el SHA procede del repositorio de la propia acción, no de un fork. GitHub ofrece ahora algo más sólido: los lockfiles de dependencias de workflows, disponibles de forma general desde el 28 de octubre de 2026. La extensión de CLI gh actions-lock escribe .github/workflows/actions.lock, que registra el commit exacto de cada acción que usan sus workflows, incluidas las acciones a las que llaman esas acciones, y GitHub comprueba en tiempo de ejecución que cada repositorio de origen sigue siendo el que usted bloqueó. Las llamadas a workflows reutilizables no están cubiertas, así que fíjelas por SHA. Los administradores pueden exigir un lockfile mediante una política. Ni la fijación ni un lockfile hacen segura una acción: revise lo que bloquea.

Las acciones fijadas no se actualizan solas. Deje que Dependabot proponga actualizaciones, con un periodo de espera para que una nueva versión tenga unos días para detectarse antes de llegar a usted:

# .github/dependabot.yml
version: 2
updates:
  - package-ecosystem: "github-actions"
    directory: "/"
    schedule:
      interval: "weekly"
    cooldown:
      default-days: 7

3. Trate pull_request_target y workflow_run como privilegiados

Un workflow pull_request lanzado desde un fork recibe un token de solo lectura y ningún secreto. Un workflow pull_request_target se ejecuta en el contexto del repositorio base, con sus secretos y un token que puede escribir, incluso cuando la pull request procede de un fork. Eso solo es seguro mientras el workflow no ejecute nunca código de la pull request. Si hace checkout del head de la pull request y lo compila, cada script de instalación y cada test de esa pull request se ejecutan con sus secretos. GitHub Security Lab los llama pwn requests.

  • Use pull_request para todo lo que compile o pruebe código aportado por terceros.
  • Si después debe venir un paso privilegiado, como comentar en la pull request, divídalo: un workflow pull_request sin privilegios sube sus resultados como artefacto, y un workflow workflow_run actúa sobre ellos. Trate esos artefactos como entrada no fiable, nunca como código que ejecutar.
  • En los repositorios públicos sin una política de eventos, GitHub bloquea pull_request_target por defecto a partir del 2 de diciembre de 2026. Si vuelve a permitirlo, permítalo solo en los workflows que lo necesiten.

El compromiso de TanStack en mayo de 2026 empezó así: un workflow pull_request_target ejecutó código de un fork, que envenenó la caché que un workflow de publicación restauró después, y un token OIDC leído de la memoria del runner se usó para publicar 84 versiones maliciosas de 42 paquetes.

4. Mantenga los datos de eventos fuera de los scripts run

Las expresiones se expanden antes de que se ejecute el shell, así que el título de una pull request, el nombre de una rama, el cuerpo de una issue o un mensaje de commit dentro de run pasan a formar parte del script. Cualquiera que pueda abrir una pull request o una issue puede entonces ejecutar comandos en su job. Pase el valor a través de una variable de entorno, para que el shell lo trate como datos:

# Vulnerable: the title is pasted into the script before the shell runs
- run: echo "Checking ${{ github.event.pull_request.title }}"

# Safe: the shell reads the title as data
- env:
    PR_TITLE: ${{ github.event.pull_request.title }}
  run: echo "Checking $PR_TITLE"

Lo mismo se aplica a actions/github-script y a los valores que se escriben en GITHUB_ENV. Los agentes de IA en los workflows añaden una nueva forma del mismo problema: el texto de una issue puede dirigir al agente en lugar del shell. Consulte prompt injection.

Secretos y despliegues

5. Use OIDC en lugar de claves de nube de larga duración

Una clave de acceso a la nube almacenada como secreto funciona hasta que alguien la rota, lo que tras una filtración suele ser demasiado tarde. Con OpenID Connect, el job pide a GitHub un token de corta duración y lo intercambia con AWS, Azure o Google Cloud, cuya política de confianza decide qué repositorio, rama o entorno puede asumir el rol:

jobs:
  deploy:
    runs-on: ubuntu-latest
    environment: production
    permissions:
      contents: read
      id-token: write
    steps:
      - uses: aws-actions/configure-aws-credentials@<full-commit-sha>
        with:
          role-to-assume: arn:aws:iam::123456789012:role/deploy
          aws-region: us-east-1

Un token de corta duración todavía puede robarse de un job en ejecución, como demostró TanStack, pero vale mucho menos que una clave que nunca caduca. Pase los secretos que conserve al paso que los necesita y no al job entero, para que otras acciones del job no puedan leerlos. Cómo se filtran los secretos y el resto de los controles se explican en Secretos de GitHub Actions: cómo se filtran y cómo protegerlos.

6. Proteja producción con entornos y revisores obligatorios

Un entorno tiene sus propios secretos, y un job que lo nombra no puede leerlos hasta que un revisor obligatorio aprueba la ejecución. Las reglas de ramas de despliegue limitan qué ramas pueden usarlo. Un workflow en una rama de funcionalidad, o uno lanzado por una pull request, no tiene entonces ninguna vía hacia las credenciales de producción.

Gobernanza

7. Exija la revisión de code owners para los archivos de workflow

Un archivo de workflow decide qué se ejecuta con sus secretos, así que un cambio en él merece la misma revisión que un cambio en el acceso a producción. Añada la carpeta a CODEOWNERS y exija la revisión de code owners en un ruleset de rama:

/.github/workflows/ @example-org/platform-security
/.github/actions/ @example-org/platform-security

8. Restrinja qué acciones pueden ejecutarse

A nivel de empresa, organización o repositorio, la política de acciones permitidas puede limitar las acciones a las de GitHub, las de creadores verificados o las de una lista que usted mantenga. Desde agosto de 2025 también puede exigir la fijación por SHA, de modo que falle un workflow que use una acción sin fijar, y bloquear una acción o versión concreta con una entrada !, lo que ayuda el día en que se informa de que una acción que usa está comprometida.

Runners, cachés y artefactos

9. Mantenga los runners autoalojados fuera de los repositorios públicos

La referencia de uso seguro de GitHub indica que los runners autoalojados casi nunca deberían usarse en repositorios públicos, porque cualquiera puede abrir una pull request y ejecutar código en ellos. En los repositorios privados, use runners que arranquen desde cero en cada job: un runner de larga duración conserva lo que un job deja atrás para el siguiente, puerta trasera incluida. El gusano de npm Shai-Hulud registraba las máquinas infectadas como runners autoalojados precisamente por eso. Consulte runners gestionados frente a autoalojados.

10. Proteja las cachés del envenenamiento

Las cachés se delimitan por rama, y las cachés guardadas en la rama por defecto pueden restaurarse desde cualquier otra rama. Por tanto, el código que se ejecuta en cualquier workflow de la rama por defecto puede escribir entradas de caché que un workflow de publicación restaurará más tarde, sin necesidad de un token de escritura. Mantenga el código no fiable fuera de los workflows de la rama por defecto, evite restaurar cachés en los jobs de publicación y de lanzamiento y, en ellos, compile a partir de un lockfile. Consulte cómo funciona la caché de GitHub Actions.

11. Trate los artefactos como no fiables

actions/checkout guarda el token en disco para comandos git posteriores, salvo que lo desactive. Subir el espacio de trabajo como artefacto ha filtrado ese token en el pasado. Establezca persist-credentials: false en los checkouts que no hacen push, suba solo las rutas que necesite y no ejecute nunca un artefacto procedente de una pull request en un workflow privilegiado:

- uses: actions/checkout@<full-commit-sha>
  with:
    persist-credentials: false

Red y registros

12. Controle a dónde pueden conectarse los jobs

Los runners alojados en GitHub no restringen el tráfico saliente, así que el código de un job puede enviar lo que lee a cualquier parte. La mayoría de los jobs necesitan una lista corta de destinos: registros de paquetes, registros de contenedores, hosts de código fuente y algunas API. Permita esos y bloquee el resto, y un secreto robado no tendrá a dónde ir, incluso en un ataque que nadie ha visto antes. Una política de egress no detiene los secretos impresos en los logs, como en el caso de tj-actions, y por eso va junto a la fijación, no en su lugar. Consulte cómo una política de egress detiene la exfiltración desde GitHub Actions.

13. Registre qué acciones y paquetes usó cada ejecución

Cuando se anuncie la próxima acción o el próximo paquete comprometido, la primera pregunta será cuáles de sus ejecuciones lo usaron. Un archivo de workflow dice lo que una ejecución debía usar. Una etiqueta, un rango de versiones o un acierto de caché pueden cambiar la respuesta, y el registro que la resuelve es el que se toma mientras se ejecuta el job: el commit de cada acción, cada paquete descargado o restaurado desde una caché y las conexiones que hizo el job. Consulte SBOM en GitHub Actions.

Herramientas gratuitas que auditan sus workflows

La mayoría de los elementos de workflow anteriores pueden comprobarse automáticamente. Estas herramientas leen los archivos de workflow; no observan un job mientras se ejecuta.

Herramienta Qué comprueba
zizmor Análisis estático de la configuración de GitHub Actions, Dependabot y pre-commit: inyección de plantillas, disparadores peligrosos, permisos excesivos, acciones sin fijar, commits impostores, envenenamiento de caché y credenciales que deja el checkout
actionlint Un linter de sintaxis y expresiones de workflows que también señala valores no fiables usados en scripts en línea y ejecuta shellcheck en los pasos run
OpenSSF Scorecard Comprobaciones de repositorio como Dangerous-Workflow (checkouts no fiables e inyección de scripts), Token-Permissions y Pinned-Dependencies
poutine El escáner de código abierto de BoostSecurity para pipelines de build, que cubre GitHub Actions, GitLab, Azure DevOps y Tekton, y puede escanear todos los repositorios de una organización
CodeQL El code scanning de GitHub, que analiza los workflows en busca de patrones de inyección y de pwn requests desde 2025

Ejecute una de ellas en las pull requests que toquen .github/. Para ver cómo encajan con los controles del runner y las herramientas de postura, consulte comparativa de herramientas de seguridad de CI/CD y seguridad de CI/CD. Para una checklist que cubre todo el pipeline y no solo la configuración de GitHub Actions, consulte la checklist de seguridad del pipeline de CI/CD.

Cómo ayuda CRACI

CRACI sustituye al runner, no a GitHub Actions: usted cambia runs-on a craci, y los workflows, los secretos, los permisos del token y el historial de ejecuciones se quedan en GitHub. Cubre los últimos elementos de esta lista, los que ocurren mientras se ejecuta un job:

  • Control de egress. Una política de egress decide a qué fuentes de paquetes, registros y hosts puede llegar un job. Se valida antes de que empiece el job, se aplica en el runner y falla en modo cerrado, y una conexión bloqueada genera una alerta.
  • Un registro de cada ejecución. La SBOM del job enumera las GitHub Actions que ejecutó como componentes pkg:github fijados al commit utilizado, y cada paquete que descargó, incluidos los paquetes restaurados desde una caché, con una traza de sus conexiones de red. Cuando se mueven las etiquetas de una acción, puede ver qué commit ejecutó realmente cada ejecución.
  • Políticas de bloqueo. Un build que incorpore un paquete con una vulnerabilidad conocida, incluido un CVE concreto, puede detenerse.
  • Aislamiento. Cada job se ejecuta en su propia máquina virtual, así que nada pasa al siguiente.

CRACI no audita sus archivos de workflow ni escanea código fuente ni secretos, así que conserve un linter de workflows como zizmor, el secret scanning de GitHub y su herramienta SAST para eso. Ejecuta jobs de GitHub Actions en Linux, y otros sistemas de CI están en la hoja de ruta.

Seguridad en GitHub Actions: preguntas frecuentes

¿Cómo se protege GitHub Actions?

Establezca GITHUB_TOKEN en solo lectura y conceda escritura por job, fije o bloquee las acciones de terceros, evite ejecutar código de pull requests en workflows pull_request_target, pase los datos de eventos a los scripts mediante variables de entorno, use OIDC en lugar de claves de nube almacenadas, proteja los secretos de producción con entornos, exija la revisión de los archivos de workflow y controle a qué pueden conectarse los jobs.

¿Debo fijar las GitHub Actions a un SHA de commit?

Sí, en las acciones de terceros. Una etiqueta puede moverse a otro código, como ocurrió con tj-actions/changed-files en 2025 y con trivy-action en 2026, mientras que un SHA de commit completo no. Los lockfiles de workflows de GitHub van más allá y bloquean también las acciones a las que llaman sus acciones.

¿Es peligroso pull_request_target?

Solo es seguro si el workflow no ejecuta nunca código de la pull request. Se ejecuta con los secretos del repositorio base y un token de escritura incluso para los forks, así que compilar en él código de un fork entrega ambos a quien abrió la pull request. A partir del 2 de diciembre de 2026, GitHub lo bloquea por defecto en los repositorios públicos sin política de eventos.

¿Qué es una pwn request?

El nombre que da GitHub Security Lab a un workflow privilegiado, normalmente lanzado por pull_request_target, que hace checkout de código no fiable de una pull request y lo ejecuta, lo que da a su autor acceso a los secretos y al token del workflow.

¿Son mejores los lockfiles de workflows que la fijación por SHA?

Son más sólidos. Un lockfile registra el commit de cada acción que usa un workflow, incluidas las transitivas, y GitHub comprueba la identidad del repositorio de origen en tiempo de ejecución. Las llamadas a workflows reutilizables no están cubiertas, así que fíjelas por SHA.

¿Qué herramientas gratuitas comprueban la seguridad de los workflows de GitHub Actions?

zizmor, actionlint, OpenSSF Scorecard y poutine son gratuitas, y CodeQL puede analizar workflows como parte del code scanning de GitHub. Leen los archivos de workflow; no controlan lo que hace un job mientras se ejecuta.

Vea lo que ejecutó realmente uno de sus workflows

Ejecute un job de GitHub Actions en CRACI y obtenga el commit de cada acción, cada paquete descargado y una política de egress que falla en modo cerrado.

Reservar una demo