← Volver al blog de ciberseguridad

Seguridad de GitHub Actions: lockfiles, pull_request_target, permisos del token y detección

Por Thilina Manana · COO, Director Técnico de Seguridad hard2bit y socio fundador · Publicado: 16 de noviembre de 2026 · Actualizado: 16 de noviembre de 2026
Seguridad de GitHub Actions

El 14 de marzo de 2025 alguien movió la mayoría de las etiquetas de versión de la acción tj-actions/changed-files para que apuntaran a un commit con un script que volcaba los secretos de cada ejecución en el registro de compilación. La acción se usaba en más de 23.000 repositorios, según SecurityWeek, que recoge la investigación de StepSecurity. Los repositorios afectados no tuvieron que tocar sus flujos de trabajo para quedar expuestos: era suficiente con referenciar la acción por etiqueta.

El caso de tj-actions, el gusano Shai-Hulud (que registraba como runner autoalojado la máquina comprometida del desarrollador) y las oleadas de flujos falsos subidos con cuentas de mantenedores robadas explotan la misma debilidad. GitHub Actions ejecuta código de terceros con las credenciales de la organización, y muchas organizaciones fijaron su configuración antes de que existieran los controles que hoy limitan ese riesgo. Entre agosto de 2025 y octubre de 2026 GitHub ha añadido el anclaje obligatorio por SHA, los ficheros de bloqueo de dependencias (lockfiles) y las protecciones de ejecución. El 2 de diciembre de 2026 bloqueará además por defecto el evento pull_request_target en los repositorios públicos de GitHub.com.

Esta guía está pensada para el responsable de plataforma o de seguridad de una empresa con una organización en GitHub.com y entre unas decenas y unos cientos de repositorios. Explica qué controla cada ajuste, qué valor poner y cómo comprobar con la API que está aplicado. La parte de detección sobre el registro de auditoría exige GitHub Enterprise Cloud, como se explica en su apartado. Los nombres técnicos citados se han comprobado con la documentación de GitHub a 16 de noviembre de 2026; GitHub Enterprise Server va por detrás en varias de estas funciones.

¿Qué se ejecuta en un flujo de trabajo y con qué credenciales?

Un flujo de trabajo de GitHub Actions es un fichero YAML en .github/workflows que GitHub ejecuta en un runner, la máquina que corre los trabajos, cuando ocurre un evento: un push, una pull request, un comentario o una tarea programada. Cada paso puede ser un script interno o una acción publicada por otro, referenciada con la sintaxis owner/repo@ref. El riesgo depende de dos cosas: de quién es el código que llega a ejecutarse y de qué credenciales dispone mientras se ejecuta.

¿Qué permisos recibe el GITHUB_TOKEN en cada ejecución?

Cada trabajo recibe un GITHUB_TOKEN de vida corta con permisos sobre el repositorio: solo lectura por defecto en las organizaciones creadas desde el 2 de febrero de 2023, y lectura y escritura en las anteriores salvo cambio manual. GitHub cambió el valor por defecto a solo lectura el 2 de febrero de 2023, pero solo para empresas y organizaciones nuevas; los repositorios nuevos toman el ajuste de su organización. Las organizaciones anteriores conservan lectura y escritura salvo que alguien lo haya cambiado a mano, y en nuestras auditorías es una de las primeras diferencias que aparecen.

A ese token se suman los secretos que el repositorio, el entorno o la organización ponen a disposición del flujo: claves de nube, credenciales de registros de paquetes, tokens personales usados como cuentas de servicio. Son identidades no humanas con privilegios efectivos, y un flujo comprometido las ve todas a la vez.

¿Por qué una etiqueta no fija la versión de una acción?

Una referencia como actions/checkout@v7 apunta a una etiqueta de git, y quien controla el repositorio de la acción puede moverla a otro commit. Es lo que ocurrió con tj-actions, y en 2026 la campaña de TeamPCP volvió a mostrar que una herramienta de seguridad usada en la canalización de compilación también puede ser la puerta. Las acciones compuestas añaden un segundo nivel: una acción puede llamar a otras, y anclar el primer nivel no fija esas dependencias transitivas. La guía de uso seguro de GitHub recomienda anclar por SHA completo y comprobar que ese SHA pertenece al repositorio de la acción y no a una bifurcación.

¿Cuándo ejecuta pull_request_target código no confiable con secretos?

Cuando el flujo descarga el código de la pull request y lo compila, lo prueba o lo instala con el token y los secretos del repositorio base. El evento pull_request_target existe para automatizar tareas sobre pull requests que llegan desde bifurcaciones, como etiquetar o clasificar. Se ejecuta en el contexto del repositorio base, con su token y sus secretos. Por defecto toma el flujo y el código de la rama principal, de modo que no ejecuta código de la bifurcación. La documentación de GitHub sobre pull_request_target llama a ese patrón pwn request y advierte de que workflow_run e issue_comment pueden reproducirlo.

La inyección de órdenes es la variante sin descarga: un título de pull request, el nombre de una rama o el cuerpo de un comentario se interpolan con una expresión ${{ }} dentro de un script de shell, y el texto controlado por un tercero acaba ejecutándose. GitHub recomienda pasar esos valores a través de variables de entorno en lugar de interpolarlos, y tratar como no confiables los artefactos y la caché que llegan de otros flujos.

¿Cómo pueden filtrar el token los runners autoalojados y los artefactos?

Un runner que sobrevive al trabajo permite persistencia, y un artefacto con la configuración de git puede llevarse el token. Los runners alojados por GitHub se destruyen al terminar cada trabajo. Un runner autoalojado puede no hacerlo, y GitHub advierte de que casi nunca deben usarse en repositorios públicos, porque un tercero puede abrir una pull request y comprometer la máquina de forma persistente.

Registrar la máquina comprometida del desarrollador como runner autoalojado en un repositorio controlado por el gusano fue una de las técnicas de Shai-Hulud que Elastic convirtió en regla de detección. La variante que analizamos en el gusano de npm que abusaba de los hooks de Claude Code siguió la misma lógica de saltar del paquete a la canalización.

Palo Alto Unit 42 documentó en 2024 con ArtiPACKED otra fuga discreta: actions/checkout guardaba el token en la configuración local de git, y si el flujo subía como artefacto el directorio completo, el token viajaba dentro. Desde la versión 6, según el README de actions/checkout, las credenciales se guardan en un fichero aparte bajo $RUNNER_TEMP, lo que cierra esa vía de fuga; los flujos anclados a versiones anteriores pueden seguir expuestos si suben el directorio como artefacto. Además, upload-artifact excluye por defecto los ficheros ocultos desde la versión 4.4.0.

¿Dónde queda el rastro de un flujo comprometido?

En el registro de auditoría de la organización, que anota los cambios de configuración y de secretos. También deja constancia de las altas de runners y de los rechazos de escritura que aplica la plataforma. GitHub conserva 180 días de eventos, y solo siete días los eventos de git. Lo que no recoge es qué hizo cada paso por dentro: para eso se necesitan los registros de ejecución del flujo y, en runners autoalojados, la telemetría del equipo.

¿Cuáles son los controles prioritarios en una organización mediana?

Los de prioridad inmediata son el token en solo lectura y la restricción de runners; después vienen el lockfile, el anclaje por SHA y la aprobación de bifurcaciones. La tabla resume los que tienen efecto a nivel de organización; la última columna da la prioridad orientativa.

Matriz de decisión de controles de GitHub Actions para una organización
ControlQué cortaFricción al implantarloLímite conocidoPrioridad
Token por defecto en solo lecturaEscrituras en el repositorio con el token de un flujo comprometidoBaja a media: fallan los flujos que publican o comentan sin declarar permisosNo protege los secretos ni impide que un flujo pida más permisosInmediata, tras inventario
Runners autoalojados solo en repositorios elegidosPersistencia en máquinas de la empresa desde repositorios públicosBaja si hay pocos runners; deja sin runner a los repositorios no incluidosSolo cubre runners de repositorio; los de organización se limitan con grupos de runners. No endurece el runnerInmediata
Aprobación de ejecuciones de colaboradores externosEjecución automática de código de bifurcacionesMedia en proyectos abiertos con muchas contribucionesCon las opciones de primera contribución, quien ya contribuyó no pasa por aprobación; no aplica a pull_request_targetAlta
Anclaje obligatorio por SHAEtiquetas movidas en acciones de tercerosMedia: los flujos sin anclar fallanNo fija dependencias transitivas ni flujos reutilizables referenciados por etiquetaAlta
Lockfile con Require lockfileEtiquetas movidas y dependencias transitivasMedia: herramienta nueva en el ciclo de cambiosLas dependencias de flujos reutilizables dependen del lockfile de su repositorio; no juzga si la acción es seguraAlta en repositorios que despliegan
Lista de acciones permitidas y bloqueadasAcciones desconocidas o con versiones retiradasAlta al principio por el inventarioRequiere mantenimiento continuoMedia
Política de eventos y pull_request_targetPwn requests desde bifurcacionesBaja en repositorios privadosEl bloqueo por defecto solo aplica a repositorios públicosAlta en repositorios públicos
OIDC con condiciones por entornoClaves de nube de larga duración guardadas como secretosMedia: cambio en la nube de destinoUna condición laxa abre la confianza a otros repositoriosAlta donde hay despliegue
CODEOWNERS sobre .github/workflowsCambios en flujos sin revisiónBajaDepende de que la protección de rama obligue a la revisión; controla la fusión, no la ejecución de ramas con acceso a secretosMedia

Prioridad orientativa para una organización de decenas o pocos cientos de repositorios. Fuentes: documentación y changelog de GitHub consultados el 16 de noviembre de 2026.

El anclaje por SHA y el lockfile resuelven el mismo problema con alcance distinto. El SHA en el fichero del flujo fija el primer nivel y es visible en la revisión; el lockfile fija también las dependencias transitivas y según GitHub hace innecesario el anclaje en los repositorios que lo adoptan. Para una organización que empieza hoy, el lockfile es la opción más completa en los repositorios que manejan credenciales de producción, y el anclaje por SHA sirve como red de seguridad en el resto.

¿Cómo se implanta y comprueba cada ajuste con la API?

Todos los ajustes de esta sección se pueden leer con la API REST de permisos de Actions. Leerlos con gh api desde una cuenta con permisos de administración de la organización deja una evidencia fechada que vale tanto para el equipo como para un auditor. En los ejemplos, ORG corresponde al nombre de la organización.

¿Qué valor debe tener el permiso por defecto del GITHUB_TOKEN?

En la configuración de Actions de la organización, el permiso por defecto del flujo debe quedar en lectura y la casilla que permite a Actions crear y aprobar pull requests, desactivada. En la API son los campos default_workflow_permissions y can_approve_pull_request_reviews. Antes del cambio hay que localizar los flujos que publican versiones, comentan o hacen push sin declarar permisos, porque dejarán de funcionar.

# Permisos por defecto del token en la organización.
# Valor esperado: default_workflow_permissions "read" y can_approve_pull_request_reviews false.
gh api /orgs/ORG/actions/permissions/workflow
# El mismo ajuste puede fijarse por repositorio; se revisa en cada uno.
gh api /repos/ORG/REPO/actions/permissions/workflow

En cada flujo hay que declarar los permisos de forma explícita. El patrón más limpio deja el flujo sin permisos y concede a cada trabajo solo lo que usa. Un valor por defecto en lectura no impide que un flujo pida permissions: write-all, de modo que la revisión de los YAML sigue siendo necesaria:

# A nivel de flujo: ningún permiso por defecto.
permissions: {}
# Por trabajo, solo lo que usa cada uno (fragmento sin runs-on ni steps).
jobs: {build: {permissions: {contents: read}}, deploy: {permissions: {contents: read, id-token: write}}}

¿Cómo se obliga a anclar por SHA y se bloquea una acción?

Desde agosto de 2025 la política de acciones permitidas admite dos ajustes nuevos. Una casilla obliga a anclar por SHA completo, y todo flujo que use una acción sin anclar falla; el prefijo "!" bloquea una acción o una versión determinada. Los flujos reutilizables pueden seguir referenciándose por etiqueta. La lista de bloqueo se evalúa al final y prevalece sobre las reglas de autorización. Ante una acción comprometida, bloquearla en la organización corta su uso en todos los repositorios a la vez.

# Política de acciones de la organización.
# Valor esperado: allowed_actions "selected" (o "local_only") y sha_pinning_required true.
gh api /orgs/ORG/actions/permissions

Activar la casilla, o pasar a una lista de acciones permitidas, sin inventario previo rompe los flujos que todavía usan etiquetas o acciones no listadas. Antes de hacerlo, un análisis estático como zizmor lista las referencias sin anclar, los permisos excesivos y los disparadores peligrosos de los flujos de cada repositorio sin ejecutar código; para cubrir la organización hay que recorrer sus repositorios.

¿Para qué sirve el lockfile de dependencias de flujos?

Fija el commit de cada acción, incluidas las transitivas, y GitHub lo verifica en cada ejecución. Los lockfiles se publicaron en versión preliminar el 14 de octubre y son de disponibilidad general desde el 28 de octubre de 2026 en los planes Free, Team y Enterprise Cloud. El fichero vive en .github/workflows/actions.lock, se genera con la extensión oficial de la CLI y no se edita a mano.

En cada ejecución, GitHub comprueba también el identificador del propietario y del repositorio de origen. Cuando Dependabot actualiza una acción en un flujo ya registrado en el lockfile, regenera su entrada en la misma pull request.

# Instalar la extensión oficial y generar el lockfile de todos los flujos.
gh extension install github/gh-actions-lock
gh actions-lock
# En CI: comprobar que el lockfile sigue al día sin reescribirlo (necesita red y GH_TOKEN).
gh actions-lock --verify

Según la guía de GitHub para fijar dependencias, si la etiqueta se mueve en origen la ejecución sigue usando el commit registrado y la extensión lo señala como error para que alguien lo revise antes de aceptar el cambio. Al registrar un flujo, la extensión reescribe además las referencias a la versión exacta que resolvió (@v3 puede pasar a @v3.1.0). La lista de acciones permitidas, por su parte, pasa a compararse con el SHA registrado, así que las entradas basadas en etiquetas dejan de coincidir y deben cambiarse por comodines o por SHA completos.

La política Require lockfile se puede fijar en empresa, organización o repositorio. En modo activo bloquea las ejecuciones de los flujos afectados que no estén registrados en el lockfile; el modo de evaluación, que solo informa, existe únicamente en GitHub Enterprise. Las pruebas publicadas por Classmethod observaron que una dependencia añadida sin actualizar el fichero hace fallar la ejecución antes de arrancar ningún trabajo. Los flujos reutilizables dependen del lockfile del repositorio donde están definidos, por lo que GitHub aconseja registrar primero los repositorios de flujos compartidos.

¿Cuándo bloquea GitHub pull_request_target por defecto?

Desde el 2 de diciembre de 2026, y solo en los repositorios públicos de GitHub.com. Una política de eventos ya configurada prevalece sobre esa regla por defecto.

Las protecciones de ejecución, disponibles desde el 17 de septiembre de 2026, permiten definir en empresa, organización o repositorio quién puede disparar un flujo y con qué eventos. Cada regla se puede limitar a determinados ficheros de flujo, y una vista de Insights muestra qué se habría bloqueado. Sobre esa base, GitHub bloqueará pull_request_target por defecto el 2 de diciembre de 2026 en los repositorios públicos alojados en GitHub.com. GitHub programó antes dos ventanas de prueba, el 9 y el 16 de noviembre, de 16:00 a 18:00 UTC.

Quien lo necesite tendrá que permitirlo de forma explícita en una política de eventos, idealmente limitada al fichero de flujo que lo usa. Los repositorios privados e internos quedan fuera del bloqueo, y en nuestras auditorías es ahí donde suelen quedar flujos antiguos. Una regla de protección de ejecución definida por la organización que solo permita pull_request_target en los ficheros que lo justifican reduce la exposición a esos ficheros, que siguen necesitando revisión.

La acción actions/checkout aporta otra barrera. Según el changelog de GitHub, la versión 7 (18 de junio de 2026) y, desde el 20 de julio, las etiquetas mayores con soporte salvo v1 se niegan a descargar el código de una bifurcación en pull_request_target y en workflow_run disparado por una pull request; issue_comment queda fuera.

Los flujos anclados a un SHA, a una versión menor o a un parche sin el cambio no lo reciben, y la protección no cubre el código traído con git o con la CLI de GitHub desde un paso run. El ajuste allow-unsafe-pr-checkout: true debe revisarse siempre, porque es la forma explícita de saltarse esa barrera.

¿Quién aprueba las ejecuciones desde bifurcaciones?

Un mantenedor, cuando approval_policy lo exige; además, dos ajustes deciden qué pasa con el código que llega desde una bifurcación:

# Quién necesita aprobación para ejecutar flujos desde bifurcaciones.
# Valor recomendado en repositorios públicos: all_external_contributors.
gh api /orgs/ORG/actions/permissions/fork-pr-contributor-approval
# Bifurcaciones de repositorios privados.
# Valor esperado: send_write_tokens_to_workflows false y send_secrets_and_variables false.
gh api /orgs/ORG/actions/permissions/fork-pr-workflows-private-repos

El campo approval_policy admite tres valores, de menos a más estricto: first_time_contributors_new_to_github, first_time_contributors y all_external_contributors. Con all_external_contributors, toda ejecución de un contribuidor externo espera a que un mantenedor la apruebe. En repositorios privados, la misma respuesta incluye run_workflows_from_fork_pull_requests y require_approval_for_fork_pr_workflows, que deciden si esas ejecuciones ocurren y si necesitan aprobación. La aprobación no afecta a pull_request_target, que se ejecuta igualmente.

¿En qué repositorios pueden usarse runners autoalojados?

Solo en una lista cerrada de repositorios no públicos. El ajuste de la organización decide qué repositorios pueden registrar sus runners; los runners de la organización se limitan con grupos de runners, que también hay que revisar:

# Qué repositorios pueden registrar runners a nivel de repositorio.
# Valor esperado: enabled_repositories "selected" o "none".
gh api /orgs/ORG/actions/permissions/self-hosted-runners
# Grupos de runners de la organización.
# Valor esperado: allows_public_repositories false y, donde sea posible, restricted_to_workflows true.
gh api /orgs/ORG/actions/runner-groups

La lista de repositorios autorizados debe excluir todos los públicos, y debe cruzarse con los runners que hoy están en uso para no cortar ninguno por sorpresa. En los repositorios autorizados, la configuración efímera, que destruye el runner tras cada trabajo, un agente EDR en la máquina y la vigilancia de sus conexiones salientes aportan la visibilidad que falta en el registro de auditoría. Si el runner tiene acceso a la red interna, debe tratarse como un servidor expuesto más.

¿Por qué sustituir las credenciales de nube por OIDC?

Las credenciales de nube de larga duración guardadas como secretos son el botín habitual de estos ataques. Con OpenID Connect el flujo pide en cada ejecución un token firmado por GitHub y lo cambia por credenciales temporales en la nube de destino. El trabajo necesita id-token: write, y la referencia de OIDC de GitHub exige definir al menos una condición en la relación de confianza para que repositorios ajenos no puedan pedir tokens, además de comprobar la audiencia (aud). La condición más útil liga la confianza a un entorno, con el formato por defecto de la reclamación sub (si la organización lo personalizó, el formato cambia):

# Condición sobre la reclamación sub en la relación de confianza de la nube.
# Solo acepta tokens del entorno produccion de un único repositorio.
repo:mi-org/mi-repo:environment:produccion

El entorno tiene que estar protegido para que la condición sirva de algo. Según la referencia de entornos, con revisores obligatorios un trabajo no accede a los secretos del entorno hasta que uno de ellos lo aprueba. La opción de impedir la autoaprobación y la restricción de ramas de despliegue a "Selected branches and tags" evitan que un flujo lanzado desde una rama no autorizada llegue a esa aprobación.

Sin Enterprise Cloud, los revisores obligatorios solo protegen repositorios públicos; además, los administradores pueden saltarse las reglas del entorno salvo que se desactive esa opción, activa por defecto. Para el checkout, persist-credentials: false evita que el token quede en disco, al alcance de pasos posteriores o de artefactos:

# Paso de checkout anclado y sin dejar las credenciales a disposición de otros pasos.
- { uses: actions/checkout@SHA-COMPLETO, with: { persist-credentials: false } }

Un inventario de qué secretos existen, quién los usa y cuándo se rotaron es el punto de partida que describimos en la guía sobre identidades no humanas, cuentas de servicio y tokens.

Los secretos de organización deben limitarse a los repositorios que los usan, y en los flujos reutilizables es preferible pasar cada secreto de forma explícita en lugar de usar secrets: inherit.

¿Quién revisa los cambios en .github/workflows?

Añadir .github/workflows/ al fichero CODEOWNERS y exigir la revisión de propietarios de código en la protección de la rama principal impide que un cambio en un flujo entre sin que lo vea alguien de plataforma o de seguridad. Sin la exigencia en la regla de protección, CODEOWNERS solo asigna revisores y no bloquea la fusión.

Aun así, controla lo que se fusiona, no lo que se ejecuta: quien tiene escritura puede subir una rama cuyo flujo lea los secretos de repositorio y de organización. Por eso las credenciales de despliegue deben ir en secretos de entorno limitados a ramas seleccionadas, y la regla de CODEOWNERS debe cubrir todo .github/, incluidos CODEOWNERS y actions.lock. Los conjuntos de reglas (rulesets) de la organización aplican la misma exigencia a todos los repositorios sin excepciones.

¿Con qué consultas se detecta un abuso en el registro de auditoría?

Con cuatro consultas KQL para Microsoft Sentinel y una regla Sigma, que exigen GitHub Enterprise Cloud. Las consultas siguientes están escritas para Microsoft Sentinel sobre la tabla GitHubAuditLogsV2_CL, que alimenta el conector de registro de auditoría de GitHub Enterprise basado en Codeless Connector Framework (CCF). Según la ficha del conector, requiere GitHub Enterprise Cloud, funciona a nivel de empresa y necesita un administrador de la empresa con un token clásico con el ámbito read:audit_log. Una organización en Free o Team no puede usar estas consultas tal cual: el registro se revisa desde la configuración de la organización y la detección automatizada pasa por un plan Enterprise Cloud.

Los nombres de columna (Action, Actor, Repo, ActorIp, ProgrammaticAccessType, UserAgent, Reasons) son los del esquema publicado de esa tabla, un catálogo comunitario que coincide con los ficheros oficiales del conector en el repositorio Azure-Sentinel. Si la ingesta usa otra tabla, hay que comprobar los nombres antes de activar las reglas. ActorIp solo se rellena si la empresa activa la visualización de direcciones IP en el registro.

Los eventos proceden de la lista de eventos del registro de auditoría de GitHub y de las reglas publicadas por Elastic, SigmaHQ y Panther. Antes de pasar estas consultas a producción, el método de nuestra guía de ingeniería de detección ayuda a medir qué cubren y qué se les escapa.

¿Quién cambió los permisos del token o las reglas de entorno?

La consulta lista los cambios de los últimos 30 días en el permiso por defecto del token, en las reglas de entorno, en los conjuntos de reglas y en la protección de rama.

// Cambios en permisos del token, reglas de entorno, conjuntos de reglas y protección de rama.
GitHubAuditLogsV2_CL
| where TimeGenerated > ago(30d)
| where Action endswith "set_default_workflow_permissions" or Action endswith "set_workflow_permission_can_approve_pr" or Action in ("environment.update_protection_rule", "environment.remove_protection_rule", "environment.delete", "protected_branch.policy_override", "protected_branch.destroy", "repository_ruleset.update", "repository_ruleset.destroy")
// Quién, desde dónde y con qué tipo de acceso.
| project TimeGenerated, Action, Actor, Repo, ActorIp, ProgrammaticAccessType, UserAgent
| order by TimeGenerated desc

Es una consulta de revisión periódica más que de alerta, porque una regla programada de Sentinel no mira más de 14 días atrás: cada fila debería corresponder a un cambio planificado. Los falsos positivos son los cambios legítimos de administradores; se reducen cruzando con el calendario de cambios. Un ProgrammaticAccessType no vacío en un cambio de gobernanza requiere atención, porque indica que lo hizo un token y no una persona desde la interfaz. GitHub describe los eventos de reglas de protección de entorno como cambios hechos por API, de modo que hay que comprobar en un entorno de pruebas qué registra un cambio de revisores hecho desde la web.

¿Cuándo debe alertar el alta de un runner autoalojado?

Cuando lo da de alta un actor que no ha registrado runners en los 14 días anteriores. La consulta incluye los runners JIT, que GitHub registra con otro evento:

// Actores que ya dieron de alta runners entre hace 14 días y ayer.
let conocidos = GitHubAuditLogsV2_CL
| where TimeGenerated between (ago(14d) .. ago(1d))
| where Action endswith ".register_self_hosted_runner" or Action endswith ".configure_self_hosted_jit_runner"
| distinct Actor;
// Altas ingeridas en la última hora; ejecutar cada hora con un periodo de consulta de 14 días.
GitHubAuditLogsV2_CL
| where ingestion_time() > ago(1h)
| where Action endswith ".register_self_hosted_runner" or Action endswith ".configure_self_hosted_jit_runner"
// Excluir a los actores conocidos.
| where Actor !in (conocidos)
| project TimeGenerated, Action, Actor, Repo, RunnerName, ActorIp, UserAgent

Reproduce el tipo de regla New Terms de Elastic, que alerta del primer valor nunca visto en un campo (Elastic usa cinco días de historial). El falso positivo esperado es el alta planificada de un runner por alguien de plataforma que no lo había hecho antes.

Hay dos falsos negativos claros: un token robado a un ingeniero que ya registra runners aparece como actor conocido, y un runner dado de alta en un repositorio personal no llega al registro de la organización. La lista de repositorios autorizados limita dónde puede darse de alta un runner; un cambio en esa política (org.update_repo_self_hosted_runners_policy) o en los grupos de runners requiere la misma vigilancia.

¿Por qué vigilar los secretos cambiados con un token?

Porque un cambio programático fuera de una rotación documentada apunta a robo o manipulación de credenciales.

// Secretos de Actions de repositorio, entorno u organización cambiados con un token.
GitHubAuditLogsV2_CL
| where TimeGenerated > ago(1d)
| where Action endswith "_actions_secret"
| where isnotempty(ProgrammaticAccessType)
// Agrupar por hora para ver ráfagas.
| summarize cambios = count(), acciones = make_set(Action), repos = make_set(Repo) by Actor, ActorIp, ProgrammaticAccessType, bin(TimeGenerated, 1h)

El filtro por sufijo recoge las altas, cambios y bajas de los tres niveles, incluidos repo.create_actions_secret y org.update_actions_secret, entre otros. Si hay rotación automatizada, disparará la consulta a diario y se excluye por actor y origen una vez documentada. Los cambios hechos desde la interfaz llegan sin detalles del token, por lo que el campo queda vacío.

¿Hay tokens que intentan modificar flujos sin permiso?

Lo revela el evento protected_branch.rejected_ref_update con el motivo workflow_updates.

// Rechazos por intentar crear o modificar un flujo sin el permiso workflows.
GitHubAuditLogsV2_CL
| where TimeGenerated > ago(1d)
| where Action == "protected_branch.rejected_ref_update"
| where Reasons contains "workflow_updates"
| summarize intentos = count() by Actor, Repo, bin(TimeGenerated, 1h)

Elastic usa este evento en su regla GitHub Actions Workflow Modification Blocked. El motivo workflow_updates aparece cuando un token de GitHub App, incluido el GITHUB_TOKEN, que nunca tiene ese permiso, intenta crear o cambiar un flujo: es el patrón de una automatización comprometida que quiere dejar una puerta trasera. Los falsos positivos habituales son las herramientas de actualización como Dependabot o Renovate y los scripts internos que gestionan flujos.

¿Puede escribirse la detección de runners en Sigma?

Sí: esta regla alerta de las altas en repositorio, organización o empresa.

title: Alta de runner autoalojado en GitHub
id: 753a1f66-3599-4e59-af23-707a0d83544e
status: experimental
description: Alerta cuando se registra un runner autoalojado en un repositorio, una organización o una empresa.
references: ['https://www.elastic.co/docs/reference/security/prebuilt-rules/rules/integrations/github/initial_access_github_register_self_hosted_runner']
author: Hard2bit
date: 2026-11-16
logsource: {product: github, service: audit, definition: 'Requiere el registro de auditoría de GitHub Enterprise Cloud por retransmisión o API.'}
detection: {selection: {action: ['repo.register_self_hosted_runner', 'org.register_self_hosted_runner', 'enterprise.register_self_hosted_runner']}, condition: selection}
# Falsos positivos habituales.
falsepositives: ['Altas planificadas del equipo de plataforma']
level: medium
tags: [attack.initial-access, attack.persistence, attack.t1195.002, attack.t1078.004]

SigmaHQ mantiene una regla más amplia, GitHub Self Hosted Runner Changes Detected, que cubre también bajas y cambios de grupos de runners; la regla de arriba se centra en las altas para que el volumen de alertas sea manejable, y deja fuera los runners JIT, que sin una línea base generan mucho ruido.

¿Se pueden validar las detecciones sin atacar sistemas?

Sí, reproduciendo eventos legítimos en un entorno de pruebas. La validación se hace en un repositorio privado de pruebas dentro de una organización de la misma empresa que lee el conector; si no, el evento no llega a la tabla.

Registrar un runner en una máquina desechable y retirarlo con config.sh remove genera el evento de la consulta de runners. Crear y borrar un secreto de entorno con gh secret set --env y gh secret delete alimenta la de secretos, y cambiar el permiso por defecto del token en ese repositorio y devolverlo a su valor activa la de gobernanza. Para la de flujos, un flujo de prueba con contents: write que intente subir un cambio en .github/workflows/ con el GITHUB_TOKEN genera el rechazo.

La ingesta tarda unos 15 a 30 minutos: si la alerta no salta, se comprueba primero que el evento está en la tabla y después la consulta. La consulta de runners solo salta si quien da de alta el runner no lo había hecho en los 14 días anteriores.

Para la parte preventiva, gh actions-lock --verify y zizmor en el CI, configurados como comprobación obligatoria, impiden que entre una pull request con el lockfile desfasado o con un flujo con permisos excesivos. Qué registros se envían al SIEM, junto con la retención de 180 días de GitHub, decide hasta dónde puede remontarse una investigación; lo tratamos en la guía sobre qué registros enviar al SIEM.

Falta una alerta más, la de salud de la ingesta: si GitHubAuditLogsV2_CL pasa dos horas sin filas, un token clásico caducado puede haber dejado ciegas todas las reglas anteriores.

¿Dónde se quedan cortos los controles?

Cada control deja un hueco documentado; estos son los más frecuentes.

  • Un SHA anclado puede no pertenecer a la acción: un commit de una bifurcación se resuelve con la misma ruta, y GitHub pide verificar el origen.
  • Dependabot no avisa de acciones vulnerables ancladas por SHA, según la guía de uso seguro de GitHub.
  • Un SHA de actions/checkout de una versión sin el cambio (anterior a v7 o a la retroadaptación de julio de 2026) deja fuera la negativa a descargar código de bifurcaciones; hay que actualizarlo a una versión que la incluya.
  • El lockfile no es un juicio de seguridad. GitHub advierte de que fija lo que hay sin evaluarlo, y las dependencias de los flujos reutilizables se rigen por el lockfile del repositorio que los define. Las imágenes de contenedor no se fijan y deben anclarse por digest @sha256, y un cambio del lockfile que devuelve una referencia a un commit anterior no se detecta, así que sus diferencias deben revisarse.
  • Una lista de acciones permitidas escrita con etiquetas deja de coincidir en cuanto el repositorio adopta el lockfile.
  • Del registro de auditoría no sale lo que hizo un paso. Sin registros de ejecución y sin telemetría en los runners de la empresa, una exfiltración dentro de un trabajo legítimo no deja rastro en el registro.

La mayor fricción está en el anclaje obligatorio, en la lista de acciones permitidas y en Require lockfile en modo activo: los tres hacen fallar flujos. Implantarlos por repositorio, empezando por los que despliegan en producción, evita que el primer día termine con decenas de equipos bloqueados.

¿Sirven estos ajustes como evidencia para ENS, ISO 27001 y NIS2?

Sí: las salidas de gh api fechadas, las reglas de detección activas y la configuración de las políticas sirven como evidencia en los marcos que suelen pedirse en España. La correspondencia es orientativa y debe ajustarse a la declaración de aplicabilidad de cada organización.

Correspondencia orientativa de controles de GitHub Actions con ENS, ISO 27001:2022 y NIS2
ControlENS (RD 311/2022)ISO/IEC 27001:2022 Anexo ANIS2 art. 21.2
Lockfile, anclaje por SHA y lista de accionesop.ext.3 Protección de la cadena de suministro (categoría ALTA); en MEDIA y BÁSICA, op.exp.3 Gestión de la configuración de seguridad5.21 Gestión de la seguridad de la información en la cadena de suministro de las TICLetras d) seguridad de la cadena de suministro y e) seguridad en la adquisición, desarrollo y mantenimiento
Token en solo lectura, permisos por trabajo, OIDCop.acc.2 Requisitos de acceso y op.acc.4 Proceso de gestión de derechos de acceso8.2 Derechos de acceso privilegiado, 5.18 Derechos de acceso y 8.5 Autenticación seguraLetra i) políticas de control de acceso
Políticas de la organización verificadas por APIop.exp.3 Gestión de la configuración de seguridad8.9 Gestión de la configuraciónLetra e) seguridad en la adquisición, desarrollo y mantenimiento
CODEOWNERS y revisión obligatoria de flujosop.exp.5 Gestión de cambios y op.acc.3 Segregación de funciones (no aplican en BÁSICA)8.25 Ciclo de vida de desarrollo seguro, 8.32 Gestión de cambios y 8.4 Acceso al código fuenteLetra e)
Registro de auditoría en el SIEM y consultasop.exp.8 Registro de la actividad y op.mon.3 Vigilancia8.15 Registro y 8.16 Actividades de seguimientoLetra b) gestión de incidentes

Correspondencia elaborada por Hard2bit a partir de los textos de cada marco; no sustituye a la interpretación del auditor.

La guía conjunta de la NSA y CISA sobre defensa de entornos CI/CD sirve de marco de referencia independiente del proveedor si el auditor pide justificar el modelo de amenaza. Nuestro equipo de DevSecOps trabaja estos ajustes y su evidencia, y el SOC gestionado puede operar las detecciones.

¿Cuál es el primer paso si solo hay tiempo para una cosa?

Si hay repositorios públicos, lo primero es revisar en Insights qué ejecuciones de pull_request_target bloqueará la regla del 2 de diciembre. Después empezaríamos por localizar los repositorios que guardan credenciales de producción, que en una empresa mediana suelen ser pocos, e incorporar sus flujos al lockfile con Require lockfile activo solo en ellos. Es el control que habría dejado sin efecto el patrón de tj-actions, siempre que nadie regenerase el lockfile durante la ventana del ataque. El mismo patrón se ha repetido en ataques a la cadena de suministro posteriores, y la fricción del lockfile recae sobre todo en los equipos que ya gestionan despliegues.

El token en solo lectura y la restricción de runners pueden venir después, en cuanto el inventario de flujos confirme qué se rompería: son dos cambios de configuración que se comprueban con dos llamadas a la API. Con esa base, el resto de la matriz puede implantarse repositorio a repositorio.

Fuentes y metodología: documentación y changelog oficiales de GitHub; reglas publicadas por Elastic, SigmaHQ y Panther; ficheros del conector en el repositorio Azure-Sentinel y catálogo comunitario de esquemas de Microsoft Sentinel; investigaciones de StepSecurity (vía SecurityWeek), Unit 42, Datadog Security Labs y Classmethod; y guía conjunta de la NSA y CISA sobre CI/CD. Nombres técnicos contrastados a 16 de noviembre de 2026.
Aviso: esta guía recoge ajustes y consultas de detección contrastados con la documentación pública de los fabricantes citados a 16 de noviembre de 2026. GitHub Actions cambia con frecuencia, por lo que la documentación vigente debe revisarse y las políticas probarse en un repositorio de ensayo antes de aplicar cambios; las consultas requieren adaptación al esquema del SIEM de cada organización. El contenido tiene carácter informativo y no sustituye un análisis de cada entorno, y Hard2bit no asume responsabilidad por interrupciones derivadas de aplicar estos ajustes sin esa validación previa.

Preguntas frecuentes

¿Tienen todas las organizaciones el GITHUB_TOKEN en solo lectura? ▾

No. Depende de su fecha de creación. Las organizaciones creadas desde el 2 de febrero de 2023 nacen en solo lectura; las anteriores siguen con escritura si nadie lo cambió. La comprobación es una llamada a gh api /orgs/ORG/actions/permissions/workflow, y debe repetirse por repositorio, porque el ajuste también existe a ese nivel.

¿En qué se distingue el anclaje por SHA de un lockfile? ▾

El anclaje protege la acción que aparece en el fichero; el lockfile protege el árbol completo, incluidas las acciones que esa acción llama, y verifica que el repositorio de origen sigue siendo el mismo. A cambio, las dependencias de los flujos reutilizables quedan a cargo del lockfile del repositorio que los define, y adoptarlo obliga a revisar la lista de acciones permitidas si estaba escrita con etiquetas.

¿Afecta el bloqueo de pull_request_target del 2 de diciembre a los repositorios privados? ▾

No. Se aplica a repositorios públicos alojados en GitHub.com, no a privados, internos ni a GitHub Enterprise Server. En privados el riesgo sigue si hay flujos que descargan código de bifurcaciones, y la medida recomendada es restringir el evento con una protección de ejecución a los flujos que lo necesitan. Una política de eventos ya configurada prevalece sobre la regla por defecto.

¿Qué eventos del registro de auditoría de GitHub hay que vigilar primero? ▾

Para persistencia, las altas de runners autoalojados, incluidos los JIT, en repositorio, organización o empresa. Para robo de credenciales, todo evento de secretos de Actions hecho con un token. Para manipulación de la gobernanza, los cambios en permisos por defecto del token, en reglas de entorno y los saltos de protección de rama.

¿Funcionan estas consultas en el plan Team de GitHub? ▾

No tal como están. El conector de Sentinel que alimenta GitHubAuditLogsV2_CL exige GitHub Enterprise Cloud y un administrador de la empresa con un token con read:audit_log. En Team el registro se revisa desde la configuración de la organización; los controles preventivos de la guía sí están disponibles.

¿Require lockfile puede romper flujos en producción? ▾

Sí, si se activa antes de haber registrado todos los flujos: las ejecuciones no registradas no arrancan, y solo GitHub Enterprise permite probarlo antes en modo de evaluación. En Free y Team lo recomendable es aplicarlo repositorio a repositorio tras generar y revisar el fichero, y registrar antes los repositorios de flujos reutilizables.

¿Cómo encajan estos controles en una auditoría ENS o ISO 27001? ▾

El lockfile y la lista de acciones sirven de evidencia para op.ext.3 del ENS en categoría ALTA (op.exp.3 en MEDIA y BÁSICA) y para el control 5.21 de ISO 27001:2022; los permisos del token, para op.acc.2, op.acc.4 y 8.2; la revisión obligatoria de flujos, para op.exp.5 y 8.32; el registro en el SIEM, para op.exp.8, op.mon.3, 8.15 y 8.16. Las salidas fechadas de gh api documentan la configuración.

¿Necesitas saber qué te aplica, por dónde empezar y cuánto cuesta?

Es la pregunta con la que empieza casi cualquier proyecto. La resolvemos en una reunión de 30 minutos con un consultor técnico, no con un comercial: sales con el alcance acotado, las prioridades ordenadas por riesgo y una horquilla de precio. Con la información de esa reunión, la convertimos en propuesta cerrada. Pentesting, auditoría de ciberseguridad, Microsoft 365, SOC/MDR y cumplimiento (ENS, ISO 27001, NIS2, DORA).

Si tu situación es distinta, plantéanosla igualmente: también atendemos consultas puntuales de ciberseguridad y cumplimiento normativo.

Empresa española de ciberseguridad · ENS categoría ALTA · ISO 27001 · Normalmente respondemos en menos de 24h laborables