It’s long been known that npm scripts can be used for malicious purposes. Historically, when a developer publishes a package with a nasty lifecycle script npm quickly deletes the package to mitigate harm.
But what if a package had an
install script that scanned your computer for other node modules and added the same evil script to those modules? If you’re a maintainer of those modules, and you’re logged into npm, it could then publish the newly-infected module(s). These new versions would be installed by other developers who would unknowingly infect their own modules. To undo the damage, you’d have to determine which specific versions of packages are affected and purge only those versions. This would be difficult, if not impossible to do.
You can’t “undo” a worm
It’s a vulnerability I’ve been thinking about ever since I helped out with Bower last year and was given commit access to the project. I had only triaged a couple issues and written a dozen lines of code but because the project was in need of maintainers, I was suddenly in control of a project that’s installed by developers 100k times/day. If I was a jerk or evil corporate saboteur I could add malicious code to the project that would wreak havoc on developers’ systems. In this situation, the harmful code would be removed and I would be banned from the project.
But if the exploit was designed to self-replicate, you can’t just “undo” it.
npm worm proof of concept
To demonstrate how an npm worm would work, I created a quick proof-of-concept: pizza-party. I have not published the module to npm but if you were to
npm install pizza-party, the module’s install script would do the following:
- Scan its parent
node_modulesdirectory for other node modules
- Add the same install script to those modules
- Version those modules (bumping the patch version)
- Attempt to publish them to npm
- Opens this video in a browser
99.99% percent of the time the attempt to publish the module will fail because the user probably isn’t an owner of the module. But many npm authors manage hundreds of packages so you’d only have to infect a couple of those people to initiate a snowball of chaos.
The attack in the disclosure is even more nefarious. Rather than brute forcing the publishing of peer modules you can just list all packages owned by the current user, download them, add an
install script to them, and re-publish them.
Lazy semver habits allow the virus to spread
The propagation happens because most developers use loose range specifiers (
^) in their projects’
For example, gulp requires version
^1.0.0 of archy. When a user installs gulp (
npm install gulp) npm will check its registry for the latest version of archy that is greater than version 1.0.0 while still less than 2.0.0.If a malicious script successfully infects archy and bumps it to 1.0.1, anyone who installs gulp will be downloading the exploit. That same script would then try and infect other modules present on the user’s machine, attempting to create new versions (
npm version patch) and publish them to npm without the user knowing (
Protecting yourself from an npm worm
As mentioned in the formal CERT disclosure, the best way to protect yourself is to only be logged into npm when you’re actively managing your modules.
Locking your dependencies by using
npm shrinkwrap will also help, but so long as node modules can run arbitrary scripts, there’s a lot of scary stuff they can do.
Using other people’s code is inherently risky
The use of lifecycle scripts is not unique to npm and this exploit can be emulated in the package managers of other programming languages and frameworks. The reality is that npm, and to a greater extent, GitHub, have allowed the world of open source software to flourish by making it easy to create, distribute and assemble software. This is a good thing. But it doesn’t change the fact that there are inherent risks involved with blindly executing someone else’s code on your machine.
Even if a module doesn’t have any lifecycle scripts, it could still contain malicious code that does something horrible the second you
require() it. Admittedly, I often
npm install random-module-xxx without first viewing its source code. I should probably start auditing modules before installing them but let’s face it – ain’t nobody got time for that.
Until npm inc. finds ways to make npm users safer, we just have to trust that none of our peers are assholes. So if you’re a node developer and you’re reading this: Please, don’t be an asshole.