agent-framework: el paquete de Microsoft envenenado en PyPI

Dos versiones del paquete agent-framework de Microsoft en PyPI se ejecutaban en cada arranque de Python y robaban credenciales de Azure y CI sin importar nada.

Dos versiones del paquete oficial de Microsoft para construir agentes de IA con Python quedaron publicadas en PyPI con una carga de robo de credenciales. El mecanismo es sencillo y, precisamente por eso, uno de los más discretos que se han visto en el ecosistema de IA: un fichero .pth que se ejecuta en cada arranque del intérprete, sin que el desarrollador llegue a importar nunca el paquete.

El incidente se publicó el 17 de noviembre de 2026 y afectó a la cadena de suministro de uno de los proyectos de IA más usados del momento. agent-framework, el kit de Microsoft para crear agentes y coordinarlos en flujos de trabajo, acumula alrededor de 200.000 descargas mensuales. Las versiones 1.26.1 y 1.26.2 fueron retiradas por PyPI, aunque todavía no se conoce el número de entornos que llegaron a ejecutarlas.

Lo interesante del caso es la combinación: un framework de agentes de IA, un canal de entrega de paquetes de Python y un objetivo que es la infraestructura de CI/CD, es decir, los sistemas automatizados donde un agente de IA se ejecuta con permisos de lectura de repositorios y escritura en la nube.

Qué es agent-framework y por qué importa

agent-framework es el kit de código abierto de Microsoft para construir agentes de IA y coordinarlos en flujos de trabajo. Sobre el papel es una dependencia más o menos corriente: se instala con pip, se importa en un script y se usa para montar un agente que llama a un modelo, consulta herramientas y devuelve un resultado.

Ese carácter de dependencia corriente es justamente el problema. Un paquete con doscientas mil instalaciones mensuales es un objetivo atractivo para cualquiera que quiera entrar en los entornos de desarrollo de miles de empresas, y en un framework de este tipo hay un detalle que cambia la naturaleza del ataque: los sitios donde se instala son, con frecuencia, los mismos donde se ejecutan agentes de IA con acceso a credenciales de nube.

La cronología: dos versiones y unos minutos

Los análisis publicados por Socket, Step Security, OX Security, Aikido, Chainguard, Endor Labs y Wiz coinciden en la secuencia:

  • El atacante publica agent-framework 1.26.1 el 17 de noviembre de 2026, con una carga de robo de credenciales.
  • PyPI pone esa versión en cuarentena.
  • El atacante, que todavía conserva acceso de publicación, sube 1.26.2 con la misma carga reubicada y con objetivos adicionales.
  • PyPI pone también 1.26.2 en cuarentena, pocos minutos después.
  • Los equipos de seguridad que vigilan PyPI detectan el problema y publican el análisis técnico.

Que el atacante tuviera todavía acceso de publicación después de la primera cuarentena es el dato más incómodo del caso: significa que su capacidad sobre el proyecto no era solo una credencial robada, sino un acceso persistente. La versión limpia es la 1.26.0, que es la que siguen las dependencias legítimas.

El mecanismo: el fichero .pth

Aquí está el detalle técnico que hace el ataque especialmente traicionero. Un fichero .pth dentro de site-packages no es un módulo cualquiera: Python lo procesa durante el arranque, y cualquier línea que empiece por import se ejecuta automáticamente, sin que nadie llame a import del paquete en el código del proyecto.

La versión 1.26.1 traía un .pth con una única línea: import agent_framework_meta. Al arrancar el intérprete, se cargaba ese paquete auxiliar, cuyo inicializador añadía al final una llamada a un módulo de telemetría, envuelto en un bloque que se traga cualquier error. El módulo de telemetría comprueba una variable de entorno para no dispararse dos veces, bifurca un proceso hijo desligado de la sesión con setsid y empieza a reunir credenciales. En plataformas donde no hay bifurcación, arranca un hilo demonio.

El resultado: el programa del usuario sigue funcionando con normalidad, el framework sigue funcionando con normalidad porque las versiones maliciosas mantenían la dependencia legítima agent-framework-core 1.26.0, y nadie ve nada. No hace falta que nadie importe el paquete: instalar una dependencia basta.

Qué se llevaba exactamente

El alcance de la recogida es lo que convierte esto en un incidente grave y no en un simple ladrón de credenciales. La carga útil no robaba una sola clave: hacía un barrido sistemático de todo lo que suele haber en un entorno de desarrollo o en un agente de CI.

  • Variables de entorno cuyo nombre contiene TOKEN, SECRET, PASSWORD, KEY, AZURE, AWS, GITHUB, HF_, OPENAI, TENANT, CLIENT y otros patrones similares. No era una lista fija: la regla era por subcadena.
  • Hasta sesenta ficheros de credenciales y configuración: los perfiles de Azure en ~/.azure, la configuración de pip, el archivo .npmrc, el .netrc, las credenciales de Git, la configuración de Docker, los tokens de Hugging Face, la configuración de Foundry y los archivos .env y .json que suelen vivir en /app o /workspace.
  • El entorno de otros procesos: hasta trescientas entradas de /proc/*/environ, con los mismos filtros por subcadena.
  • Tokens de identidad de Azure DevOps: si estaban presentes las variables de acceso del pipeline y del protocolo OIDC, pedía un token para el recurso de intercambio de Azure AD, que se puede canjear por acceso a la nube.
  • Tokens de identidad administrada de Azure, solicitados al servicio de metadatos de instancia, la dirección 169.254.169.254, o al punto de identidad de App Service, para audiencias como gestión de recursos, Key Vault, Cognitive Services, Azure AI Foundry o el registro de contenedores.

En la versión 1.26.2 se añadieron las peticiones de token OIDC de GitHub Actions, con las variables que solo existen dentro de un runner, y la búsqueda en los directorios del runner. Es decir: la segunda versión no era solo una copia, era una ampliación deliberada hacia el terreno de los agentes y los pipelines.

La segunda versión: por qué movían la carga

Los dos formatos ejecutan el mismo código con dos diferencias que merecen atención, porque explican la insistencia del atacante.

La primera versión (1.26.1) usaba el par formado por el .pth y el inicializador, con el módulo de telemetría en un subdirectorio propio. La segunda (1.26.2) movió la carga a otro nombre, un .pth que importaba un módulo de nivel superior, y restauró el inicializador original del paquete byte a byte. Consecuencia práctica: una revisión que mirase solo el archivo modificado de la primera versión no encontraría nada en la segunda. El atacante estaba tapando sus propias huellas mientras el incidente se desarrollaba.

Los datos se comprimían con zlib, se codificaban en base64 y se enviaban en un POST a una URL de webhook.site, con una cabecera de agente de usuario que imitaba a una herramienta de diagnóstico. La codificación no aporta confidencialidad: es solo ofuscación frente a filtros que buscan texto plano en el tráfico.

Los indicadores de compromiso publicados son la ruta del webhook, los nombres de los ficheros instalados y las huellas de los dos paquetes. En los análisis no se describe descarga ni ejecución de código adicional: se trata de un ladrón de credenciales puro.

Lo que todavía no se sabe

Al cierre de este análisis, dos preguntas seguían sin respuesta pública. La primera es cómo se obtuvo el acceso de publicación sobre el proyecto oficial de Microsoft: si fue un token robado, un proceso de publicación automatizado o un ataque a la cadena de suministro por un lado anterior. La segunda es por qué el atacante mantuvo esa capacidad después de la primera cuarentena.

Lo que sí se sabe es que el problema no es un error de configuración del atacante, sino del modelo de confianza: la firma de un paquete oficial se acepta sin más preguntas, y el mecanismo de instalación ejecuta código antes de que nadie llegue a leer una línea del proyecto.

Qué hay que hacer ahora

Las recomendaciones de las firmas que analizaron el ataque coinciden en lo esencial, y conviene no improvisar:

  • Buscar en todas las máquinas, imágenes de CI y ficheros de bloqueo las versiones 1.26.1 y 1.26.2 del paquete, y eliminarlas.
  • Revisar la existencia de los ficheros agent_framework_meta.pth y af_runtime_diag.pth en el directorio site-packages, y de sus módulos asociados.
  • Fijar la versión 1.26.0 en las dependencias y verificar la instalación con comprobación de hash, para que una futura versión firmada no baste para colarse.
  • Tratar como comprometidos todos los secretos que fueran alcanzables desde ese entorno y rotarlos: principales de servicio de Azure, tokens personales de GitHub, npm, PyPI, NuGet, Docker, Hugging Face, OpenAI y credenciales de los agentes de Azure DevOps.
  • Revisar los registros de inicio de sesión y de actividad de Azure en busca de uso de identidades administradas y credenciales federadas desde agentes afectados.
  • Buscar la ruta del webhook en los registros de salida, para distinguir los intentos bloqueados de las transferencias completadas, y bloquear el tráfico saliente hacia ese dominio desde la infraestructura de integración continua.

Por qué este caso importa más de lo que parece

Un incidente de cadena de suministro en un framework de agentes de IA tiene una lectura más amplia que la del robo de credenciales concreto. Durante años se ha hablado de la dependencia de los modelos y de la concentración de la infraestructura; este caso recuerda que la capa de código que rodea a los agentes es una superficie nueva.

Tres consecuencias de fondo. La primera es que instalar una dependencia es ejecutar código: la firma de un paquete oficial no protege frente a un proyecto oficial ya comprometido, y un mecanismo de arranque como el fichero .pth amplía el alcance de lo que significa tener el paquete instalado. La segunda es que los agentes se despliegan en los sitios con más permisos, porque un agente necesita credenciales para hacer su trabajo; comprometer el entorno de un agente es una forma muy eficaz de convertir ese permiso en acceso. La tercera es que la reacción de la comunidad fue notable: entre la publicación de la primera versión maliciosa y su detección por los vigilantes del ecosistema de paquetes pasó poco tiempo, aunque el número de entornos afectados sigue siendo desconocido.

La lección práctica es incómoda pero simple: en un ecosistema donde el código se instala solo, la pregunta relevante ya no es si un paquete es malicioso, sino qué código se ejecuta sin que nadie lo haya pedido. Cada fichero .pth, cada script de postinstalación y cada proceso de automatización es una puerta trasera esperando a ser usada. En un mundo donde los agentes de IA construyen y ejecutan software por su cuenta, esa pregunta deja de ser un detalle de informática y pasa a ser una cuestión de seguridad nacional.

Fuentes