Tour del producto en 3 min Correo para incidentes urgentes
Blog de seguridad

Riesgos de seguridad en la instalación identificados en un incidente de la cadena de suministro de npm

Los casos públicos de Nx y Shai-Hulud ilustran qué riesgos revisar durante la instalación de paquetes.
El papel de las políticas para scripts de instalación, la revisión de dependencias y las pruebas en entornos aislados.

Riesgos de seguridad en la instalación identificados en un incidente de la cadena de suministro de npm

Nx, 26 de agosto de 2025

El token de publicación en npm de Nx se filtró por una inyección en un flujo de trabajo de GitHub Actions. Durante varias horas se publicaron versiones maliciosas. Las versiones de nx de la 20.9.0 a la 20.12.0 y de la 21.5.0 a la 21.8.0, además de varios paquetes @nx/* resultaron afectados. Las versiones maliciosas incluían un script postinstallejecutaba telemetry.jsen la instalación.

El análisis posterior señala que el script de instalación intentó eludir las comprobaciones de permisos de Claude Code, Gemini CLI y Amazon Q CLI cuando estaban instalados en el entorno de desarrollo. Investigue accesos anómalos a archivos de monederos, claves SSH, .env y otros datos sensibles del entorno de desarrollo. Investigue también si aparecieron repositorios públicos con nombres que empiezan por s1ngularity-repository. Los análisis difieren sobre si las herramientas de IA llegaron a ejecutar las acciones solicitadas. Nx informó de que la falta de una certificación de procedencia (provenance) de npm en las versiones maliciosas fue una señal de alerta.

Shai-Hulud, septiembre de 2025

Un mes después se detectó el gusano Shai-Hulud. En su alerta del 23 de septiembre, CISA informó de que más de 500 paquetes de npm se habían visto afectados. Los scripts de instalación infectados buscaban secretos del entorno de desarrollo. La exposición de las credenciales de publicación podía extender el incidente a otros paquetes. Revise el historial de instalaciones, los registros de publicación y los cambios anómalos en las cuentas de desarrollo y CI.

En ambos incidentes, los desarrolladores se limitaron a ejecutar npm installcomo de costumbre. Una revisión del código de la aplicación difícilmente habría detectado el problema.

Bloquear los scripts de instalación por defecto

La medida más eficaz es impedir por defecto que se ejecuten los scripts de instalación de las dependencias. Desde la versión 10.0, pnpm bloquea los scripts del ciclo de vida de las dependencias y permite indicar en onlyBuiltDependenciessolo los paquetes aprobados. En npm, puede deshabilitarlos mediante configuración.

npm config set ignore-scripts true
npm ci --ignore-scripts

onlyBuiltDependencies:
  - esbuild
  - sharp

Deshabilitar los scripts afecta a paquetes que necesitan compilarse durante la instalación, como algunos módulos nativos. Los primeros días puede ser necesario revisar qué paquetes fallan y preparar una lista de permitidos. El código malicioso dentro de la propia biblioteca podría permanecer inactivo durante la instalación y ejecutarse con requireal cargar la biblioteca por primera vez.

Probar las versiones nuevas en un entorno aislado

Pruebe los paquetes nuevos y aquellos que hayan cambiado de mantenedor en un entorno sin secretos. Un contenedor sin volúmenes montados es un punto de partida.

docker run --rm node:22 \
  sh -c "mkdir /tmp/t && cd /tmp/t && npm init -y >/dev/null && \
         npm install example-package@1.2.3 --foreground-scripts 2>&1" | tee install.log

Estas pruebas permiten observar qué comandos ejecutan los scripts de instalación y qué conexiones intentan abrir. El código que depende de una variable de CI concreta o de una fecha puede pasar inadvertido en un contenedor vacío.

Cuando Vulnerability Scanner detecta señales de riesgo como un cambio de mantenedor u ofuscación, Genox ejecuta la instalación en el entorno aislado de Behavioral Analyzer para observar el acceso a variables de entorno y el tráfico saliente. Usamos este análisis junto con el bloqueo de scripts de instalación.

Si ya instaló una versión afectada

Si instaló una versión afectada, aísle el equipo o ejecutor de CI y preserve los registros y el historial de cambios. Revoque o rote las credenciales de npm, GitHub y de servicios en la nube que pudieran haberse expuesto. Busque en la organización de GitHub repositorios con el nombre s1ngularity-repository o Shai-Hulud y compruebe si se creó el archivo .github/workflows/shai-hulud-workflow.yml en esa organización. En los entornos relacionados con Nx, revise el historial de cambios de ~/.bashrc y ~/.zshrc. Si confirma un cambio de configuración no autorizado, preserve la evidencia y restaure una configuración verificada.

Referencias

Hable con un experto
en seguridad de Genox.

Hable con nosotros